Carregando
0x40Lição 5 de 16

Transporte mensagens: stdio e Streamable HTTP

Compare servidores locais e remotos e evite misturar logs com mensagens do protocolo.

20 min Questionário com 6 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Descrever o enquadramento de mensagens stdio
  • Manter stdout reservado ao protocolo
  • Validar cabeçalhos e corpo em solicitações HTTP

stdio: um subprocesso local

stdio conecta o host a um processo local: o host envia mensagens por stdin e lê respostas em stdout. Cada mensagem ocupa uma linha. Use stderr para logs; qualquer texto extra em stdout pode corromper o protocolo.

Para servidores remotos, Streamable HTTP transporta mensagens por HTTP. Se metadados nos cabeçalhos repetirem informações do corpo JSON, valide se ambos concordam antes de executar a operação. O servidor também deve validar a origem e proteger os recursos locais contra requisições indevidas.

Streamable HTTP: um servidor remoto

Um servidor remoto expõe um único endpoint MCP, como https://example.com/mcp. Cada mensagem é um POST próprio. A resposta pode ser JSON ou um fluxo de Server-Sent Events para transmitir progresso antes do resultado final.

Cada POST também repete campos importantes do corpo em cabeçalhos, permitindo que gateways e balanceadores encaminhem e limitem solicitações sem analisar o JSON:

CabeçalhoCopiado de
MCP-Protocol-Versionversão em _meta
Mcp-Methodmethod
Mcp-Nameparams.name ou params.uri nas operações relevantes
Exemplo de solicitação Streamable HTTP
1POST /mcp HTTP/1.1
2Content-Type: application/json
3Accept: application/json, text/event-stream
4MCP-Protocol-Version: 2026-07-28
5Mcp-Method: tools/call
6Mcp-Name: get_weather
7
8{
9  "jsonrpc": "2.0",
10  "id": 1,
11  "method": "tools/call",
12  "params": {
13    "name": "get_weather",
14    "arguments": {
15      "location": "Seattle, WA"
16    },
17    "_meta": {
18      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
19      "io.modelcontextprotocol/clientInfo": {
20        "name": "ExampleClient",
21        "version": "1.0.0"
22      },
23      "io.modelcontextprotocol/clientCapabilities": {}
24    }
25  }
26}

Se cabeçalho e corpo divergirem — por exemplo, o gateway vê Mcp-Name: get_weather, mas o corpo chama delete_account — alguém pode contornar políticas de roteamento. O servidor deve rejeitar a solicitação com HTTP 400 e erro -32020 (HeaderMismatch). Valores que não são ASCII simples usam codificação Base64 no formato =?base64?…?=.

Experimente

Até 15 XP

Aceitar ou rejeitar?

Cada item resume uma solicitação HTTP a um servidor MCP. O servidor deve aceitá-la ou rejeitá-la?

0 de 5 classificadosPontuação 0/0
  • “Mcp-Method: tools/call, método do corpo tools/call e Mcp-Name igual ao nome da ferramenta”

  • “Mcp-Name: get_weather, mas o corpo chama a ferramenta delete_files”

  • “MCP-Protocol-Version: 2026-07-28, mas _meta do corpo informa 2025-11-25”

  • “tools/call sem o cabeçalho Mcp-Name”

  • “Origin: https://evil.example em um servidor destinado apenas a um app local”

Principais conclusões

  • Em stdio, stdout é o canal MCP; stderr é o canal de logs.

  • Mensagens stdio são delimitadas por linha.

  • Em HTTP, valide cabeçalhos, corpo e origem antes de agir.

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

Valide os cabeçalhos da solicitação

+25 XP

Compare os cabeçalhos HTTP com o corpo JSON: versão do protocolo, método e nome da ferramenta ou URI. Imprima ok se tudo coincidir ou -32020 HeaderMismatch: NAME para a primeira divergência.

  • All match
  • Smuggled tool
  • Version mismatch
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

Codifique um valor de cabeçalho

+25 XP

Leia um valor. Se os caracteres forem ASCII imprimíveis, não houver espaços no início/fim e ele ainda não estiver codificado, imprima-o sem alteração. Caso contrário, imprima =?base64? + Base64 dos bytes UTF-8 + ?=.

  • Plain ASCII
  • Non-ASCII
  • Padded
  • Looks encoded
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…