Anthropic / mcp-builder
Quando construir um servidor MCP em vez de uma skill?
Quando o agente precisa fazer algo, não saber algo.
O que vale lembrar
- Desenho de ferramenta é o jogo inteiro. Ferramenta mal nomeada é ferramenta não usada.
- Poucas ferramentas bem delimitadas ganham de muitas sobrepostas.
- Mensagens de erro fazem parte da interface, porque o agente as lê e decide o próximo passo.
- Servidor concede capacidade, e capacidade precisa de fronteiras de autorização.
01O que muda na prática
A dificuldade em MCP não é o protocolo, é o desenho da interface. O agente escolhe ferramentas por nome e descrição, então uma ferramenta chamada processar que recebe um objeto de opções será mal usada o tempo todo.
Construir com orientação explícita mantém a superfície pequena e legível, que é a diferença entre um servidor que o agente usa certo e um que ele evita ou aplica errado.
02Onde decepciona
Ela não decide seu modelo de segurança. O que o agente pode ler, escrever e apagar é decisão sua e precisa ser imposta no servidor.
Detalhes de protocolo também mudam. Consulte a especificação atual em vez de assumir que o retrato da skill está em dia.
Instalação e primeira execução
- Instale a partir de anthropics/skills, sob Apache 2.0.
- Desenhe primeiro a superfície de ferramentas: poucas, com nomes claros e argumentos óbvios.
- Teste com o pedido realista mais vago, porque é ali que fronteiras ruins aparecem.
Perguntas que as pessoas realmente fazem
- Skill ou servidor MCP?
- Skill para procedimento e convenções. Servidor para capacidade, ou seja acesso a um sistema que o agente não alcança.
- Qual o erro de desenho mais comum?
- Ferramentas demais, sobrepostas e com nomes vagos, o que torna a seleção pouco confiável.
- Mensagens de erro importam?
- Sim. O agente as lê e escolhe o próximo passo, então trate como parte da interface.
Fontes
Versões legíveis por máquina desta página