Transporte mensagens: stdio e Streamable HTTP
Compare servidores locais e remotos e evite misturar logs com mensagens do protocolo.
- 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çalho | Copiado de |
|---|---|
MCP-Protocol-Version | versão em _meta |
Mcp-Method | method |
Mcp-Name | params.name ou params.uri nas operações relevantes |
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 XPAceitar ou rejeitar?
Cada item resume uma solicitação HTTP a um servidor MCP. O servidor deve aceitá-la ou rejeitá-la?
“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.
Valide os cabeçalhos da solicitação
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
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.
Codifique um valor de cabeçalho
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
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…