Carregando
0xB0Lição 12 de 16

Mantenha estado com identificadores e acompanhe mudanças

Carregue estado entre chamadas com handles explícitos e receba notificações sobre alterações.

20 min Questionário com 5 perguntas 1 exercício de código
Ao final desta lição, você saberá
  • Persistir estado entre chamadas sem depender da conexão
  • Associar cada handle ao usuário autenticado
  • Cancelar solicitações e acompanhar mudanças com segurança

Uma conexão MCP não deve ser tratada como armazenamento permanente de estado. Para um carrinho de compras, por exemplo, a ferramenta pode devolver um handle aleatório e opaco. Chamadas seguintes enviam esse identificador para continuar o trabalho.

O handle não é uma credencial: associe-o ao usuário autenticado, aplique limites, expiração e autorização em cada chamada. Para acompanhar alterações, o cliente usa subscriptions/listen; em Streamable HTTP, fechar o fluxo de resposta cancela aquela solicitação.

handles.py — associe cada carrinho ao usuário
1import secrets
2baskets = {}
3
4def create_basket(user):
5    basket_id = "bsk_" + secrets.token_hex(8)
6    baskets[(user, basket_id)] = []
7    return basket_id
8
9def add_item(user, basket_id, sku):
10    if (user, basket_id) not in baskets:
11        return "error: unknown or expired basket"
12    baskets[(user, basket_id)].append(sku)
13    return f"{len(baskets[(user, basket_id)])} item(s)"
14
15basket = create_basket("ana")
16print(add_item("ana", basket, "book"), "|", add_item("mallory", basket, "tv"))
Saída
1 item(s) | error: unknown or expired basket

Bons identificadores de estado são:

  • imprevisíveis: aleatórios, não sequências como basket-1;
  • vinculados ao usuário: use a identidade do token verificado, não um nome enviado pelo cliente; um identificador é um nome, não uma senha;
  • temporários: informe o prazo na descrição da ferramenta, por exemplo “carrinhos expiram após 24 horas”;
  • claros quando expiram: retorne um erro de execução para que o modelo possa criar outro carrinho.

Inscrições e trabalho demorado

  • Notificações de mudança: o cliente abre subscriptions/listen para acompanhar listas de ferramentas, prompts ou recursos, ou URIs específicas. O fluxo permanece aberto e as notificações incluem subscriptionId em _meta.
  • Progresso: uma solicitação pode incluir progressToken em _meta para receber notifications/progress.
  • Cancelamento: em Streamable HTTP, fechar o fluxo de resposta cancela a solicitação; em stdio, o cliente envia notifications/cancelled.
  • Tarefas longas: trabalho de minutos ou horas usa a extensão oficial io.modelcontextprotocol/tasks, com tasks/get para consultar o andamento.

Principais conclusões

  • Handles opacos permitem carregar estado entre chamadas.

  • Sempre associe estado ao usuário autenticado; um handle não prova identidade.

  • Aplique expiração e autorização em cada chamada e feche fluxos para cancelar.

Quiz da aula

5 perguntas · aprovação com 4 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

Proteja handles de carrinho

+25 XP

Leia operações de criação, inclusão e consulta de carrinhos. Permita acesso apenas quando o identificador pertencer ao usuário autenticado; rejeite tentativas de outro usuário.

  • Owner and intruder
  • Empty and unknown
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…