OAuth (MCP)
OAuth 2.1 com PKCE e registro dinâmico de clientes para assistentes de IA.
Consultar metadados do servidor de autorização OAuth
Documento de descoberta do servidor de autorização usado pelos clientes MCP: emissor, endpoints de autorização, token, registro e revogação. Suporta apenas `response_type` `code`, os grants `authorization_code` e `refresh_token`, PKCE `S256`, clientes públicos (`token_endpoint_auth_method` `none`) e o escopo `mcp`. Rota pública sem autenticação.
Consultar metadados do recurso protegido MCP
Documento de descoberta do recurso protegido: informa a URL do endpoint `/mcp`, o servidor de autorização, o envio do token no cabeçalho `Authorization` e o escopo `mcp`. Rota pública sem autenticação.
Registrar cliente OAuth
Registro dinâmico de um cliente MCP público: gera um `client_id` e grava as `redirect_uris` informadas (ao menos uma, todas `http` ou `https`). Só aceita `token_endpoint_auth_method` `none`; outro valor retorna `400`. Responde `201`. Rota pública sem autenticação.
Iniciar autorização OAuth
Redireciona (`302`) para a tela de consentimento do painel da organização, preservando a query string recebida. Nenhum código é emitido aqui: a pessoa escolhe o que compartilhar e confirma pela rota de consentimento. Rota pública sem autenticação.
Emitir token de acesso OAuth
Troca um código de autorização (com `code_verifier` PKCE `S256` e a mesma `redirect_uri`) ou um `refresh_token` por um token de acesso `Bearer` para o endpoint MCP. Aceita corpo em formulário ou JSON. Verificador PKCE inválido retorna `401`; `grant_type` não suportado retorna `400`. Rota pública; o cliente se identifica por `client_id`.
Revogar token OAuth
Revoga o `refresh_token` informado em `token` ou `refresh_token`. Sempre responde `{'revoked': true}`, mesmo quando o token não existe. Rota pública sem autenticação.
Consentir acesso de cliente MCP
Registra o consentimento da pessoa para um cliente MCP: cria uma chave que age em nome dela com as `permission_keys` escolhidas e devolve a `redirect_uri` com o código de autorização. Exige PKCE `S256`. Se alguma permissão escolhida for sensível, é obrigatório enviar `mfa_code` TOTP (`400` `mfa_required` se ausente, `401` se errado). Exige uma pessoa autenticada (não uma chave de API), com vínculo ativo na organização atual e segundo fator satisfeito.