# 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. 15 de novembro de 2026 · jsonW 1.3.11 · https://jsonw.org/newsroom/mcp-descoberta-e-ferramentas-com-login ## 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. Fonte: https://modelcontextprotocol.io/specification/2026-07-28