Mantenha estado com identificadores e acompanhe mudanças
Carregue estado entre chamadas com handles explícitos e receba notificações sobre alterações.
- 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.
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"))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/listenpara acompanhar listas de ferramentas, prompts ou recursos, ou URIs específicas. O fluxo permanece aberto e as notificações incluemsubscriptionIdem_meta. - Progresso: uma solicitação pode incluir
progressTokenem_metapara recebernotifications/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, comtasks/getpara 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.
Proteja handles de carrinho
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
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…