Curso de Protocolo MCP: Criação de Integrações de Ferramentas para Agentes

Anatomia do Protocolo

• Por que apenas o function calling é insuficiente para ecossistemas de agentes complexos
• Primitivos MCP: ferramentas, recursos, prompts e os seus esquemas JSON
• Ciclo de vida de uma sessão MCP: inicializar, listar ferramentas, invocar, retornar, terminar
• Comparação entre MCP, OpenAPI e GraphQL para expor capacidades aos agentes

Construção de um Servidor MCP via Stdio

• Configuração inicial de um servidor MCP em TypeScript com o SDK oficial
• Definição de esquemas de ferramentas com Zod e geração de validação em tempo de execução
• Implementação de handlers de ferramentas que invocam APIs REST internas ou bases de dados
• Gestão de erros, resultados parciais e execução prolongada de ferramentas

Construção de um Servidor MCP via HTTP

• Migração de stdio para HTTP para deployment remoto e balanceamento de carga
• Implementação de autenticação utilizando bearer tokens e mTLS
• Degração gradual quando as conexões HTTP falham a meio da sessão
• Deployment de servidores MCP via HTTP atrás de Kong ou nginx com limitação de taxa

Padrões de Integração do Cliente

• Registo de um servidor MCP no Claude Code através do ficheiro de configuração
• Ligação do OpenClaude a múltiplos endpoints MCP simultaneamente
• Escrita de um cliente de agente personalizado em Python utilizando o SDK MCP em Python
• Gestão graciosa de alterações na disponibilidade de ferramentas em tempo de execução

Exposição de Recursos e Prompts

• Exposição de recursos apenas para leitura para enriquecimento do contexto do agente
• Criação de templates de prompts parametrizados que guiam o raciocínio do agente
• Atualização dinâmica de recursos quando os dados subjacentes mudam
• Separação de ferramentas mutáveis de recursos imutáveis para clareza de segurança

Repositório e Descoberta Internos de Ferramentas

• Construção de um repositório MCP corporativo com metadados e tags de propriedade
• Descoberta automática via DNS-SD ou ficheiros de endpoints conhecidos
• Versionamento de ferramentas e depreciação de endpoints antigos sem quebrar os clientes
• Catalogação de ferramentas com descrições em linguagem natural para pesquisabilidade por agentes

Fronteiras de Segurança Empresarial

• Implementação de verificações de autorização dentro dos handlers de ferramentas com base na identidade do agente
• Utilização de segmentação de rede para isolar ferramentas de alto risco do acesso geral dos agentes
• Sandbox de execução de ferramentas com seccomp e contentores gVisor
• Registo de cada invocação de ferramenta para conformidade e análise forense

Engenharia de Desempenho e Fiabilidade

• Definição de políticas de timeout por família de ferramentas: base de dados, computação e APIs externas
• Implementação de circuit breakers quando os serviços a jusante estão instáveis
• Cache de resultados de ferramentas para reduzir cálculos redundantes e dispendiosos
• Execução de servidores MCP como sidecars versus microsserviços independentes

Interoperabilidade entre Plataformas de Agentes

• Teste de compatibilidade de servidores MCP com clientes como Claude Code e Continue.dev
• Gestão das diferenças de negociação de transporte entre plataformas
• Escrita de adaptadores polyfill para frameworks de agentes não MCP
• Construção de um marketplace de ferramentas interplataformas dentro da organização

Evolução do Ecossistema MCP Internamente

• Recolha de feedback dos developers sobre a utilidade e precisão das ferramentas
• Realização de auditorias trimestrais de ferramentas e remoção de integrações obsoletas
• Incorporação de novas equipas com templates de servidor MCP de auto-serviço
• Contribuição de melhorias para a especificação MCP de código aberto