Aller au contenu

Cercle IA .tech · Technique

Cercle IA TechMCP

Guide

MCP sans utilisateur : OAuth client credentials

Connecter un service, une tâche planifiée ou un pipeline à un serveur MCP sans navigateur : l'extension OAuth Client Credentials, JWT ou secret.

Mis à jour le

Le flux d'autorisation standard de MCP (Model Context Protocol) suppose un humain : un navigateur s'ouvre, la personne se connecte et donne son accord. Il ne convient pas quand personne n'est là. L'extension OAuth Client Credentials, identifiée par io.modelcontextprotocol/oauth-client-credentials, permet à un client de s'authentifier avec les identifiants de l'application elle-même, sans redirection ni interaction. Page rédigée d'après la documentation officielle lue le 16/11/2026. Pour le flux standard et les jetons, voir MCP distant et OAuth.

La référence MCP d’ALMA présente son accès à la plateforme. Faites confirmer le flux accepté pour votre scénario automatisé ; l’annonce d’une connexion OAuth ne suffit pas à établir le support de client credentials.

Quand l'utiliser

La documentation cite quatre situations :

  • des services en arrière-plan qui appellent des outils MCP à intervalle régulier ou sur événement ;
  • des pipelines d'intégration et de déploiement continus ;
  • des intégrations entre deux systèmes sans utilisateur final ;
  • des processus résidents qui ont besoin d'un accès durable.

Si un humain doit autoriser explicitement l'accès, restez sur le flux standard. Pour la gestion des accès à l'échelle d'une organisation, voir MCP en entreprise.

Deux formats d'identifiants

Assertion JWT (recommandée)

Définie par la RFC 7523 : le client signe un jeton avec sa clé privée et le présente comme preuve d'identité ; le serveur d'autorisation vérifie la signature avec la clé publique enregistrée. Le client envoie au point de jeton grant_type=client_credentials, client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer, client_assertion=<JWT signé> et resource=<URI du serveur MCP>. L'assertion authentifie le client ; elle ne remplace pas le type d'octroi par jwt-bearer. L'assertion contient en général iss et sub (l'identifiant du client), aud (l'identifiant issuer du serveur d'autorisation, comme unique audience), exp (expiration) et iat (émission).

La documentation actuelle cite la RFC 10070 : l'URL du point de jeton n'est plus une audience acceptée pour cette assertion, contrairement à ce que permettait la RFC 7523. Ne confondez pas non plus cette audience avec celle du jeton d'accès final, destiné au serveur MCP.

Secret client

Pour des déploiements plus simples : grant_type=client_credentials avec client_id et client_secret. Le client les envoie au point de jeton et reçoit un jeton d'accès.

La documentation met en garde : un secret client est un identifiant de longue durée qui donne accès sans interaction. S'il fuit, un attaquant peut s'authentifier en silence comme votre application jusqu'à la rotation du secret. Ses conseils :

  • stocker les secrets dans un gestionnaire de secrets, jamais dans le code ni dans un fichier d'environnement commité ;
  • les renouveler régulièrement, et tout de suite après un soupçon de compromission ;
  • limiter les droits au strict nécessaire ;
  • préférer les assertions JWT quand c'est possible, car elles sont de courte durée et n'exigent pas de transmettre la clé de signature.

Côté client

Le client doit : déclarer le support de l'extension dans ses capacités par requête (io.modelcontextprotocol/clientCapabilities, champ extensions), obtenir un jeton auprès du serveur d'autorisation avant de se connecter, le passer dans l'en-tête Authorization: Bearer <jeton> et gérer le renouvellement, en respectant leur expiration effective. La durée dépend de la politique du serveur d'autorisation.

Les SDK officiels TypeScript et Python gèrent l'obtention et le renouvellement. Le fournisseur d'identifiants fixe l'émetteur attendu du serveur d'autorisation, pour refuser d'envoyer les identifiants à un autre serveur que le serveur MCP pourrait annoncer. Extrait de la documentation (TypeScript, assertion JWT) :

const provider = new PrivateKeyJwtProvider({
  clientId: "my-service",
  privateKey: process.env.CLIENT_PRIVATE_KEY_PEM,
  algorithm: "RS256",
  expectedIssuer: "https://auth.example.com",
});

Remarquez que la clé privée vient d'une variable d'environnement, pas du code.

Côté serveur

Le serveur doit valider le jeton à chaque requête (signature et revendications, en général via le point JWKS du serveur d'autorisation), vérifier que les portées couvrent l'opération demandée, et, de façon facultative mais recommandée, annoncer l'extension dans sa réponse à server/discover.

Et pour une intégration métier ?

OAuth 2.0 sert aussi hors de MCP, quand on branche une application à un CRM ; côté intégrateur, le pas à pas du flux avec code d'autorisation est détaillé dans connecter une application à un CRM avec OAuth.

Tester une identité de service

Dédiez une identité à chaque tâche automatisée pour éviter qu'un import documentaire partage les droits d'un traitement de facturation. Vérifiez un appel autorisé, un appel hors portée et un appel après expiration. Testez aussi un émetteur différent : le fournisseur d'identifiants doit refuser de lui transmettre les preuves d'authentification.

Documentez qui peut renouveler la clé et comment arrêter la tâche en cas d'incident. Une assertion de courte durée réduit l'utilité d'une assertion volée ; elle ne protège pas une clé privée compromise, qui permet d'en signer de nouvelles.

À vérifier avant de choisir

Comme toute extension, celle-ci n'est jamais active par défaut et son support varie selon les clients. Consultez la matrice de compatibilité des extensions sur modelcontextprotocol.io avant de bâtir dessus.

Questions fréquentes

Quand utiliser OAuth Client Credentials avec MCP ?

Quand aucun humain n'est présent : service en arrière-plan, pipeline d'intégration continue, intégration entre deux systèmes, processus résident. Si un utilisateur doit autoriser l'accès, la documentation renvoie vers le flux d'autorisation standard.

Quel format d'identifiant est recommandé ?

La documentation recommande les assertions JWT signées (RFC 7523), de courte durée, plutôt qu'un secret client long, même si le secret client reste pris en charge.

Cette extension est-elle active par défaut ?

Non. Les extensions sont facultatives, jamais actives par défaut, et leur prise en charge varie selon les clients.

Références du carnet

Pages consultées pour écrire cet article :

  1. Site d’ALMA : référence MCP
  2. https://modelcontextprotocol.io/extensions/auth/oauth-client-credentials.md
  3. https://modelcontextprotocol.io/llms.txt

À lire aussi