Solicite informações durante uma chamada
Use respostas que pedem dados, retorne as informações do usuário e continue sem perder a integridade do estado.
- Reconhecer resultados
input_required - Repetir estado opaco sem alterá-lo
- Manter usuário e cliente no controle de solicitações de informação
Uma ferramenta pode precisar de uma informação que ainda não recebeu. Em vez de adivinhar, o servidor retorna resultType: "input_required", descreve as perguntas e inclui um requestState opaco. O host apresenta as perguntas ao usuário; o cliente envia as respostas em uma nova chamada com um novo id JSON-RPC.
O cliente repete requestState exatamente como recebeu, sem interpretar nem alterar o valor. Como o cliente pode ser malicioso, o servidor protege a integridade desse estado (por exemplo, com assinatura) e confere autorização novamente quando a chamada continua.
Experimente
Até 15 XPUma reserva que precisa de confirmação
Acompanhe uma ferramenta de reserva que pede à pessoa usuária para escolher um assento antes da compra. Tente prever cada etapa.
Nunca confie no estado que retorna
Como requestState passa pelo cliente, alguém pode alterá-lo — por exemplo, trocar o preço de uma compra. O servidor deve tratá-lo como controlado por um atacante. Se o valor influencia autorização ou regras de negócio, proteja sua integridade com HMAC ou criptografia autenticada e rejeite alterações. Associe o estado ao usuário, defina uma expiração curta e vincule-o à solicitação original.
1import hashlib, hmac
2secret = b"server-only-secret"
3state = '{"flight": "TP123", "price": 120}'
4signature = hmac.new(secret, state.encode(), hashlib.sha256).hexdigest()[:16]
5tampered = '{"flight": "TP123", "price": 1}'
6print(hmac.compare_digest(signature, hmac.new(secret, tampered.encode(), hashlib.sha256).hexdigest()[:16]))False
Principais conclusões
O resultado
input_requiredpausa o fluxo para coletar informações.O host pede os dados ao usuário; o cliente inicia uma nova solicitação.
Estado opaco deve ser repetido sem alterações e validado pelo servidor.
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.
Monte a chamada de continuação
Leia a solicitação original, as perguntas retornadas e as respostas do usuário. Monte uma nova chamada com outro id, as respostas e o mesmo requestState. Informe quais respostas ainda estão faltando.
- One answer with state
- An unanswered request
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.
Assine e valide o estado
Use o segredo do servidor para validar a assinatura do estado recebido. Aceite o estado íntegro e rejeite valores alterados ou sem assinatura.
- Genuine and tampered
- Unsigned
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…