Governança Empresarial — Registro, Roteamento e Observabilidade

Por que a Governança se Torna Necessária

Três Servidores MCP são gerenciáveis a partir da memória. Vinte requerem um sistema.

À medida que o número de Servidores MCP em uma empresa cresce, problemas previsíveis surgem:

• Um novo engenheiro constrói uma ferramenta Jira que já existe porque não há um diretório
• Um Agente chama a ferramenta search_jira (v1.x) obsoleta em vez da atual search_issues (v2.x)
• Uma chamada de ferramenta falha sem log — não está claro se o Servidor travou ou se os argumentos estavam errados
• Os custos de token disparam sem visibilidade sobre qual Servidor e qual ferramenta causou isso

O Registro resolve a descoberta. O Roteamento resolve o despacho. A Observabilidade resolve o diagnóstico.

Registro MCP

Um Registro é o diretório empresarial dos Servidores MCP: suas localizações, versões, capacidades e proprietários.

# mcp-registry.yaml
servers:
  - id: jira-tools
    name: Ferramentas Jira
    description: "Pesquisar, criar, e atualizar tickets Jira"
    version: "2.1.0"
    domain: engenharia
    owner: "@team-platform"
    status: ativo
    transport: stdio
    command: python
    args: ["/opt/mcp/jira/server.py"]
    capabilities:
      tools: [search_issues, create_issue, update_issue]
      resources: [jira://projects, jira://sprint/current]
    metrics:
      monthly_calls: 4521
      avg_latency_ms: 180
      error_rate: 0.2%

  - id: github-tools
    name: Ferramentas GitHub
    version: "1.5.0"
    domain: engenharia
    owner: "@team-platform"
    status: ativo
    transport: stdio
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    capabilities:
      tools: [create_pull_request, search_repositories, get_file_contents]

  - id: jira-tools-legacy
    name: Ferramentas Jira (Legado)
    version: "1.2.0"
    domain: engenharia
    status: obsoleto
    deprecation:
      reason: "Substituído por jira-tools v2.x; search_jira renomeado para search_issues"
      migration_guide: "Substitua search_jira por search_issues; estrutura dos argumentos inalterada"
      removal_date: "2026-10-01"
    capabilities:
      tools: [search_jira, create_jira_ticket]

O Registro resolve três coisas:

1. Descoberta: novos Agentes verificam o Registro para aprender o que está disponível — sem depender de conversas nos corredores
2. Sinalização de obsolescência: status obsoleto mais um migration_guide fornece ao código do Agente um caminho concreto de migração
3. Propriedade: cada Servidor tem um proprietário — quando algo quebra, você sabe quem contatar

Estratégias de Roteamento de Ferramentas

Quando um Agente precisa "pesquisar tickets Jira", como ele encontra o Servidor certo? Quatro estratégias:

Estratégia 1: Configuração Estática (mais simples)

Declare todos os Servidores diretamente nas configurações do Agente:

{
  "mcpServers": {