Associe o seu IDE ao Looker através da MCP Toolbox

Esta página mostra como usar a caixa de ferramentas do MCP para bases de dados para associar a sua instância do Looker a ambientes de desenvolvimento integrados (IDEs) e ferramentas para programadores que suportam o protocolo Model Context Protocol (MCP). Use estas ferramentas para executar consultas e interagir com o Looker. Este guia destina-se a programadores que usam os respetivos IDEs e ferramentas para programadores existentes para trabalhar com o Looker.

O MCP é um protocolo aberto para associar grandes modelos de linguagem (GMLs) a origens de dados, como o Looker. Esta página descreve como usar a MCP Toolbox for Databases para expor as suas ferramentas de assistência para programadores a uma instância do Looker através dos seguintes IDEs:

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

Configurar o Looker

Obtenha um ID de cliente e um segredo do cliente do Looker. Siga as instruções na página de documentação Autenticação da API Looker.
Ter o URL de base da sua instância do Looker disponível. É provável que seja algo como https://looker.example.com. Em alguns casos, a API está a ouvir numa porta diferente e tem de usar https://looker.example.com:19999.

Instale a caixa de ferramentas do MCP

Transfira a versão mais recente da MCP Toolbox como um ficheiro binário. Selecione o binário que corresponde à arquitetura do seu SO e CPU. Tem de usar a versão V0.10.0 ou posterior 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

Tornar o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Configure o cliente do MCP

CLI do Gemini

Instale a CLI do Gemini.
No seu diretório de trabalho, crie uma pasta denominada .gemini. Dentro dessa pasta, crie um ficheiro settings.json.
Adicione a seguinte configuração, substituindo as seguintes variáveis de ambiente pelos seus valores e, de seguida, guarde.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave da API usada para aceder à API Looker.
- VERIFY_SSL: true ou false, consoante use a encriptação SSL para ligar a base 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 ficheiro .mcp.json na raiz do projeto, se não existir.
Adicione a seguinte configuração, substituindo as seguintes variáveis de ambiente pelos seus valores e, de seguida, guarde.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave da API usada para aceder à API Looker.
- VERIFY_SSL: true ou false, consoante use a encriptação SSL para ligar a base 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 Desktop e navegue para Definições.
No separador Programador, clique em Editar configuração para abrir o ficheiro de configuração.
Adicione a seguinte configuração, substituindo as seguintes variáveis de ambiente pelos seus valores e, de seguida, guarde.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave da API usada para aceder à API Looker.
- VERIFY_SSL: true ou false, consoante use a encriptação SSL para ligar a base 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.
O novo ecrã de chat apresenta 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 ficheiro de configuração.
Adicione a seguinte configuração, substituindo as seguintes variáveis de ambiente pelos seus valores e, de seguida, guarde.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave da API usada para aceder à API Looker.
- VERIFY_SSL: true ou false, consoante use a encriptação SSL para ligar a base 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",
     }
    }
  }
}

É apresentado um estado ativo verde depois de o servidor se ligar com êxito.

Cursor

Crie o diretório .cursor na raiz do projeto, se não existir.
Crie o ficheiro .cursor/mcp.json, se não existir, e abra-o.
Adicione a seguinte configuração, substituindo as seguintes variáveis de ambiente pelos seus valores e, de seguida, guarde.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave da API usada para aceder à API Looker.
- VERIFY_SSL: true ou false, consoante use a encriptação SSL para ligar a base 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 o Cursor e navegue para Definições > Definições do cursor > MCP. É apresentado um estado ativo verde quando o servidor se liga.

Visual Studio Code (Copilot)

Abra o VS Code e crie o diretório .vscode na raiz do projeto, se não existir.
Crie o ficheiro .vscode/mcp.json, se não existir, e abra-o.
Adicione a seguinte configuração, substituindo as seguintes variáveis de ambiente pelos seus valores e, de seguida, guarde.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave da API usada para aceder à API Looker.
- VERIFY_SSL: true ou false, consoante use a encriptação SSL para ligar a base 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 para o assistente Cascade.
Clique no ícone do MCP e, de seguida, em Configurar para abrir o ficheiro de configuração.
Adicione a seguinte configuração, substituindo as seguintes variáveis de ambiente pelos seus valores e, de seguida, guarde.
- LOOKER_URL: o URL da sua instância do Looker.
- CLIENT_ID e CLIENT_SECRET: a chave da API usada para aceder à API Looker.
- VERIFY_SSL: true ou false, consoante use a encriptação SSL para ligar a base 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",
     }
    }
  }
}

Use ferramentas de IA

A sua ferramenta de IA está agora associada ao Looker através do MCP. Experimente pedir ao seu assistente de IA para listar modelos, explorações, dimensões e medidas. Também pode executar uma consulta ao obter o SQL de uma consulta ou executar um Look guardado.

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

get_models: liste todos os modelos LookML na sua instância do Looker.
get_explores: liste as explorações num determinado modelo.
get_dimensions: liste as dimensões numa determinada exploração.
get_measures: liste as métricas numa determinada análise detalhada.
get_filters: liste os filtros numa determinada análise detalhada.
get_parameters: liste os parâmetros numa determinada exploração.
query: executar uma consulta e devolver os dados.
query_sql: devolve o SQL gerado pelo Looker para uma consulta.
query_url: devolve um link para a consulta no Looker para exploração adicional.
get_looks: devolve os visuais guardados que correspondem a um título ou uma descrição.
run_look: execute uma análise detalhada guardada e devolva os dados.
make_look: crie uma análise guardada no Looker e devolva o URL.
get_dashboards: devolve os painéis de controlo guardados que correspondem a um título ou uma descrição.
make_dashboard: crie um painel de controlo guardado no Looker e devolva o URL.
add_dashboard_element: adicione um mosaico a um painel de controlo.