Carregando
0x20Lição 3 de 16

Leia mensagens MCP: JSON-RPC 2.0

Conheça os quatro formatos de mensagem e os códigos de erro padrão.

18 min Questionário com 6 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • 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.

FormatoTem id?Tem method?Contém…
Solicitaçãosim (texto ou inteiro, nunca null)simparams opcional
Resposta de resultadomesmo id da solicitaçãonãoresult (com resultType)
Resposta de erromesmo id da solicitaçãonãoerror com code inteiro e message
Notificaçãonãosimparams opcionais; não recebe resposta
Exemplo de solicitação e resultado
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ódigoSignificado
-32700Erro de análise: JSON inválido
-32600Solicitação inválida
-32601Método não encontrado
-32602Parâmetros inválidos (inclui ferramenta desconhecida ou _meta obrigatório ausente)
-32603Erro interno
-32020 a -32022Erros MCP: divergência de cabeçalho, capacidade ausente ou versão incompatível

Principais conclusões

  • O id relaciona cada resposta à sua solicitação.

  • Notificações não têm id e 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.

Exercício 1

Classifique mensagens

+25 XP

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
main.py
Carregando editor…

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.

Exercício 2

Responda a um método desconhecido

+25 XP

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
main.py
Carregando editor…

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…