Carregando
0xA0Lição 11 de 16

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.

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

Uma 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.

Mensagem 1 de 6Previsões 0/0
Pessoa usuária
Host + cliente
Servidor MCP

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.

sign_state.py — detecte alteração no estado
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]))
Saída
False

Principais conclusões

  • O resultado input_required pausa 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.

Exercício 1

Monte a chamada de continuação

+25 XP

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
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

Assine e valide o estado

+25 XP

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
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…