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 clientes MCP, como agentes de IA e IDEs (por exemplo, CLI do Gemini, Claude Desktop, Cursor e 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, fornecendo um gateway plug-and-play, seguro e governado 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 às ferramentas: você precisa ter o papel de administrador do Looker.
- Para registrar ou ativar seu agente de IA como um cliente OAuth: é preciso 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 do MCP estão desativadas para o servidor MCP gerenciado. Os administradores do Looker precisam ativar explicitamente as ferramentas do MCP que os clientes do MCP podem usar. Para saber como ativar as ferramentas, consulte a página de documentação Configurações de administrador: MCP (Protocolo de Contexto de Modelo).
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 cliente MCP pelo OAuth
Para conectar um cliente MCP ao servidor MCP gerenciado pelo Looker, um administrador precisa ativá-lo ou registrá-lo como um aplicativo cliente OAuth na página Gerenciar clientes OAuth no painel Administrador do Looker.
É possível ativar clientes MCP pré-configurados na guia 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 IDEs 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 o cliente MCP não estiver disponível na guia Biblioteca de aplicativos ou se você precisar configurar um URI de redirecionamento ou uma porta personalizada.
Opção 1: ativar um cliente MCP pré-configurado na biblioteca de aplicativos
Recomendamos verificar primeiro a guia Biblioteca de aplicativos.
Para ativar um cliente MCP pré-configurado, siga estas etapas:
- No painel de admin Administrador do Looker, acesse a seção Autenticação e selecione Gerenciar clientes OAuth.
- Selecione a guia Biblioteca de aplicativos.
- Localize o aplicativo cliente (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 precisar desse ID do cliente ao configurar as configurações do cliente MCP (por exemplo, em
mcp.jsonou flags de inicialização). Se os usuários do Looker que não têm o papel de administrador do Looker precisarem usar esse cliente, distribua o ID do cliente para eles.
URIs de redirecionamento e processamento de portas dinâmicas
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. Alguns clientes MCP usam portas locais dinâmicas ou temporárias por padrão ao iniciar um callback do OAuth (como Claude Code ou Cline). Para acomodar esses clientes, 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 do cliente, especifique a porta pré-registrada. Por exemplo:
- Claude Code: execute o Claude Code com a flag
--callback-port 8080(ou configure"callbackPort": 8080emmcp.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/.
- Claude Code: execute o Claude Code com a flag
- 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 MCP personalizado
Se o cliente MCP não estiver incluído na guia 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 cliente OAuth 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_nameedescription, marque a caixa de seleção de confirmação e clique em Executar.- CLI do Gemini
http://localhost:7777/oauth/callback
Observação: alguns clientes MCP, 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 os clientes 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
(ou com a configuração--callback-port 8080callbackPortemmcp.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
- CLI do Gemini
- Para verificar o registro, execute o endpoint Get OAuth Client App com seu
CLIENT_GUID.
Configurar o cliente MCP
Depois que o aplicativo for registrado como um cliente OAuth, você poderá conectá-lo ao endpoint do MCP gerenciado como um cliente MCP. Consulte a documentação do cliente para concluir a configuração.
- 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ários clientes MCP para se conectar à sua instância do Looker usando o servidor MCP gerenciado pelo Looker. O servidor MCP fica entre o cliente e o Looker, fornecendo um plano de controle seguro e governado para as ferramentas do MCP. Selecione a guia do seu cliente específico 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_URLpelo 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.jsonou no diretório do projeto):{ "mcpServers": { "looker": { "httpUrl": "LOOKER_INSTANCE_URL/mcp", "oauth": { "clientId": "CLIENT_GUID" } } } } - Inicie a CLI do Gemini no modo interativo:
Quando solicitado, a CLI inicia o fluxo de autorização do OAuth para autenticar com segurança sua instância do Looker.gemini
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.
- Configurar 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_URLpelo URL da instância do Looker eCLIENT_GUIDpela 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. Insiranone, 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 personalizado do MCP que você acabou de criar e ative as ferramentas que você quer que o Gemini Enterprise use.
- Finalize a configuração acessando o Gemini Enterprise, clicando no ícone Conector e autorizando o servidor MCP.
Claude Code
- Instale o Claude Code.
- Crie o arquivo
.mcp.jsonna raiz do projeto, se ele não existir. - Adicione a configuração a seguir, substituindo
LOOKER_INSTANCE_URLpelo URL da sua instância do Looker eCLIENT_GUIDpelo GUID do cliente OAuth, e 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
/mcpanexado (por exemplo,https://looker.example.com/mcp). - Em Configurações avançadas, insira a string exata que você usou para o
CLIENT_GUIDdurante 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 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_URLpelo URL do Looker, e salve.
{
"mcpServers": {
"looker": {
"type": "http",
"url": "LOOKER_INSTANCE_URL/mcp"
}
}
}
Cursor
- Crie o diretório
.cursorna 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_URLpelo 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
.vscodena 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_URLpelo 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_URLpelo 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 se conectar, o cliente herda seus papéis e acesso ao conteúdo do Looker. O cliente também tem acesso às ferramentas do MCP 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 MCP gerenciado 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 de Histórico e Atributo de evento. A página de documentação Monitorar o uso do Looker com as Análises da Atividade do Sistema fornece os seguintes exemplos de consultas:
- Quais chamadas de API foram iniciadas pelo servidor MCP gerenciado pelo Looker?
- Quais eventos estão relacionados a uma solicitação do servidor MCP gerenciado pelo Looker?
- Quais atualizações foram feitas nas configurações da ferramenta do servidor MCP gerenciado pelo Looker pelos administradores do Looker?
- Quais consultas foram executadas pelos usuários do servidor MCP gerenciado pelo Looker?
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 Registros de auditoria do Looker (Google Cloud Core) fornece exemplos de consultas.
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: não há suporte para o registro dinâmico de clientes.
- 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 ferramenta do MCP feitas por clientes conectados consomem as cotas de API padrão administrativas e baseadas em consulta da instância. Uma atividade intensa do cliente pode reduzir sua cota de API disponível.