O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Servidor MCP gerenciado pelo Looker

O servidor MCP gerenciado pelo Looker é uma integração integrada que incorpora um servidor do Protocolo de Contexto de Modelo (MCP) diretamente na plataforma do Looker. Ele permite que agentes de IA, como a CLI do Gemini, o Claude Desktop, o Cursor e o Copilot, se conectem com segurança a uma instância do Looker e interajam com dados da empresa e modelos do LookML.

Ao hospedar o servidor, o Looker elimina a necessidade de implantar e manter sua própria infraestrutura de middleware, oferecendo um gateway plug-and-play, seguro e controlado para insights de negócios confiáveis.

Se você estiver usando uma instância hospedada pelo cliente ou preferir gerenciar sua própria infraestrutura, use o MCP Toolbox for Databases independente. O MCP Toolbox é um servidor MCP de código aberto que pode ser executado no seu computador local ou no seu próprio servidor para atuar como uma ponte entre os agentes de IA e sua instância do Looker. Consulte a página de documentação Usar o Looker com o MCP, a CLI do Gemini e outros agentes para mais informações.

Antes de começar

Para usar o servidor MCP gerenciado pelo Looker, você precisa atender aos seguintes requisitos:

Requisitos de instância

Você precisa usar uma instância do Looker (Google Cloud Core) ou do Looker (original).
A instância precisa ser hospedada pelo Looker.

Permissões necessárias

Para gerenciar o acesso à ferramenta: você precisa ter o papel de administrador do Looker.
Para registrar ou ativar seu agente de IA como um cliente OAuth: é necessário ter o papel de administrador do Looker.
Para conectar um agente de IA ao servidor MCP gerenciado pelo Looker: você precisa das suas credenciais de login padrão do Looker para autenticar durante o processo de conexão do OAuth. O agente de IA precisa ser registrado como um cliente OAuth por um administrador do Looker. Depois de conectado, o agente de IA vai herdar os papéis e o acesso do Looker do usuário que fez a autenticação.

Configurar o servidor MCP gerenciado

Configure o acesso à ferramenta para configurar o servidor MCP gerenciado.

Definir as configurações da ferramenta

Por padrão, todas as ferramentas estão desativadas para o servidor MCP gerenciado. Os administradores do Looker precisam ativar explicitamente as ferramentas que os agentes de IA podem usar. Consulte a página de documentação Configurações de administrador: Protocolo de Contexto de Modelo (MCP) para saber como ativar as ferramentas.

Definir as configurações de CORS

Se o cliente MCP estiver sendo executado diretamente em um navegador da Web e quiser se comunicar com o servidor MCP gerenciado pelo Looker usando CORS, o administrador do Looker precisará adicionar o domínio desse site cliente à Lista de permissões de domínios incorporados no painel Administrador.

Registrar um agente de IA pelo OAuth

Para conectar um agente de IA ao servidor MCP gerenciado pelo Looker, um administrador precisa ativar ou registrar o agente de IA como um aplicativo cliente OAuth na página Gerenciar clientes OAuth no painel Administrador do Looker.

É possível ativar clientes de IA pré-configurados na Biblioteca de aplicativos ou registrar um cliente personalizado na guia Clientes personalizados:

Biblioteca de aplicativos (recomendada): use registros de clientes OAuth pré-configurados e gerenciados pelo Looker para agentes de IA e ferramentas para desenvolvedores conhecidos, como Cursor, VS Code, Claude Code, Claude Desktop, ChatGPT, CLI do Gemini, Cline, Windsurf, Antigravity e a extensão do Looker para VS Code.
Clientes personalizados: registre um novo cliente OAuth personalizado se a ferramenta de IA não estiver disponível na biblioteca de aplicativos ou se você precisar configurar um URI ou uma porta de redirecionamento personalizado.

Opção 1: ativar um agente de IA pré-configurado na biblioteca de aplicativos

Recomendamos verificar primeiro a guia Biblioteca de aplicativos.

Para ativar um cliente de agente de IA pré-configurado, siga estas etapas:

