5 Recursos Subestimados do MCP que Tornam Clientes de IA Mais Inteligentes

Todo mundo está construindo servidores MCP.

A maioria das conversas se concentra em transportes, autenticação, OAuth e exposição de ferramentas. Esses tópicos são importantes, mas enquanto construía alguns servidores MCP recentemente, percebi que apreciava uma parte diferente da especificação que não parece receber tanta atenção.

A coisa interessante é que essas não são APIs ocultas. Elas já fazem parte da especificação do Protocolo de Contexto do Modelo ou suas extensões oficiais.

Nenhuma das funcionalidades abaixo muda o que sua ferramenta faz.

Elas mudam quão claramente um cliente pode entender e interagir com seu servidor.

1. Anotações de Ferramentas

Esta é a funcionalidade que inspirou este post.

O MCP permite que você descreva o comportamento de uma ferramenta por meio de anotações como readOnlyHint, idempotentHint, destructiveHint e openWorldHint.

{
  "annotations": {
    "readOnlyHint": true,
    "idempotentHint": true,
    "destructiveHint": false,
    "openWorldHint": false
  }
}

Em vez de apenas dizer a um cliente o que uma ferramenta faz, você também está dizendo como ela se comporta.

Alguns exemplos:

• readOnlyHint indica que a ferramenta não modifica seu ambiente.
• idempotentHint indica que chamar repetidamente uma ferramenta de escrita com os mesmos argumentos não tem efeito adicional em seu ambiente.
• destructiveHint distingue atualizações potencialmente destrutivas de aditivas.
• openWorldHint indica se a ferramenta pode interagir com um mundo aberto de entidades externas.

Por exemplo, uma ferramenta de busca na web opera em um mundo aberto, enquanto uma ferramenta que acessa um armazenamento de memória local fixo opera em um domínio fechado.

Essas podem parecer simples booleanos, mas podem fornecer aos clientes um contexto útil ao planejar a execução, apresentar ferramentas aos usuários ou projetar fluxos de confirmação.

Há alguns detalhes que vale a pena notar.

idempotentHint e destructiveHint são significativos apenas para ferramentas que não são somente leitura. Além disso, destructiveHint: false significa que a ferramenta realiza apenas atualizações aditivas.

Mais importante, essas são dicas, não garantias de segurança. Os clientes não devem tomar decisões sensíveis à segurança com base em anotações de servidores não confiáveis. Autenticação, autorização, consentimento do usuário e salvaguardas determinísticas ainda são importantes.

📖 Especificação MCP: Ferramentas

2. Resultados Estruturados de Ferramentas

Muitas ferramentas MCP ainda retornam apenas texto.

Encontrados 12 documentos correspondentes.

Isso funciona perfeitamente para humanos.

Os clientes frequentemente se beneficiam ao receber os dados subjacentes em uma forma estruturada também.

As ferramentas MCP podem retornar um valor JSON através de structuredContent.

{
  "structuredContent": {
    "documents": [
      {
        "title": "...",
        "url": "...",
        "lastModified": "..."
      }
    ]
  }
}

O valor não precisa ser um objeto. Pode ser qualquer valor JSON válido, incluindo um array, string, número, booleano ou nulo.

Dados estruturados podem facilitar para os clientes validar resultados, renderizar interfaces, passar dados para outro fluxo de trabalho ou permitir que modelos trabalhem com campos individuais sem precisar analisar uma resposta em linguagem natural.

Para compatibilidade retroativa, a especificação recomenda também retornar o JSON serializado em um bloco de conteúdo de texto regular.

Uma distinção terminológica é útil aqui: structuredContent do MCP é um resultado estruturado de ferramenta. Não é a mesma coisa que a saída estruturada de LLM ou geração de modelo com esquema restrito.

📖 Especificação MCP: Conteúdo Estruturado

3. Esquemas de Saída

Se você está retornando dados estruturados, diga aos clientes como eles se parecem.

Quando um cliente descobre ferramentas através de tools/list, ele recebe o inputSchema de cada ferramenta.

Uma ferramenta também pode expor um outputSchema.

{
  "name": "search_documents",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string"
      }
    },
    "required": ["query"]
  },
  "outputSchema": {
    "type": "object",