Authentification et quotas

L'offre et les portées sont relues à chaque appel : une révocation prend effet tout de suite.

Le parcours d'autorisation

Votre client mène ce parcours seul à partir de l'adresse du connecteur. Vous n'avez rien à saisir à la main, sauf l'accord sur la page de Prescriptio.

1. 1

   Découverte

   Un appel sans jeton répond 401 avec un en-tête WWW-Authenticate qui désigne la métadonnée de ressource. Le client lit /.well-known/oauth-protected-resource (RFC 9728), puis /.well-known/oauth-authorization-server (RFC 8414).

   WWW-Authenticate: Bearer realm="MCP",
     resource_metadata="https://prescriptio.fr/.well-known/oauth-protected-resource"

2. 2

   Enregistrement du client

   Si l'hôte le demande, le client s'enregistre lui-même (RFC 7591). Il n'y a pas d'identifiant à demander à Prescriptio.

3. 3

   Autorisation

   GET /oauth/authorize, avec PKCE S256 obligatoire. La page de Prescriptio s'ouvre : la personne se connecte et accepte les portées demandées.

4. 4

   Jeton

   POST /oauth/token. La ressource canonique est https://prescriptio.fr/api/mcp. Le jeton est opaque et lié au compte ; le client le révoque par POST /oauth/revoke (RFC 7009), et la révocation vaut dès l'appel suivant. Vous pouvez aussi retirer l'accès vous-même : Paramètres › Accès IA › Gérer mes connexions, puis « Déconnecter cet accès » sur l'agent concerné ; ses jetons sont révoqués.

5. 5

   Appels

   Chaque appel porte l'en-tête Authorization: Bearer <jeton>, sur https://prescriptio.fr/api/mcp (MCP) ou https://prescriptio.fr/api/mcp/v1/{opération} (REST).

Les portées

Les écritures exigent une organisation : un outil qui écrit résout l'organisation de l'appelant à partir de son identité, jamais d'un paramètre, et n'agit que dans son périmètre. Un compte sans organisation reçoit un refus explicite.

Les offres

L'offre gratuite ne filtre pas les noms du registre général : à profil et portées identiques, les noms annoncés sont les mêmes. Cela ne garantit pas la réussite de chaque action. Les droits sur les objets, les conditions d'offre et les quotas restent contrôlés par les traitements. Le rapport de marque (marque_rapport) et l'envoi d'e-mails exigent notamment un accès payant ou offert admissible ; un domaine d'envoi personnalisé demande l'option e-mail. L'abonnement à 12 € HT par mois et par utilisateur, sans engagement, relève les plafonds d'appels et de dossiers.

Deux règles ne bougent pas, quelle que soit l'offre :

• Les coordonnées des fiches publiques (téléphone, e-mail, site) ne sortent par aucun outil.
• Chaque outil ne voit que l'espace du porteur du jeton.

Les quotas

Un appel compte pour une unité dans les deux compteurs d'appels, partagés entre le connecteur MCP et l'API REST.

• Une unité de dossier vaut un dossier pour la journée, quel que soit le nombre de pièces lues ou téléchargées dedans.
• Chercher n'en consomme aucune : la table des matières d'un dossier et la localisation d'un terme sont gratuites ; seule la restitution du texte ou d'un lien est décomptée.
• La fenêtre de 24 heures glisse : il n'y a pas de remise à zéro à minuit.
• Les outils d'aide et d'abonnement consomment aussi un appel. Ils ne contournent pas un quota d'appels atteint. Si vous souhaitez vous abonner dans ce cas, ouvrez directement Paramètres › Abonnement (s'ouvre dans un nouvel onglet) ; après un seul refus de consultation de dossier, le lien peut encore être obtenu s'il reste des appels.

Que faire quand un quota est atteint ?

Lisez le message. « Quota par minute atteint » est un frein passager : attendez le délai indiqué, puis reprenez. « Quota journalier atteint » et « Quota de consultation atteint » correspondent à deux compteurs différents ; l'abonnement relève leurs plafonds. Il reste lui-même soumis à des limites. L'analyse du rapport de marque demande aussi l'abonnement. Ne bouclez jamais sur un appel refusé.

Les limites techniques

Pour aller plus loin