OAuth 2.1

OAuth 2.1 avec PKCE et enregistrement dynamique des clients, pour qu’un client MCP puisse se connecter à LLM Pulse sans que l’utilisateur ait à coller une clé API.

OAuth 2.1 (ChatGPT Apps SDK, clients MCP)

Serveur d’autorisation OAuth 2.1 avec PKCE-S256, enregistrement dynamique des clients (RFC 7591) et métadonnées de découverte (RFC 8414 + RFC 9728). Utilisé par ChatGPT Apps SDK et par tout autre client MCP compatible avec OAuth. Disponible sur tous les forfaits pour la ressource MCP /api/v1/mcp. Les jetons d’accès JWT signés en RS256 et le jeton d’actualisation réutilisable partagent une échéance d’autorisation fixe d’un an.

Présentation d’OAuth 2.1

Utilisez OAuth 2.1 quand votre client a besoin d’un accès délégué par utilisateur à l’endpoint MCP et que vous ne pouvez pas y intégrer de clé API (par exemple, un assistant IA multi-tenant). Utilisez des clés API quand vous contrôlez les deux côtés et voulez une intégration plus simple (à partir du forfait Scale). Le MCP via OAuth est disponible sur tous les forfaits, essai gratuit compris.

Endpoints : /oauth/authorize, /oauth/token, /oauth/register, /oauth/jwks.json, /.well-known/oauth-authorization-server, /.well-known/oauth-protected-resource.

GET/.well-known/oauth-authorization-server

Métadonnées du serveur d’autorisation sur /.well-known/oauth-authorization-server (RFC 8414) et métadonnées de la ressource protégée sur /.well-known/oauth-protected-resource (RFC 9728). Le JWKS qui sert à vérifier la signature des jetons d’accès se trouve sur /oauth/jwks.json. Les clients doivent récupérer ces métadonnées pour découvrir les endpoints d’autorisation, de jeton et d’enregistrement, sans jamais les coder en dur.

Aucun paramètre. Renvoie un JSON avec issuer, authorization_endpoint, token_endpoint, registration_endpoint, jwks_uri, scopes_supported, code_challenge_methods_supported et les métadonnées associées.

POST/oauth/register

Enregistrement dynamique des clients selon la RFC 7591. Sans authentification, limité à 5 requêtes par heure et par IP. Seuls les champs de la RFC 7591 sont conservés (les champs supplémentaires sont ignorés). Les URI de redirection doivent être en HTTPS (tout hôte) ou en HTTP loopback (localhost / 127.0.0.1) ; les schémas personnalisés comme javascript:, data: ou file: sont refusés. 10 URI de redirection maximum par client ; client_name limité à 200 caractères ; URI limitées à 2 048 caractères.

Corps JSON : redirect_uris (tableau obligatoire), client_name, grant_types (par défaut authorization_code refresh_token), token_endpoint_auth_method (none pour les clients PKCE publics, client_secret_post pour les clients confidentiels), scope.

GET/oauth/authorize

Affiche un écran de consentement dans l’application. Après approbation, redirige l’utilisateur vers redirect_uri avec un code à usage unique (durée de vie de 10 minutes) et le state d’origine. PKCE-S256 est obligatoire ; les challenges plain sont refusés.

Paramètres : response_type=code (obligatoire), client_id (obligatoire), redirect_uri (obligatoire, doit correspondre exactement à une URI enregistrée), code_challenge (obligatoire), code_challenge_method=S256 (obligatoire), scope (valeurs séparées par des espaces : mcp:read mcp:write), state, resource (indicateur de ressource RFC 8707).

POST/oauth/token

Échange un code d’autorisation contre un jeton d’accès et un jeton d’actualisation, ou actualise un jeton d’accès. Utilise application/x-www-form-urlencoded. Limité à 60 requêtes par minute et par IP. Les réponses d’actualisation renvoient le même jeton d’actualisation réutilisable, et tous les identifiants expirent à l’échéance d’autorisation fixe d’un an.

Corps : grant_type (authorization_code ou refresh_token), client_id (obligatoire), client_secret (obligatoire pour les clients confidentiels), et soit {code, code_verifier, redirect_uri}, soit {refresh_token, scope facultatif pour restreindre les droits}.

Scopes et vérification de l’audience

mcp:read (par défaut) donne accès aux outils en lecture seule. mcp:write est requis pour les outils en écriture, notamment create_prompts, create_intelligence_task, create_competitor, create_collection, assign_prompt_tags, create_annotation, update_intelligence_task_content, revert_intelligence_task_content, launch_recommendations, create_technical_geo_report, update_technical_geo_report_content et revert_technical_geo_report_content. Appelez tools/list après la connexion pour voir les outils accessibles au jeton. Un jeton émis avec le seul scope mcp:read ne peut pas appeler les outils en écriture : tools/list les masque et un appel direct à tools/call renvoie une erreur. Un jeton sans mcp:read ne peut pas utiliser les outils en lecture seule, même avec mcp:write. La claim JWT aud doit correspondre à l’URL de la ressource MCP annoncée, à l’URL de base de l’hôte de la requête, à l’émetteur du serveur d’autorisation ou à cet émetteur suivi de /api/v1/mcp. Sans indicateur de ressource, l’émetteur est utilisé ; toute autre audience est refusée sur /api/v1/mcp.

Lors de l’actualisation d’un jeton, vous POUVEZ transmettre un scope plus restreint ; tout scope plus large que l’autorisation d’origine renvoie invalid_grant.