Pular para o conteúdo principal
Última atualização em

Gerencie um MCP

Use o Unity Catalog e o Unity Gateway para compartilhar um MCP, escolher suas ferramentas e controlar o uso. Esses controles se aplicam a MCPs registrados e fornecidos pela Databricks.

Compartilhar um MCP​

Os chamadores precisam de EXECUTE no MCP, USE CATALOG e USE SCHEMA em seus pais e atribuição ao workspace. As ferramentas também podem exigir acesso a dados ou recursos subjacentes. Para compartilhar main.default.my_mcp com data-team, use uma identidade que possa gerenciar suas permissões:

  1. Abra o Unity Gateway , selecione MCPs e abra a tab Permissions do MCP.
  2. Clique em GRANT , selecione data-team e EXECUTE e clique em GRANT .
  3. No Catalog Explorer, conceda ao grupo USE CATALOG no catálogo pai e USE SCHEMA no esquema pai.

Os usuários finais não precisam de USE CONNECTION. Reserve-o para autores e administradores de MCP porque ele permite o uso direto da conexão fora da seleção de ferramentas e das políticas do MCP. Para automação, consulte Conceder acesso programaticamente.

Para conceder acesso a um MCP fornecido pelo Databricks, um administrador de metastore deve primeiro conceder a si mesmo MANAGE no esquema system.ai. Esses MCPs podem herdar uma concessão default de EXECUTE em system.ai. Para restrições, analise essas concessões amplas e siga Gerenciar modelos e MCPs com políticas GRANT.

Escolher ferramentas disponíveis​

Os MCPs registrados expõem todas as ferramentas de servidor por default. Durante o registro, em Tools :

  • Escolha Selecionar manualmente para selecionar ferramentas individuais.
  • Escolha Avançado para inserir nomes exatos ou prefixos como get_*.
  • Deixe Incluir automaticamente ferramentas adicionadas a este servidor no futuro desativado se as novas ferramentas precisarem ser revisadas primeiro.

Padrões de exclusão como !delete_* não são aceitos.

Ferramentas desmarcadas não aparecem em tools/list, e as chamadas para elas retornam Tool not allowed by MCP service configuration.

Para alterar a seleção de ferramentas posteriormente, atualize a configuração do MCP com config.include_tool_selectors. Uma lista vazia expõe todas as ferramentas.

Aplicar políticas​

info

Unity Gateway Beta

As políticas de MCP exigem o beta do Unity Gateway . Um administrador da account o ativa na página Previews do console da account. See Gerenciar account previews.

Uma política avalia a chamada de uma ferramenta antes de sua execução (ON CALL) e pode avaliar o resultado dela (ON RESULT). Ela pode permitir, bloquear ou exigir aprovação para uma chamada sem alterar a lista de ferramentas. Você precisa de MANAGE no MCP para anexar uma política. Consulte Criar e anexar uma política para conhecer todos os requisitos de configuração.

Bloquear dados confidenciais em chamadas e resultados de ferramentas​

Use a política integrada Sensitive Data Detection para bloquear chamadas que contenham informações pessoalmente identificáveis (PII):

  1. Abra o Unity Gateway , selecione MCPs e abra o MCP.
  2. Abra Políticas , clique em Nova política e insira um nome, como block_sensitive_data.
  3. Em Guardrail type , selecione Sensitive Data Detection .
  4. Under Classification tags , select the categories to block, such as class.us_ssn and class.credit_card. Select Block as the action.
  5. Em Fase , selecione Entrada e Saída para inspecionar os argumentos e os resultados da ferramenta.
  6. Defina o Rank e clique em Criar política .

A política se aplica a todos os usuários da account no MCP durante o Beta. Para o comportamento da categoria e mais opções, consulte Detectar dados confidenciais com uma política.

Restringir uma ferramenta para um agente específico​

Para um MCP registrado que expõe push_files, esta função personalizada nega essa ferramenta quando o agente atuante tem uma ID de cliente OAuth específica. Substitua <agent-oauth-client-id> pela ID de cliente do agente e main.governance por um esquema em que você possa criar funções:

SQL
CREATE OR REPLACE FUNCTION main.governance.block_agent_push(event VARIANT)
RETURNS VARIANT
LANGUAGE SQL
RETURN
  CASE
    WHEN event:type::string = 'request'
      AND event:context.tool.name::string = 'push_files'
      AND event:context.actor.context.is_on_behalf_of::boolean = true
      AND event:context.actor.context.client_id::string = '<agent-oauth-client-id>'
    THEN to_variant_object(named_struct('result', 'DENY', 'reason', 'This agent cannot call push_files.'))
    ELSE to_variant_object(named_struct('result', 'ALLOW', 'reason', ''))
  END;
  1. Execução o SQL em um editor SQL para criar a função.
  2. Abra a tab do MCP e clique em New policy .
  3. Digite um nome, selecione Personalizado em Tipo de barreira de segurança e selecione a função. Defina a Classificação e clique em Criar política .
  4. Chame push_files por meio desse agente para verificar a negação. Uma chamada por meio de um agente diferente deve continuar sendo permitida por esta política.

