Carregando
0xC0Lição 13 de 16

Autorize servidores remotos com OAuth

Acompanhe a descoberta do servidor de autorização, a emissão de tokens e a solicitação de escopos adicionais.

25 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Identificar os papéis no fluxo OAuth para MCP
  • Validar token, emissor, público e escopos
  • Tratar com segurança a etapa de autorização adicional

Um servidor MCP remoto pode exigir autorização OAuth. O servidor protegido atua como servidor de recursos: anuncia como descobrir o servidor de autorização e valida cada token recebido. O cliente solicita um token para o recurso certo, usando Authorization Code com PKCE quando aplicável.

O servidor deve validar assinatura, emissor, expiração, público (aud) e escopos. Envie tokens no cabeçalho Authorization: Bearer, nunca na URL, nos argumentos da ferramenta ou em logs. Um token válido sem o escopo necessário pode gerar 403 com insufficient_scope para iniciar a concessão de acesso adicional.

Experimente

Até 15 XP

De 401 ao token de acesso

Avance pelo fluxo da primeira conexão do cliente a um servidor protegido. Antes de revelar cada etapa com uma pergunta, tente prevê-la.

Mensagem 1 de 10Previsões 0/0
Navegador
Cliente MCP
Servidor MCP
Servidor de autorização

Menor privilégio e ampliação de escopos

Clientes devem pedir o menor conjunto de escopos, começando pelos indicados no parâmetro scope da resposta 401, quando houver. Se uma operação posterior exigir mais acesso, como gravar um arquivo, o servidor responde 403 com error="insufficient_scope" e os novos escopos. O cliente solicita autorização novamente com a união dos escopos antigos e novos, para não perder acesso anterior, e limita o número de tentativas.

Para registrar o cliente, o método preferido é um Client ID Metadata Document: o client_id é uma URL HTTPS que descreve o cliente. Dynamic Client Registration ainda funciona, mas está obsoleto.

step_up.py — una escopos antigos e novos
granted = {"files:read"}
challenged = {"files:write"}
print(" ".join(sorted(granted | challenged)))
Saída
files:read files:write

Principais conclusões

  • O servidor MCP remoto é um servidor de recursos OAuth.

  • Envie tokens no cabeçalho Authorization e valide emissor, público, expiração e escopos.

  • PKCE protege a troca do código; escopos adicionais devem ser solicitados de forma explícita.

Quiz da aula

7 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

Valide um token de acesso

+25 XP

Leia as claims do token e os requisitos do servidor. Aceite somente quando emissor, público, expiração e escopos forem válidos; indique qual verificação falhou primeiro.

  • Token válido
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

Solicite escopos adicionais

+25 XP

Interprete a resposta de escopo insuficiente e construa a próxima etapa OAuth com o escopo necessário, sem reutilizar dados de autorização em uma URL insegura.

  • Escopo de leitura
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…