No painel Administrador do Looker, acesse a seção Autenticação e selecione Gerenciar clientes OAuth.
Selecione a guia Biblioteca de aplicativos.
Localize o aplicativo cliente do seu agente de IA (por exemplo, Cursor, Claude Code, Cline ou CLI do Gemini). Use a barra de pesquisa para filtrar por nome.
Mude a chave Ativar para ATIVADO.
Copie o ID do cliente que aparece na linha do cliente. Você vai informar esse ID do cliente ao definir as configurações de MCP do seu agente de IA (por exemplo, em mcp.json ou flags de inicialização). Se os usuários do Looker que não têm a função de administrador do Looker precisarem usar esse cliente, distribua o ID do cliente para eles.

URIs de redirecionamento e processamento de porta dinâmica

O Looker exige que os URIs de redirecionamento do OAuth correspondam exatamente aos valores registrados e não aceita URIs de redirecionamento com caracteres curinga. Algumas ferramentas de IA usam portas locais dinâmicas ou temporárias por padrão ao iniciar um callback do OAuth (como Claude Code ou Cline). Para acomodar essas ferramentas, o Looker pré-registra uma porta padrão fixa para cada cliente de biblioteca (por exemplo, a porta 8080 para o Claude Code e o Cline ou a porta 7777 para a CLI do Gemini).

Para usar um cliente de biblioteca pré-configurado com portas dinâmicas, escolha uma das seguintes opções:

Configure o cliente para usar a porta estática pré-registrada: nas configurações ou no comando de inicialização da ferramenta, especifique a porta pré-registrada. Por exemplo:
- Claude Code: execute o Claude Code com a flag --callback-port 8080 (ou configure "callbackPort": 8080 em mcp.json).
- Cline: configure a porta de callback do OAuth como 8080.
- CLI do Gemini: defina a variável de ambiente export OAUTH_CALLBACK_PORT=7777.
- VS Code: use o URI estático pré-registrado http://127.0.0.1:33418/.
Registrar um cliente personalizado: se você precisar usar uma porta diferente ou um URL de callback personalizado, registre um cliente personalizado com o URI de redirecionamento de sua preferência, conforme descrito na próxima seção.

Opção 2: registrar um cliente de agente de IA personalizado

Se o agente de IA não estiver incluído na biblioteca de aplicativos ou se você precisar usar um URL ou uma porta de callback personalizada, siga as etapas na documentação de configurações de administrador - Gerenciar clientes OAuth para registrar um cliente personalizado. Depois de adicionar o cliente, copie o ID do cliente para usar ao configurar o cliente MCP.

Registro programático (APIs Explorer ou API)

Para implantações automatizadas (como pipelines de CI/CD ou scripts de provisionamento), os administradores do Looker podem registrar clientes OAuth de forma programática.

Abra esta seção para saber como registrar um cliente OAuth usando a API ou o APIs Explorer.

É possível registrar um agente de IA usando o endpoint de API oauth_client_apps diretamente com curl:

curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
-H "Authorization: token ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "redirect_uri": "REDIRECT_URI",
  "display_name": "CLIENT_NAME",
  "description": "OAuth client to access MCP server using CLIENT_NAME",
  "enabled": true
}'

Como alternativa, use o Explorador de APIs do Looker:

No método Auth, encontre o endpoint de API Register OAuth App.
Clique em Executar, insira CLIENT_GUID, redirect_uri, display_name e description, marque a caixa de seleção de confirmação e clique em Executar.
- CLI do Gemini
```
http://localhost:7777/oauth/callback
```
  Observação: algumas ferramentas, como a CLI do Gemini, podem exigir que você defina uma variável de ambiente (por exemplo, export OAUTH_CALLBACK_PORT=7777) para garantir que elas usem uma porta estática que corresponda ao URI de redirecionamento registrado.
- Gemini Code Assist
```
http://localhost:7777/oauth/callback
```
  Recomendamos usar a CLI do Gemini com o Gemini Code Assist. Nesse caso, eles vão compartilhar o mesmo servidor de callback local e a mesma configuração de porta.
