Esta página foi traduzida pela API Cloud Translation.

Use o Looker com o MCP, a CLI do Gemini e outros agentes

Esta página mostra-lhe como associar a sua instância do Looker a várias ferramentas para programadores.

Para a experiência mais poderosa e integrada, recomendamos que use a extensão dedicada do Looker para a CLI do Gemini. Use a camada semântica do Looker para fornecer à CLI Gemini acesso seguro, regido e a pedido a dados fidedignos, e acelere os fluxos de trabalho automatizando a criação de relatórios, visualizações e painéis de controlo a partir de comandos de linguagem natural. Como interface de linhas de comando de próxima geração do Google Cloud, a CLI Gemini é a ferramenta recomendada para interagir com as suas instâncias do Looker a partir da linha de comandos.

Também pode ligar outros ambientes de programação integrados (IDEs) e ferramentas para programadores que suportam o protocolo Model Context Protocol (MCP) através da caixa de ferramentas MCP para bases de dados de uso geral. A caixa de ferramentas do MCP é um servidor MCP de código aberto que simplifica a associação de agentes de IA aos seus dados ao processar complexidades como a autenticação e a partilha de ligações, o que lhe permite interagir com os seus dados através da linguagem natural diretamente a partir do IDE. Para estas ferramentas, este método oferece capacidades de interação com a base de dados essenciais.

Acerca da CLI do Gemini e das extensões

A CLI Gemini é um agente de IA de código aberto concebido para acelerar os fluxos de trabalho de desenvolvimento, ajudando na programação, na depuração, na exploração de dados e na criação de conteúdo. A sua missão é oferecer uma experiência elegante de agente para interagir com serviços de dados na nuvem e bases de dados de código aberto populares.

Como funcionam as extensões

A CLI Gemini é altamente extensível, o que permite a adição de novas ferramentas e capacidades através de extensões. Estas extensões são fáceis de instalar. Pode carregá-los a partir de um URL do GitHub, de um diretório local ou de um registo configurável. Estas extensões oferecem um conjunto avançado de capacidades, incluindo novas ferramentas, comandos com barra e comandos para simplificar o seu fluxo de trabalho.

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.14.0 ou posterior da caixa de ferramentas do MCP.

linux/amd64

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

darwin/arm64

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

darwin/amd64

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

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.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

Esta secção descreve como configurar várias ferramentas para programadores para se ligarem à sua instância do Looker através da caixa de ferramentas do MCP para bases de dados. O conjunto de ferramentas funciona como um servidor de protocolo Model Context Protocol (MCP) de código aberto que se encontra entre o seu IDE e a sua base de dados, oferecendo um plano de controlo seguro e eficiente para as suas ferramentas de IA. Selecione o separador da sua ferramenta específica para ver as instruções de configuração.

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

CLI do Gemini

Instale a CLI do Gemini.
Instale a extensão do Looker para a Gemini CLI a partir do repositório do GitHub através do seguinte comando:
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
Defina variáveis de ambiente para estabelecer ligação à sua instância do Looker, substituindo as seguintes variáveis de ambiente pelos seus valores:
- 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.
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
Inicie a CLI do Gemini no modo interativo:
```
gemini
```
A CLI carrega automaticamente a extensão do Looker para a extensão da CLI do Gemini e as respetivas ferramentas, que pode usar para interagir com a sua instância do Looker.

Gemini Code Assist

Recomendamos que configure o Gemini Code Assist para usar a CLI do Gemini. Esta abordagem elimina a necessidade de configurar manualmente um servidor MCP.

Certifique-se de que instalou e configurou a CLI do Gemini e a extensão looker.
Configure o Gemini Code Assist para usar a CLI do Gemini.
Comece a interagir com a sua instância do Looker através de linguagem natural diretamente no chat do Gemini Code Assist.

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.