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.