Pular para o conteúdo
jsonW Paper GitHub

Protocolos de comércio com agentes

MCP: como o endereço do servidor aparece nos arquivos de descoberta do jsonW

O MCP é o protocolo que liga um assistente a ferramentas. O jsonW aponta o endereço desse servidor nos arquivos de descoberta de cada site. Veja o formato de uma chamada MCP, o que responde sem login na Wortic e o que exige a autorização da pessoa.

· jsonW 1.3.11

O protocolo

O MCP liga um assistente a ferramentas, recursos e instruções de um servidor. A troca segue o padrão JSON-RPC 2.0. Cada pedido tem um método, como initialize para começar, tools/list para listar ferramentas e tools/call para usar uma.

{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {...}}

Onde o jsonW aparece

O jsonW não é o servidor MCP. Ele aparece na descoberta. Os arquivos agents.txt e agent-permissions.json de cada site apontam para o endereço do servidor MCP. Esses arquivos são gerados a partir do catálogo em jsonW, então o endereço sai do mesmo lugar em todos eles.

O que responde sem login

O servidor da Wortic, em mcp.wortic.com/mcp, responde ao initialize sem login. Ele também responde à lista de ferramentas. Isso serve para o assistente saber o que existe antes de pedir qualquer coisa.

O que exige login

Uma chamada de ferramenta que lê dado fechado ou age em nome de uma conta exige token. Sem o token, o servidor responde com erro 401, de não autorizado. O token vem do fluxo OAuth, em que a pessoa entra com a própria conta e autoriza o aplicativo.

O que o MCP não garante

O protocolo padroniza a ligação, mas não confere se a ferramenta foi usada da forma certa. Essa checagem fica no servidor. Por isso, cada ferramenta precisa validar a entrada e recusar o que não bate.

Como conferir o seu endereço

Teste o initialize com um pedido simples e confira a resposta. Depois, teste uma ferramenta que exige login sem token. A resposta esperada é 401. Se vier outra coisa, a regra de acesso está errada.

A especificação está em modelcontextprotocol.io, e o repositório oficial, em repositório oficial do MCP.

O que é uma ferramenta

Cada ferramenta da lista tem um nome, uma descrição e um esquema de entrada, o inputSchema, que diz quais campos o assistente deve enviar. A página de ferramentas da especificação oficial descreve o formato, inclusive a resposta.

Resposta de sucesso e de erro

Uma chamada que deu certo volta com o resultado. Uma chamada com erro de aplicação volta com a marca isError e uma explicação em texto. Quem integra deve tratar os dois casos, porque um erro pode parecer um resultado vazio.

Como isso conversa com o jsonW

O jsonW aparece na descoberta, como já mostramos nas publicações sobre agents.txt e agent-permissions.json. O endereço do servidor MCP sai do mesmo catálogo. Registrar cada chamada de ferramenta seria uma decisão nova, com esquema próprio.

Versões do protocolo

O cliente informa a versão no pedido de início. O servidor responde com a versão que aceita. Se as versões não baterem, a conversa para antes de qualquer ferramenta.

O que a lista de ferramentas não diz

A lista diz o nome, a descrição e os campos de entrada. Ela não diz quem pode chamar a ferramenta nem qual o limite de uso. Essas regras ficam no servidor e na descrição do site, e por isso precisam estar escritas em um lugar que a equipe possa conferir.

Especificação oficial do MCP (versão 2026-07-28) →