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

Nesta página, mostramos como conectar sua instância do Looker a várias ferramentas para desenvolvedores.

Para ter uma experiência mais eficiente e integrada, recomendamos usar a extensão dedicada do Looker para a CLI do Gemini. Use a camada semântica do Looker para fornecer à CLI do Gemini acesso seguro, controlado e sob demanda a dados confiáveis e acelere os fluxos de trabalho automatizando a criação de relatórios, visualizações e painéis com comandos de linguagem natural. Como a interface de linha de comando de próxima geração do Google Cloud, a CLI do Gemini é a ferramenta recomendada para interagir com suas instâncias do Looker pela linha de comando.

Você também pode conectar outros ambientes de desenvolvimento integrado (IDEs) e ferramentas para desenvolvedores que oferecem suporte ao Protocolo de Contexto de Modelo (MCP) usando a caixa de ferramentas do MCP para bancos de dados de uso geral. A MCP Toolbox é um servidor MCP de código aberto que simplifica a conexão de agentes de IA aos seus dados, lidando com complexidades como autenticação e pool de conexões. Isso permite interagir com seus dados usando linguagem natural diretamente do seu ambiente de desenvolvimento integrado (IDE, na sigla em inglês). Para essas ferramentas, esse método oferece recursos principais de interação com o banco de dados.

Sobre a CLI do Gemini e as extensões

A CLI do Gemini é um agente de IA de código aberto projetado para acelerar os fluxos de trabalho de desenvolvimento, ajudando na programação, depuração, análise de dados e criação de conteúdo. A missão dele é oferecer uma experiência elegante para interagir com serviços de nuvem de dados e bancos de dados de código aberto conhecidos.

Como as extensões funcionam

A CLI do Gemini é altamente extensível, permitindo a adição de novas ferramentas e recursos por extensões. Essas extensões são fáceis de instalar. É possível carregá-los de um URL do GitHub, um diretório local ou um registro configurável. Essas extensões oferecem um conjunto avançado de recursos, incluindo novas ferramentas, comandos de barra e comandos para simplificar seu fluxo de trabalho.

Configurar o Looker

1. 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.
2. 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

1. 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.14.0 ou mais recente 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
   
   

2. Torne o binário executável.

   chmod +x toolbox
   

3. Verifique a instalação.

   ./toolbox --version
   

Configurar o cliente MCP

Nesta seção, descrevemos como configurar várias ferramentas para desenvolvedores e se conectar à sua instância do Looker usando a MCP Toolbox for Databases. A caixa de ferramentas funciona como um servidor Protocolo de contexto de modelo (MCP) de código aberto que fica entre o IDE e o banco de dados, fornecendo um plano de controle seguro e eficiente para suas ferramentas de IA. Selecione a guia da sua ferramenta específica para conferir as instruções de configuração.

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

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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.