Este exemplo identifica o agente apenas para chamadas em nome de (on-behalf-of) que incluem seu ID do cliente OAuth. A ferramenta ainda aparece em tools/list. Para removê-la para todos os chamadores, use a seleção de ferramentas. Consulte a referência de função de política para os campos do ator e a configuração de política personalizada para privilégios de função. Para obter uma política de gravação do GitHub integrada, siga Governar o acesso ao GitHub MCP de um agente de codificação.

Imponha uma proteção de parceiro em chamadas de ferramentas​

Se você já usa um fornecedor de guardrail de terceiros que implementa a API de política externa do Databricks, anexe uma política de serviço externa ao MCP. O Databricks envia ao fornecedor o nome da ferramenta e os argumentos na fase de entrada e o resultado da ferramenta na fase de saída, e aplica o veredito ALLOW ou DENY do fornecedor.

  1. Abra a tab do MCP e clique em New policy .
  2. Digite um nome e selecione External em Guardrail type .
  3. Selecione uma conexão HTTP existente do Unity Catalog com o endpoint do fornecedor ou crie uma com as credenciais OAuth machine-to-machine do fornecedor.
  4. Em Phase , selecione Input , Output ou ambos. Defina a Rank e clique em Create policy .

Políticas de serviço externo falham fechadas: se o endpoint do fornecedor estiver inacessível ou lento, o Databricks nega a chamada. Para obter informações sobre os campos de conexão, o conteúdo enviado ao fornecedor e as diretrizes de saída de rede, consulte Aplicar um guardrail de parceiro com uma política de serviço externa.

Limitar o volume de chamadas​

Para limitar um MCP a 60 chamadas de ferramenta por minuto em todos os chamadores:

  1. Abra o MCP no Unity Gateway , em MCPs .
  2. Em Overview , localize Rate limits e clique em Set up ou Edit .
  3. Digite 60 no campo de QPM do serviço e clique em Save .

Os limites de taxa de MCP se aplicam a tools/call solicitações e usam queries por minuto (QPM). Chamadas acima do limite retornam HTTP 429. Consulte Rate limits para limites por usuário e de grupo.

Monitore o uso​

  • Usage: view o volume de chamadas, os erros e a latência no dashboard de uso ou faça uma query em system.ai_gateway.usage com service_type = 'MCP_SERVICE'.
  • Auditoria: analise as alterações e invocações do MCP (mcpCall) em system.access.audit. Consulte Logs de auditoria.
  • Rastreamentos: Inspecione solicitações de ferramentas, respostas e decisões de política na tabela de rastreamento unificada após um administrador ativá-la.

Exemplo: contagem de chamadas por ferramenta​

SQL
SELECT mcp_metadata.tool_name AS tool_name, COUNT(*) AS calls
FROM system.ai_gateway.usage
WHERE service_type = 'MCP_SERVICE'
  AND service_name = 'system.ai.github'
GROUP BY mcp_metadata.tool_name
ORDER BY calls DESC;

Para ter acesso às tabelas do sistema, consulte Monitor account activity with system tables.

Acesso à rede e a clientes​

Use regras de rede para controlar a conectividade e configurações do cliente OAuth para gerenciar o acesso do cliente.

Destinos externos​

Para regras de rede de saída e Endpoint privados, siga Workspace to external MCP server e Private connectivity.

Acesso do cliente​

Um administrador de account pode ativar ou desativar um cliente OAuth dedicado em Conexões de aplicativos nas configurações da account. Desativá-lo afeta esse cliente OAuth em toda a account. Os clientes configurados por meio da Unity Gateway CLI usam um login da CLI do Databricks em vez de um aplicativo OAuth dedicado.

Para restringir as chamadas de um agente específico, use o exemplo de política acima. Isso requer chamadas em nome de que contenham a ID de cliente OAuth do agente. Para restrições de IP de entrada, consulte Listas de acesso IP para Workspace.

Atualizar ou excluir um MCP​

Você precisa de propriedade ou MANAGE no MCP, além de USE CATALOG e USE SCHEMA em seus pais. Abra o MCP na página MCPs ou no Catalog Explorer:

  • Atualização: edite sua configuração e salve. O nome do MCP não pode ser alterado.
  • Excluir: abra o menu de três pontos e selecione Excluir . Os clientes que usam a URL dele não podem mais chamá-lo.

Para automação, consulte Atualizar um MCP ou Excluir um MCP.

Nesta página