- Gemini Enterprise
```
https://vertexaisearch.cloud.google.com/oauth-redirect
```
- Claude Code
  O Claude Code usa uma porta aleatória disponível para o callback do OAuth, mas você precisa corrigir isso usando a flag --callback-port 8080 (ou com a configuração callbackPort em mcp.json) para corresponder ao URI registrado.
```
http://localhost:8080/callback
```
- VS Code
  Para o VS Code, use o URI a seguir.
```
http://127.0.0.1:33418/
```
  Observação: a barra final (/) no final do URI é obrigatória.
- Apps hospedados na nuvem
  Para aplicativos hospedados na nuvem, ele pode ser um URL HTTPS seguro:
```
https://AI_AGENT_URL/oauth2callback
```
- Apps locais
  Para aplicativos em execução local, o URI de redirecionamento precisa ser um URL de localhost com uma porta estática:
```
http://localhost:7777/oauth/callback
```
  Observação: algumas ferramentas, como a CLI do Gemini, podem exigir que você defina uma variável de ambiente (por exemplo, export OAUTH_CALLBACK_PORT=7777) para garantir que as ferramentas usem uma porta estática que corresponda ao URI de redirecionamento registrado.
Para verificar o registro, execute o endpoint Get OAuth Client App com seu CLIENT_GUID.

Configurar o cliente MCP

Depois que o agente de IA for registrado, você poderá conectá-lo ao endpoint do MCP gerenciado como um cliente do MCP. Consulte a documentação do agente para concluir a configuração do cliente.

URL do servidor: LOOKER_INSTANCE_URL/mcp
Autenticação: OAuth 2.1

Exemplos de configurações (mcp.json)

Nesta seção, descrevemos como configurar várias ferramentas para desenvolvedores para se conectar à sua instância do Looker usando o servidor MCP gerenciado pelo Looker. O servidor MCP fica entre o ambiente de desenvolvimento integrado e o Looker, fornecendo um plano de controle seguro e eficiente para suas ferramentas de IA. Selecione a guia da sua ferramenta específica para ver as instruções de configuração.

CLI do Gemini

Configure a CLI do Gemini para se conectar diretamente ao servidor MCP gerenciado pelo Looker.

Instale a CLI do Gemini.
Adicione o servidor MCP remoto usando o comando a seguir, substituindo LOOKER_INSTANCE_URL pelo URL da sua instância do Looker:
```
gemini mcp add --transport http looker LOOKER_INSTANCE_URL/mcp
```
Como alternativa, é possível configurar isso manualmente adicionando a seguinte configuração ao arquivo settings.json (localizado em ~/.gemini/settings.json ou no diretório do projeto):
```
{
  "mcpServers": {
    "looker": {
      "httpUrl": "LOOKER_INSTANCE_URL/mcp",
      "oauth": {
        "clientId": "CLIENT_GUID"
      }
    }
  }
}
```
Inicie a CLI do Gemini no modo interativo:
```
gemini
```
Quando solicitado, a CLI inicia o fluxo de autorização do OAuth para autenticar com segurança sua instância do Looker.

Gemini Code Assist

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

Verifique se você instalou e configurou a CLI do Gemini e o servidor MCP gerenciado pelo Looker.
Configure o Gemini Code Assist para usar a CLI do Gemini.
Comece a interagir com sua instância do Looker usando linguagem natural diretamente no chat do Gemini Code Assist.

Gemini Enterprise

Configure o Gemini Enterprise para se conectar ao servidor MCP gerenciado pelo Looker como um repositório de dados de servidor MCP personalizado.

