Leia mensagens MCP: JSON-RPC 2.0
Conheça os quatro formatos de mensagem e os códigos de erro padrão.
- Diferenciar solicitações, respostas, erros e notificações
- Correlacionar uma resposta à solicitação pelo id
- Reconhecer os códigos de erro JSON-RPC mais comuns
O MCP usa mensagens JSON-RPC. Uma solicitação tem jsonrpc, id e method; uma resposta repete o id e contém result ou error; uma notificação tem método, mas não tem id e não recebe resposta.
O id permite manter várias solicitações em andamento sem depender da ordem em que as respostas chegam. Para erros, -32601 significa método não encontrado e -32602 significa parâmetros inválidos.
| Formato | Tem id? | Tem method? | Contém… |
|---|---|---|---|
| Solicitação | sim (texto ou inteiro, nunca null) | sim | params opcional |
| Resposta de resultado | mesmo id da solicitação | não | result (com resultType) |
| Resposta de erro | mesmo id da solicitação | não | error com code inteiro e message |
| Notificação | não | sim | params opcionais; não recebe resposta |
1{
2 "jsonrpc": "2.0",
3 "id": 1,
4 "method": "tools/list",
5 "params": {
6 "_meta": {
7 "io.modelcontextprotocol/protocolVersion": "2026-07-28",
8 "io.modelcontextprotocol/clientInfo": {
9 "name": "ExampleClient",
10 "version": "1.0.0"
11 },
12 "io.modelcontextprotocol/clientCapabilities": {}
13 }
14 }
15}
16
17{
18 "jsonrpc": "2.0",
19 "id": 1,
20 "result": {
21 "resultType": "complete",
22 "tools": [
23 {
24 "name": "get_weather",
25 "description": "Get current weather for a city",
26 "inputSchema": {
27 "type": "object",
28 "properties": {
29 "city": {
30 "type": "string"
31 }
32 },
33 "required": [
34 "city"
35 ]
36 }
37 }
38 ]
39 }
40}Na revisão atual, todo resultado inclui resultType: "complete" para uma resposta concluída ou "input_required" quando o servidor precisa de mais dados. O id associa cada resultado à solicitação correspondente, mesmo quando várias estão em andamento.
Códigos de erro
O MCP usa os códigos JSON-RPC para falhas do protocolo e acrescenta alguns próprios:
| Código | Significado |
|---|---|
-32700 | Erro de análise: JSON inválido |
-32600 | Solicitação inválida |
-32601 | Método não encontrado |
-32602 | Parâmetros inválidos (inclui ferramenta desconhecida ou _meta obrigatório ausente) |
-32603 | Erro interno |
-32020 a -32022 | Erros MCP: divergência de cabeçalho, capacidade ausente ou versão incompatível |
Principais conclusões
O
idrelaciona cada resposta à sua solicitação.Notificações não têm
ide não recebem resposta.Use erros JSON-RPC para solicitações inválidas; preserve os códigos definidos pelo protocolo.
Quiz da aula
6 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: crie um servidor MCP
Escreva código Python no editor e execute os testes com exemplos. O Python roda localmente no navegador usando WebAssembly.
Classifique mensagens
Cada linha é uma mensagem JSON-RPC. Imprima request, notification, result, error ou invalid, conforme os campos presentes. Uma solicitação MCP com id: null é inválida.
- All four shapes
- Null id and junk
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Responda a um método desconhecido
Leia uma solicitação JSON-RPC. O servidor aceita apenas tools/list e tools/call. Imprima supported se o método for aceito; caso contrário, imprima a resposta de erro compacta com -32601 e repita o id.
- Unknown method
- String id
- Supported
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…