Devs & IA
mcp-builderProgramação

Construir servidores MCP com ferramentas bem definidas

Guia oficial para integrar APIs e serviços externos a modelos por meio de servidores MCP em Python ou TypeScript.

Para: Devs de integrações e infraestrutura de IA

O que é

A mcp-builder trata a parte que decide se um servidor MCP será utilizável: desenho de ferramentas, contratos de entrada e saída, mensagens de erro e escolha correta entre recurso, prompt e tool.

Ela cobre implementações com FastMCP em Python e com o SDK MCP em Node/TypeScript. O foco é produzir uma interface que o modelo consiga entender e operar, não apenas expor endpoints existentes com outro nome.

Quando usar

  • Ao conectar um agente a uma API interna ou serviço SaaS
  • Quando as tools existentes recebem parâmetros ambíguos ou retornam dados difíceis de usar
  • Para estruturar autenticação, erros e paginação antes de publicar um conector
  • Ao revisar um servidor MCP que funciona tecnicamente, mas é acionado de forma errada

Quando não usar

  • Para uma integração simples que não será consumida por um cliente MCP
  • Quando a API de origem ainda não tem contrato estável
  • Como substituto de autorização, rate limiting e observabilidade de produção

O erro mais comum

Copiar cada endpoint da API para uma tool. O modelo precisa de ações orientadas a tarefa, não de um espelho da documentação HTTP. Agrupe os parâmetros que pertencem à mesma decisão e devolva apenas o contexto necessário para o próximo passo.

Instalação

$ /plugin marketplace add anthropics/skills$ /plugin install example-skills@anthropic-agent-skills

A instalação adiciona a coleção oficial. A ativação depende do pedido; o identificador acima não é tratado como comando de barra.

Conferir a pasta oficial ↗

Outras skills de Programação