Siga a documentação oficial para criar um repositório de dados de servidor MCP personalizado no Gemini Enterprise.
Para a configuração do repositório de dados, use os valores a seguir, substituindo LOOKER_INSTANCE_URL pelo URL da instância do Looker e CLIENT_GUID pela string exata que você usou durante o registro do app OAuth:
```
{
  "instance_uri": "LOOKER_INSTANCE_URL/mcp",
  "auth_uri": "LOOKER_INSTANCE_URL/auth",
  "auth_uri_params": "&response_type=code&code_challenge_method=S256",
  "token_uri": "LOOKER_INSTANCE_URL/api/token",
  "client_id": "CLIENT_GUID",
  "client_secret": "none",
  "scopes": "cors_api",
  "pkce_support_enabled": "true"
}
```
O PKCE não exige uma chave secreta do cliente OAuth, mas o Gemini Enterprise exige um valor no campo client_secret. Insira none, conforme mostrado no exemplo de configuração.
Faça a autenticação pelo OAuth para continuar.

Defina a descrição do servidor MCP para ajudar o Gemini a entender quando invocá-lo. Exemplo:

Looker Agent with API access to various aspects of Looker. Primarily used to fetch data and run dashboards from Looker.

Defina as instruções do agente do servidor MCP. Exemplo:

Use this server exclusively to interact with the Looker instance for monitoring health, checking status, and retrieving data.
Invoke the Looker MCP server for the following request categories:
  - Instance Health Checks: Auditing connection status, uptime, performance metrics, or system errors.
  - Analytics Queries & Data Retrieval: Fetching live business metrics from Explores, Looks, or Dashboards.
Strict Constraints:
  - No Local Estimation: Do not guess. Always fetch real-time data via MCP tools.
  - Fallback Behavior: Inform the user of connectivity failures immediately.

Acesse a guia Ações no repositório de dados MCP personalizado que você acabou de criar e ative as ferramentas que você quer que o Gemini Enterprise use.
Observação: embora você também precise ativar as ferramentas nas configurações de administrador do Looker, essa etapa é necessária para que o Gemini Enterprise descubra e use as ferramentas do MCP.
Para finalizar a configuração, acesse o Gemini Enterprise, clique no ícone Conector e autorize o servidor MCP.

Claude Code

Instale o Claude Code.
Crie o arquivo .mcp.json na raiz do projeto, se ele não existir.
Adicione a configuração a seguir, substituindo LOOKER_INSTANCE_URL pelo URL da sua instância do Looker e CLIENT_GUID pelo GUID do cliente OAuth. Em seguida, salve.

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp",
            "oauth": {
              "clientId": "CLIENT_GUID",
              "callbackPort": 8080
            }
          }
        }
      }

Claude para computador

No Claude para computador, acesse Configurações e selecione Conectores.
Escolha Adicionar conector personalizado e insira um nome (por exemplo, Looker).
No URL, insira o URL da sua instância do Looker com o caminho /mcp anexado (por exemplo, https://looker.example.com/mcp).
Em Configurações avançadas, insira a string exata que você usou para o CLIENT_GUID durante o registro do app OAuth. Deixe a chave secreta do cliente OAuth em branco.
Selecione Adicionar para salvar o conector. Quando solicitado, o Claude para computador inicia com segurança o fluxo de autorização do PKCE pelo navegador.

Reinicie o Claude para computador.

Cline

Abra a extensão Cline no seu ambiente de desenvolvimento integrado e clique no ícone Servidores MCP.
Clique em Configurar servidores MCP para abrir o arquivo de configuração.
Adicione a configuração a seguir, substituindo LOOKER_INSTANCE_URL pelo URL do Looker, e salve.

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp"
          }
        }
      }

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 configuração a seguir, substituindo LOOKER_INSTANCE_URL pelo URL do Looker, e salve.

      {
        "mcpServers": {
          "looker": {
            "url": "LOOKER_INSTANCE_URL/mcp",
            auth: {
              "CLIENT_ID": "CLIENT_GUID"
            }
          }
        }
      }

Abra o Cursor e acesse Configurações > Configurações do Cursor > MCP. Um status ativo verde 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 configuração a seguir, substituindo LOOKER_INSTANCE_URL pelo URL da sua instância do Looker, e salve.

      {
        "servers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp"
          }
        }
      }

Windsurf

Abra o Windsurf e acesse o assistente Cascade.
Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.
Adicione a configuração a seguir, substituindo LOOKER_INSTANCE_URL pelo URL da sua instância do Looker, e salve.

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp"
          }
        }
      }

