🔌 Model Context Protocol (MCP): Conecte Agentes a Ferramentas Externas
📌 Pra que serve
MCP é o padrão aberto que Anthropic lançou em 2024 para conectar aplicações de IA (Claude Desktop, seu agente, IDEs) a servidores remotos que oferecem ferramentas, dados e prompts. Pense nele como um "adaptador universal": em vez de integrar cada ferramenta de forma diferente em cada app, você escreve um servidor MCP uma vez e qualquer host que implemente o protocolo consegue usá-lo. Ideal para agentes que precisam chamar APIs, acessar bancos de dados ou ler arquivos de forma segura.
🛠️ Passo a passo
1. Escolha o SDK para sua linguagem
- Python 3.10+: uv add "mcp[cli]"
- TypeScript/Node: npm install @modelcontextprotocol/server
- Também há suporte para Go, Rust, C#, Ruby e Java
2. Crie um servidor mínimo em Python
from mcp.server import MCPServermcp = MCPServer("ticket-lookup")
@mcp.tool()
async def get_ticket_status(ticket_id: str) -> str:
"""Get the status of a ticket.
Args: ticket_id: The ticket number, e.g., T-1042
"""
return f"Ticket {ticket_id}: status lookup"
if __name__ == "__main__":
mcp.run(transport="stdio")
3. Registre o servidor no seu host
- Em Claude Desktop: adicione entrada em mcpServers no config com comando e argumentos (caminhos absolutos)
- Em seu agente: execute o servidor como subprocess ou serviço HTTP
4. Teste com MCP Inspector
- Valide que tools/list retorna o schema correto antes de qualquer modelo usar
5. Deploy
- stdio: servidor local, lançado por subprocess (seu próprio computador)
- Streamable HTTP: servidor remoto, usa OAuth 2.1 se precisar autenticação
💡 Dica: Comece com operações read-only (consultas, lookups). Validar argumentos, rate-limit e avisar o usuário antes de operações destrutivas (delete, enviar, pagar) são obrigatórios. A especificação 2026-07-28 removeu o handshake initialize — cada request leva protocolVersio e
nclientCapabilities no metadata.
🔗 Links e instalação
- 📖 Documentação oficial: https://modelcontextprotocol.io
- 🏗️ Tutorial oficial: https://modelcontextprotocol.io/quickstart
- 🐍 Python SDK:
pip install mcpouuv add "mcp[cli]" - 📘 Especificação atual: 2026-07-28 (verificada em 18 de novembro de 2026)
- 🔗 Referência completa: https://agilefever.com/model-context-protocol-explained/
Versões antigas usavam initialize. Se encontrar artigos de 2025 que mencionam handshake ou Mcp-Session-Id, desconsidere — o protocolo evoluiu.