# Governança de ferramentas MCP: quem pode chamar qual ferramenta, em um único plano de permissões

> AI gateway unifica servidores MCP atrás de um único endpoint /mcp: permitir/negar por ferramenta, filtros por rótulo, auditoria completa de chamadas / violações / sessões. Permissões de ferramentas de agentes compartilham um plano com as permissões de modelos; credenciais nunca saem do gateway.

Canônico: https://www.gatellm.io/pt-BR/use-cases/mcp-tool-governance/

Agregue servidores MCP externos atrás de um único endpoint /mcp no gateway — permitir/negar ferramentas por grupo de chaves e filtros por rótulo, com chamadas / violações / sessões totalmente auditadas.

## Do que a comunidade realmente reclama
Quando um framework de agentes é conectado a um monte de servidores MCP, as permissões saem do controle: não há controle unificado de quem pode chamar qual ferramenta, nem trilha de auditoria quando algo dá errado. Configurar cada agente separadamente espalha credenciais e faz as políticas derivarem.
"Como restringir o Claude Code a apenas estas ferramentas MCP" é uma pergunta recorrente para equipes de plataforma.

## Como o GateLLM faz isso
O GateLLM traz um proxy MCP integrado: vários servidores externos de ferramentas MCP (HTTP streamable / SSE) são agregados atrás de um único endpoint /mcp, com endpoint, cabeçalho de autenticação (repassado literalmente), rótulos, prioridade e carregamento preguiçoso configurados uma única vez. Os grupos de chaves governam as ferramentas com listas de permitir/negar (negar vence) e filtros por rótulo — o mesmo plano de ACL que governa os modelos.
Quando a lista de ferramentas fica longa, orçamentos de contexto a reduzem e a recuperação BM25 integrada localiza as ferramentas relevantes. Chamadas de ferramentas MCP, violações de regras de acesso e criação de sessões chegam ao log de auditoria.
As credenciais do servidor MCP nunca chegam ao agente: o acesso às ferramentas é concedido e revogado pelo grupo de chaves do gateway.

## 5 alavancas que realmente funcionam
- Agregação de servidores: servidores MCP HTTP streamable / SSE atrás de um único endpoint /mcp
- Carregamento preguiçoso: ferramentas descobertas no primeiro uso, reduzindo custo de inicialização e superfície de ataque
- ACL por ferramenta: permitir/negar por grupo de chaves, negar sobrepõe permitir, filtros por rótulo em massa
- Orçamento de contexto + BM25: listas longas de ferramentas reduzidas ao orçamento, ferramentas relevantes localizadas por busca
- Auditoria completa: chamadas de ferramentas / violações de acesso / criação de sessões registradas e exportáveis

## FAQ
### Permissões de ferramentas e permissões de modelos são o mesmo plano?
Sim. As abas "models" e "MCP" de um grupo de chaves formam uma única ACL: os modelos decidem quais modelos são chamáveis, o MCP decide quais ferramentas são utilizáveis (permitir/negar + filtros por rótulo). Anexe uma chave de acesso ao grupo e ambos entram em vigor ao mesmo tempo.

### As credenciais do servidor MCP são entregues ao agente?
Não. Os cabeçalhos de autenticação são configurados no gateway e repassados literalmente ao servidor MCP; o agente tem apenas uma chave de acesso do gateway e nunca vê as credenciais reais do servidor MCP. Revogar a chave do gateway corta o acesso às ferramentas.

- [Guia completo: Integrar servidores MCP externos (docs)](https://docs.gatellm.io/en/howto/onboard-external-mcp)

## Relacionados
- [Início](https://www.gatellm.io/pt-BR/index.md)
- [Preços](https://www.gatellm.io/pt-BR/pricing.md)
- [Calculadora de custos](https://www.gatellm.io/pt-BR/calculator.md)
- [Sobre](https://www.gatellm.io/pt-BR/about.md)
- [Agendar uma demonstração](https://www.gatellm.io/pt-BR/demo.md)
- [FAQ](https://www.gatellm.io/pt-BR/faq.md)
- [Comparar gateways de IA](https://www.gatellm.io/pt-BR/compare.md)
- [Comparar LiteLLM](https://www.gatellm.io/pt-BR/compare/litellm.md)
- [Comparar OpenRouter](https://www.gatellm.io/pt-BR/compare/openrouter.md)
- [Comparar Alibaba Cloud AI Gateway](https://www.gatellm.io/pt-BR/compare/alibaba-cloud.md)
- [Comparar Azure API Management](https://www.gatellm.io/pt-BR/compare/azure-apim.md)
- [Comparar Apigee](https://www.gatellm.io/pt-BR/compare/apigee.md)
- [Comparar Cloudflare AI Gateway](https://www.gatellm.io/pt-BR/compare/cloudflare.md)
- [Comparar Kong AI Gateway](https://www.gatellm.io/pt-BR/compare/kong.md)
- [Comparar Portkey](https://www.gatellm.io/pt-BR/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/pt-BR/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter](https://www.gatellm.io/pt-BR/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey](https://www.gatellm.io/pt-BR/compare/litellm-vs-portkey.md)
- [Casos de uso](https://www.gatellm.io/pt-BR/use-cases.md)
- [Reduzir custo de LLM](https://www.gatellm.io/pt-BR/use-cases/reduce-cost.md)
- [Alta disponibilidade](https://www.gatellm.io/pt-BR/use-cases/high-availability.md)
- [Isolamento multilocatário](https://www.gatellm.io/pt-BR/use-cases/multi-tenant.md)
- [Conformidade e auditoria](https://www.gatellm.io/pt-BR/use-cases/compliance-audit.md)
- [Solução de problemas por sintoma](https://www.gatellm.io/pt-BR/use-cases/troubleshooting.md)
- [Stack de modelos multivendor](https://www.gatellm.io/pt-BR/use-cases/mixed-model-stack.md)
- [IA auto-hospedada dentro do Office](https://www.gatellm.io/pt-BR/use-cases/self-hosted-office-ai.md)
- [Visibilidade e atribuição do uso de tokens](https://www.gatellm.io/pt-BR/use-cases/token-ops.md)
- [Token FinOps: alocação e controle de custos de IA](https://www.gatellm.io/pt-BR/use-cases/token-finops.md)
- [Busca na web para todos os modelos](https://www.gatellm.io/pt-BR/use-cases/web-search-grounding.md)
- [Rotação e standby de múltiplas chaves](https://www.gatellm.io/pt-BR/use-cases/multi-key-pooling.md)
- [Controle de admissão de clientes](https://www.gatellm.io/pt-BR/use-cases/client-admission-control.md)
- [Aplicar política de uso de modelos](https://www.gatellm.io/pt-BR/use-cases/enforce-model-policy.md)
- [Sem escolha de modelo no cliente](https://www.gatellm.io/pt-BR/use-cases/automatic-model-tiering.md)
- [Um protocolo, qualquer modelo](https://www.gatellm.io/pt-BR/use-cases/one-protocol-any-model.md)
- [Suplemento Office / Microsoft 365](https://www.gatellm.io/pt-BR/office-addin.md)
- [Glossário](https://www.gatellm.io/pt-BR/glossary.md)
- [Catálogo de modelos](https://www.gatellm.io/pt-BR/models.md)
- [Integrações de SDK e frameworks](https://www.gatellm.io/pt-BR/integrations.md)
- [Agentes de código de IA e harnesses](https://www.gatellm.io/pt-BR/coding-agents.md)
- [Segurança e conformidade](https://www.gatellm.io/pt-BR/security.md)
