OdisseIA100%0← todas as jornadas
Programação

🔌 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 MCPServer

mcp = 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
n
e clientCapabilities no metadata.

🔗 Links e instalação

Versões antigas usavam initialize. Se encontrar artigos de 2025 que mencionam handshake ou Mcp-Session-Id, desconsidere — o protocolo evoluiu.

Espalhe esta jornada WhatsApp Telegram X LinkedIn
⚓ Fonte original💬 Ver e comentar no Discord

Essa jornada nasceu na comunidade — entra que é grátis e tem gente remando junto.

Entrar no Discord da OdisseIA