Anthropic descreve a maneira correta de construir servidores MCP

Eu tomo muitas decisões de design com base na intuição. Esta é a maneira certa de estruturar ferramentas MCP? O transporte deve ser remoto ou local? Quanta informação um agente deve receber sobre os campos que está escrevendo?

Você faz sua melhor escolha, entrega e segue em frente.

Há cerca de seis semanas, a Anthropic publicou suas recomendações para servidores MCP prontos para produção. Eu li e senti aquela satisfação silenciosa que você tem quando alguém chega ao mesmo lugar de forma independente. Cada ponto mapeava algo que já estava no Smeldr.

Aqui está como:

1. Construa servidores remotos, não locais/stdin

A recomendação da Anthropic: implemente servidores que funcionem remotamente. Servidores locais apenas com stdin não conseguem alcançar agentes web, móveis ou hospedados na nuvem.

O Smeldr vem com transporte HTTP+SSE. O servidor MCP funciona como um servidor HTTP padrão. Um agente rodando em qualquer lugar se conecta pela rede com um token de portador.

2. Agrupe ferramentas em torno da intenção, não de endpoints brutos

A recomendação da Anthropic: menos ferramentas focadas no que os usuários querem realizar, não espelhadas um a um a partir da sua superfície de API.

O Smeldr gera ferramentas agrupadas em torno da intenção do ciclo de vida do conteúdo. Para um Story você obtém create_story, update_story, publish_story, archive_story, list_stories, get_story.

O agente não precisa saber sobre rotas, linhas de banco de dados ou transições de estado. Ele chama publish_story e o framework cuida do resto: validação do ciclo de vida, aplicação de 404 para conteúdo não publicado, atualização do sitemap.

3. Envie semântica rica das ferramentas

A recomendação da Anthropic: use os recursos mais ricos do MCP para dar aos agentes um melhor contexto sobre o que as ferramentas fazem e o que os campos significam.

O Smeldr adiciona semântica no nível da estrutura:

type Story struct {
    smeldr.Node
    Title   string `smeldr:"required,min=3" smeldr_description:"A manchete da história"`
    Excerpt string `smeldr:"required"       smeldr_description:"1-2 frases usadas na listagem e como descrição meta"`
    Body    string `smeldr:"required"       smeldr_format:"markdown"`
}

smeldr_description informa ao agente para que serve um campo. smeldr_format informa qual formato usar. Estes estão incorporados no esquema MCP gerado a partir da estrutura. Cada chamada de ferramenta carrega esse contexto automaticamente.

4. Autenticação padronizada

A recomendação da Anthropic: implemente autenticação padronizada para evitar re-autenticações inesperadas e permitir uma configuração rápida na primeira vez.

O Smeldr usa tokens BearerHMAC. Cada chamada MCP é autenticada com um token de portador assinado. O gerenciamento de tokens está disponível através das ferramentas MCP, então um agente com o papel certo pode provisionar acesso para outros agentes.

(CIMD OAuth está no roadmap. Para implantações auto-hospedadas, a autenticação baseada em token permite que você comece em minutos.)

Essa é a lista completa. O problema tornou essas respostas óbvias. É sempre bom quando a especificação concorda.

Publicado originalmente em smeldr.dev