{
  "id": "mcp-builder",
  "handle": "mcp-builder",
  "canonicalUrl": "https://bestskillsforclaude.com/pt-br/skills/mcp-builder",
  "language": "pt-BR",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/mcp-builder",
    "es": "https://bestskillsforclaude.com/es/skills/mcp-builder",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/mcp-builder",
    "ja": "https://bestskillsforclaude.com/ja/skills/mcp-builder"
  },
  "category": {
    "id": "extend-claude",
    "name": "Estender o Claude"
  },
  "publisher": {
    "name": "Anthropic",
    "url": "https://github.com/anthropics"
  },
  "source": "https://github.com/anthropics/skills/tree/main/skills/mcp-builder",
  "documentation": null,
  "licenseAsStated": "Apache 2.0",
  "runtime": "Claude apps and Claude Code",
  "lastReviewed": "2026-08-05",
  "headline": "Quando construir um servidor MCP em vez de uma skill?",
  "summary": "Quando o agente precisa fazer algo, não saber algo.",
  "verdict": "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.",
  "bestFor": "Expor sistemas internos, APIs e fontes de dados a agentes de forma controlada.",
  "skipIf": "O que você precisa é orientação de procedimento, que é uma skill e bem mais barata de manter.",
  "keyTakeaways": [
    "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."
  ],
  "quickStart": [
    "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."
  ],
  "sections": [
    {
      "heading": "O que muda na prática",
      "paragraphs": [
        "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."
      ]
    },
    {
      "heading": "Onde decepciona",
      "paragraphs": [
        "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."
      ]
    }
  ],
  "faq": [
    {
      "question": "Skill ou servidor MCP?",
      "answer": "Skill para procedimento e convenções. Servidor para capacidade, ou seja acesso a um sistema que o agente não alcança."
    },
    {
      "question": "Qual o erro de desenho mais comum?",
      "answer": "Ferramentas demais, sobrepostas e com nomes vagos, o que torna a seleção pouco confiável."
    },
    {
      "question": "Mensagens de erro importam?",
      "answer": "Sim. O agente as lê e escolhe o próximo passo, então trate como parte da interface."
    }
  ],
  "sources": [
    {
      "label": "anthropics/skills no GitHub",
      "url": "https://github.com/anthropics/skills",
      "kind": "repository"
    },
    {
      "label": "anthropics/skills, pasta da skill mcp-builder",
      "url": "https://github.com/anthropics/skills/tree/main/skills/mcp-builder",
      "kind": "documentation"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/pt-br/skills/mcp-builder/content.md",
    "json": "https://bestskillsforclaude.com/pt-br/skills/mcp-builder/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}