Autenticar com o cliente

Depois de configurar o cliente MCP com as configurações de mcp.json, na primeira vez que você tentar interagir com o Looker por esse cliente, ele vai iniciar o fluxo de autenticação do OAuth 2.1. Normalmente, isso envolve o cliente abrir uma janela do navegador em que você precisa fazer login na instância do Looker usando suas credenciais padrão e conceder ao aplicativo permissão para acessar o Looker em seu nome.

Esse processo de login é a etapa de autenticação interativa que permite que o cliente do MCP receba um token de acesso para fazer solicitações futuras.

Consulte a documentação do cliente para mais detalhes.

Depois de conectado, o cliente vai herdar suas funções e acesso ao conteúdo do Looker. O cliente também terá acesso às ferramentas de IA que o administrador do Looker ativou para o servidor MCP. Para ver uma lista de todas as ferramentas possíveis, consulte a documentação Usar ferramentas de IA.

Segurança e governança

O servidor MCP gerenciado foi projetado para herdar o framework de segurança e governança do Looker.

Limite de permissões: o servidor aplica permissões rigorosas no nível do usuário. Um agente de IA não pode acessar dados ou modelos que o usuário autenticado não tem permissão para ver.
VPC Service Controls: para instâncias do Looker (Google Cloud Core) que usam o VPC Service Controls, o endpoint gerenciado do MCP respeita os limites atuais do VPC Service Controls sem a necessidade de outras políticas ou configurações.
Chaves de criptografia gerenciadas pelo cliente (CMEK): para instâncias do Looker (Google Cloud Core) que usam CMEK, o servidor MCP gerenciado é compatível com CMEK sem a necessidade de outras políticas ou configurações.
Listas de permissões de IP: para instâncias que usam uma lista de permissões de IP no Looker (Google Cloud Core) ou no Looker (original), o endpoint do MCP gerenciado respeita as regras de lista de permissões de IP atuais sem exigir outras configurações.

Registro de auditoria

Todas as ações realizadas por um agente de IA são registradas na Atividade do sistema do Looker e nos Registros de auditoria do Cloud.

Atividade do sistema

A atividade do servidor MCP gerenciado pelo Looker é rastreada nas análises detalhadas Histórico e Atributo do evento. A página de documentação Como monitorar o uso do Looker com as Análises da Atividade do Sistema fornece os seguintes exemplos de consultas:

Registros de auditoria do Cloud

As instâncias do Looker (Google Cloud Core) também rastreiam a atividade do servidor MCP gerenciado pelo Looker usando os Registros de auditoria do Cloud. A página de documentação Geração de registros de auditoria do Looker (Google Cloud Core) fornece consultas de amostra.

Limitações

Escopos detalhados: os escopos do OAuth ainda não são compatíveis com o servidor MCP gerenciado. O controle de acesso depende da lista de permissões global de ferramentas e das permissões básicas do usuário.
Registro dinâmico: o registro dinâmico de clientes não é compatível com o pré-lançamento.
Atualização do cliente: as mudanças na lista de permissões de ferramentas não são enviadas automaticamente para os clientes conectados. Os usuários precisam esperar 30 segundos depois de fazer uma mudança na lista de ferramentas e, em seguida, reconectar o cliente para atualizar o manifesto da ferramenta. Consulte a documentação do cliente para saber como se reconectar ao servidor MCP.
Capacidade do servidor: durante a fase de pré-lançamento, o servidor MCP gerenciado é configurado com uma capacidade fixa para nos ajudar a coletar dados de performance. Durante períodos de pico de uso, podem ocorrer tempos limite ocasionais. Esse é o comportamento esperado.

Preços e cotas

O servidor MCP gerenciado pelo Looker está disponível sem custo financeiro adicional. No entanto, as chamadas de ferramentas feitas por agentes de IA consomem as cotas de API padrão administrativas e baseadas em consultas da instância. A alta atividade do agente pode afetar sua cota de API disponível.