Configurações de admin: MCP (Protocolo de Contexto de Modelo)

A página MCP (Protocolo de Contexto de Modelo) na seção Plataforma do menu Administrador permite ativar e controlar o servidor MCP gerenciado pelo Looker. O servidor MCP gerenciado permite que clientes MCP, como agentes de IA e IDEs, se conectem com segurança à sua instância do Looker.

Funções exigidas

Para acessar a página do MCP (Protocolo de Contexto de Modelo), você precisa ter o papel de administrador do Looker.

Acessar a página do MCP (Protocolo de Contexto de Modelo)

A página MCP (Protocolo de Contexto de Modelo) está disponível para instâncias do Looker (original) e do Looker (Google Cloud Core) hospedadas pelo Looker. Ele não está disponível para instâncias do Looker (original) hospedadas pelo cliente.

Para acessar a página do Protocolo de Contexto de Modelo (MCP), siga estas etapas:

  1. No Menu principal, clique em Administrador para abrir o menu Administrador.
  2. Na seção Plataforma, selecione MCP.

Pré-requisitos para conectividade do cliente MCP

Para conectar clientes do MCP à sua instância do Looker e usar as ferramentas do MCP, um administrador do Looker precisa concluir a seguinte configuração:

  1. Configurar o acesso às ferramentas: ative as ferramentas necessárias na página MCP (Protocolo de Contexto de Modelo), conforme descrito na seção Configurações do MCP (Protocolo de Contexto de Modelo).
  2. Ativar clientes OAuth: ative ou registre seus aplicativos cliente do MCP (como Cursor, VS Code, Claude Code ou Cline) na página Gerenciar clientes OAuth. É possível ativar clientes MCP pré-configurados na guia Biblioteca de aplicativos ou registrar clientes personalizados na guia Clientes personalizados. Para instruções detalhadas, consulte a página de documentação Configurações de administrador: gerenciar clientes OAuth.

Configurações do MCP (Protocolo de Contexto de Modelo)

A página MCP (Protocolo de Contexto de Modelo) inclui várias configurações para ativar ou desativar as ferramentas do MCP disponíveis para clientes conectados. As ferramentas do MCP simplificam a capacidade do cliente de interagir com as instâncias do Looker. Para ver uma lista de todas as ferramentas possíveis, consulte a documentação Usar ferramentas de IA.

Ativar todas as ferramentas

Por padrão, todas as ferramentas estão desativadas. Ative a opção Ativar todas as ferramentas para ativar todas as ferramentas listadas na página e as novas que forem adicionadas. Desative a opção Ativar todas as ferramentas para escolher quais ferramentas ativar individualmente. Quando você muda a opção, a alteração é salva automaticamente.

Se você ativar a opção Ativar todas as ferramentas, o Looker vai lembrar o estado anterior das opções de cada ferramenta. Portanto, se você desativar a opção Ativar todas as ferramentas, o Looker vai reverter o status de cada ferramenta individual para o estado anterior.

Insira o nome de uma ferramenta, uma categoria ou um tipo de acesso no campo Pesquisar para filtrar as ferramentas na página.

Controle granular de ferramentas

Quando a opção Ativar todas as ferramentas está desativada, é possível ativar ou desativar ferramentas individuais na página MCP (Protocolo de Contexto de Modelo) para controlar quais ferramentas do MCP estão disponíveis para os clientes do MCP. Por padrão, todas as ferramentas estão desativadas.

As ferramentas são categorizadas em seções com base na função. Para cada ferramenta, o nível de acesso à instância do Looker (leitura ou gravação) também é mostrado. Mantenha o ponteiro sobre o ícone de informações ao lado do nome da ferramenta para ver uma descrição de cada uma.

Para ativar uma ferramenta, siga estas etapas:

  1. Localize a ferramenta na lista (por exemplo, looker_query, looker_update_project_file).
  2. Mude a chave para Ativado.

Quando você ativa ou desativa uma opção, a mudança é salva automaticamente.

Como prática recomendada de segurança, recomendamos ativar apenas as ferramentas necessárias para seus casos de uso específicos de IA.

Atualizações de clientes e ferramentas do MCP

Quando uma ferramenta é ativada ou desativada na página MCP (Protocolo de Contexto de Modelo), os clientes do MCP não atualizam automaticamente a lista de ferramentas. É necessário reconectar os clientes ao servidor MCP gerenciado pelo Looker para que eles possam acessar uma ferramenta recém-ativada. Se uma ferramenta for desativada, as chamadas de clientes para ela serão rejeitadas, mas você precisará reconectar os clientes ao servidor MCP para que a ferramenta não seja mais exposta a eles.

A seguir