Conectar seu ambiente de desenvolvimento integrado ao Looker usando a caixa de ferramentas do MCP

Nesta página, mostramos como usar a MCP Toolbox para bancos de dados e conectar sua instância do Looker a ambientes de desenvolvimento integrado (IDEs) e ferramentas para desenvolvedores que oferecem suporte ao Protocolo de contexto de modelo (MCP). Use essas ferramentas para executar consultas e interagir com o Looker. Este guia é destinado a desenvolvedores que usam os IDEs e as ferramentas de desenvolvimento atuais para trabalhar com o Looker.

O MCP é um protocolo aberto para conectar modelos de linguagem grande (LLMs) a fontes de dados como o Looker. Nesta página, descrevemos como usar a MCP Toolbox for Databases para expor suas ferramentas de assistência ao desenvolvedor a uma instância do Looker usando os seguintes IDEs:

CLI do Gemini
Cursor
Windsurf (Codium)
Visual Studio Code (Copilot)
Cline (extensão do VS Code)
Claude para computador
Código do Claude

Configurar o Looker

Receba um ID e uma chave secreta do cliente do Looker. Siga as instruções na página de documentação Autenticação da API Looker.
Tenha o URL de base da sua instância do Looker disponível. Provavelmente é algo como https://looker.example.com. Em alguns casos, a API detecta uma porta diferente, e você precisa usar https://looker.example.com:19999.

Instalar a caixa de ferramentas do MCP

Faça o download da versão mais recente da MCP Toolbox como um binário. Selecione o binário que corresponde à arquitetura do SO e da CPU. Use a versão V0.10.0 ou mais recente da caixa de ferramentas do MCP.

linux/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/windows/amd64/toolbox.exe

Torne o binário executável.
```
chmod +x toolbox
```
Verifique a instalação.
```
./toolbox --version
```

Configurar o cliente MCP

CLI do Gemini

Instale a CLI do Gemini.
No diretório de trabalho, crie uma pasta chamada .gemini. Dentro dessa pasta, crie um arquivo settings.json.
Adicione a seguinte configuração, substituindo as variáveis de ambiente pelos seus valores e salve.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave de API usada para acessar a API do Looker.
- VERIFY_SSL: true ou false, dependendo se você usa criptografia SSL para conectar seu banco de dados à instância do Looker.

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Código do Claude

Instale o Claude Code.
Crie o arquivo .mcp.json na raiz do projeto, se ele não existir.
Adicione a seguinte configuração, substituindo as variáveis de ambiente pelos seus valores e salve.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave de API usada para acessar a API do Looker.
- VERIFY_SSL: true ou false, dependendo se você usa criptografia SSL para conectar seu banco de dados à instância do Looker.

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Claude para computador

Abra o Claude para computador e acesse Configurações.
Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.
Adicione a seguinte configuração, substituindo as variáveis de ambiente pelos seus valores e salve.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave de API usada para acessar a API do Looker.
- VERIFY_SSL: true ou false, dependendo se você usa criptografia SSL para conectar seu banco de dados à instância do Looker.

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Reinicie o Claude Desktop.
A nova tela de chat mostra um ícone de martelo (MCP) com o novo servidor MCP.

Cline

Abra a extensão Cline no VS Code e clique no ícone Servidores MCP.
Clique em Configurar servidores MCP para abrir o arquivo de configuração.
Adicione a seguinte configuração, substituindo as variáveis de ambiente pelos seus valores e salve.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave de API usada para acessar a API do Looker.
- VERIFY_SSL: true ou false, dependendo se você usa criptografia SSL para conectar seu banco de dados à instância do Looker.

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Um status ativo verde aparece depois que o servidor se conecta.

Cursor

Crie o diretório .cursor na raiz do projeto, se ele não existir.
Crie o arquivo .cursor/mcp.json, se ele não existir, e abra-o.
Adicione a seguinte configuração, substituindo as variáveis de ambiente pelos seus valores e salve.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave de API usada para acessar a API do Looker.
- VERIFY_SSL: true ou false, dependendo se você usa criptografia SSL para conectar seu banco de dados à instância do Looker.

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Abra Cursor e navegue até Configurações > Configurações do cursor > MCP. Um status verde ativo aparece quando o servidor se conecta.

Visual Studio Code (Copilot)

Abra o VS Code e crie o diretório .vscode na raiz do projeto, se ele não existir.
Crie o arquivo .vscode/mcp.json, se ele não existir, e abra-o.
Adicione a seguinte configuração, substituindo as variáveis de ambiente pelos seus valores e salve.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave de API usada para acessar a API do Looker.
- VERIFY_SSL: true ou false, dependendo se você usa criptografia SSL para conectar seu banco de dados à instância do Looker.

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Windsurf

Abra o Windsurf e navegue até o assistente do Cascade.
Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.
Adicione a seguinte configuração, substituindo as variáveis de ambiente pelos seus valores e salve.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave de API usada para acessar a API do Looker.
- VERIFY_SSL: true ou false, dependendo se você usa criptografia SSL para conectar seu banco de dados à instância do Looker.

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Usar ferramentas de IA

Sua ferramenta de IA agora está conectada ao Looker usando o MCP. Peça ao seu assistente de IA para listar modelos, análises detalhadas, dimensões e medidas. Você também pode executar uma consulta recuperando o SQL de uma consulta ou executando um Look salvo.

As seguintes ferramentas estão disponíveis para o LLM:

get_models: liste todos os modelos do LookML na sua instância do Looker.
get_explores: lista as análises detalhadas em um determinado modelo.
get_dimensions: lista as dimensões em uma análise específica.
get_measures: lista as medidas em uma análise específica.
get_filters: lista os filtros em uma análise detalhada.
get_parameters: lista os parâmetros em uma análise detalhada específica.
query: execute uma consulta e retorne os dados.
query_sql: retorna o SQL gerado pelo Looker para uma consulta.
query_url: retorna um link para a consulta no Looker para mais análises.
get_looks: retorna os Looks salvos que correspondem a um título ou descrição.
run_look: executa uma análise salva e retorna os dados.
make_look: crie um Look salvo no Looker e retorne o URL.
get_dashboards: retorna os painéis salvos que correspondem a um título ou descrição.
make_dashboard: crie um painel salvo no Looker e retorne o URL.
add_dashboard_element: adicione um bloco a um painel.