# Quando construir um servidor MCP em vez de uma skill?

Canonical URL: https://bestskillsforclaude.com/pt-br/skills/mcp-builder
Language: pt-BR
Skill: mcp-builder
Publisher: Anthropic (https://github.com/anthropics)
Source: https://github.com/anthropics/skills/tree/main/skills/mcp-builder
License as stated by the publisher: Apache 2.0
Runtime: Claude apps and Claude Code
Category: Estender o Claude
Last reviewed: 2026-08-05

Quando o agente precisa fazer algo, não saber algo.

## Short answer
A skill mcp-builder ajuda a desenhar e implementar servidores do Model Context Protocol, que é como um agente ganha capacidades reais como consultar seu banco ou chamar sua API interna. Escolha um servidor quando o agente precisa agir sobre um sistema, e uma skill quando ele precisa seguir um procedimento.

Best for: Expor sistemas internos, APIs e fontes de dados a agentes de forma controlada.
Skip it if: O que você precisa é orientação de procedimento, que é uma skill e bem mais barata de manter.

## What to remember
- 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.

## O 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.

## Onde 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.

## Install and first run
1. Instale a partir de anthropics/skills, sob Apache 2.0.
2. Desenhe primeiro a superfície de ferramentas: poucas, com nomes claros e argumentos óbvios.
3. Teste com o pedido realista mais vago, porque é ali que fronteiras ruins aparecem.

## Questions
### 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.

## Sources
- anthropics/skills no GitHub: https://github.com/anthropics/skills
- anthropics/skills, pasta da skill mcp-builder: https://github.com/anthropics/skills/tree/main/skills/mcp-builder

## Other languages
- English: https://bestskillsforclaude.com/en/skills/mcp-builder
- Spanish: https://bestskillsforclaude.com/es/skills/mcp-builder
- Japanese: https://bestskillsforclaude.com/ja/skills/mcp-builder