Connecteur MCP et accès programmatique

Un compte gratuit suffit pour brancher le connecteur et chercher. Les outils que votre offre ne couvre pas ne sont pas seulement refusés : ils n’apparaissent pas dans tools/list, donc l’agent ne tente jamais un appel voué à l’échec.

1. 01

   Claude — web et application

   Connecteur distant, sans fichier. Dans les réglages, ouvrez Connecteurs, puis Ajouter un connecteur personnalisé. Collez l’URL du connecteur. La page de connexion Prescriptio s’ouvre, vous confirmez, c’est branché.

2. 02

   Cursor

   Le fichier ~/.cursor/mcp.json. Déclarez le serveur distant, relancez Cursor, puis autorisez à la première utilisation d’un outil.

3. 03

   Vérifier que ça répond

   Le premier appel à faire. Demandez l’aide intégrée : elle ne consomme aucun dossier, et confirme d’un coup que l’autorisation est passée et que les outils sont visibles.

https://prescriptio.fr/api/mcp

{
  "mcpServers": {
    "prescriptio": {
      "url": "https://prescriptio.fr/api/mcp"
    }
  }
}

Appelle prescriptio_aide et liste-moi les outils Prescriptio que tu vois, avec ceux qui écrivent.

Le connecteur s’appuie sur le mécanisme d’autorisation du protocole MCP. Un appel non authentifié répond 401 avec un en-tête WWW-Authenticate qui pointe la métadonnée de ressource ; le client enchaîne seul sur les deux documents de découverte, puis sur le flux OAuth. Rien de tout cela n’est à saisir à la main : ces deux URL existent pour que le client les trouve seul à partir de l’endpoint.

1. 01

   Métadonnée de ressource — /.well-known/oauth-protected-resource

   RFC 9728. Elle désigne le serveur d’autorisation, et accepte aussi le suffixe de chemin de la ressource : …/api/mcp.

2. 02

   Serveur d’autorisation — /.well-known/oauth-authorization-server

   RFC 8414. Points d’entrée d’autorisation, de jeton et d’enregistrement client.

3. 03

   Le jeton est lié à votre compte

   Révocable à tout instant depuis vos paramètres. Aucun compte de service, aucun secret partagé entre utilisateurs d’une même organisation.

4. 04

   L’offre est relue à chaque appel

   Jamais figée au moment de la connexion : un changement d’offre prend effet sur l’appel suivant, sans reconnecter le client.

5. 05

   Les écritures exigent une organisation

   Les huit outils d’écriture résolvent l’organisation de l’appelant et n’agissent que dans son périmètre. Un compte non rattaché reçoit un refus explicite.

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

1. 01

   Géographie — une seule granularité

   localisation.region couvre tous ses départements en un appel : ne jamais les énumérer. localisation.dept prend deux chiffres, ou 2A et 2B. localisation.commune prend un nom de commune ; Paris, Lyon et Marseille agrègent tous leurs arrondissements. National = omettre localisation : sur dept, les valeurs all et france sont refusées.

2. 02

   Une requête, un sujet

   Le plein texte exige tous les mots de la requête. Deux thèmes dans un même query ne renvoient presque rien : deux appels, puis fusion côté agent. Ainsi query: BIM géomètre ne rend presque aucun résultat, là où query: BIM puis query: géomètre fonctionnent.

3. 03

   Deux modes par outil

   liste prend une requête en langage naturel plus des filtres, et rend une liste paginée. fiche prend un identifiant, UUID, SIRET, code INSEE ou pv_id, et rend le détail structuré. Jamais un dump brut.

4. 04

   Ne rien inventer

   Trois garde-fous que le serveur transmet à l’agent avec la liste des outils, et que la doc reprend telle quelle. Ne jamais fabriquer une adresse de téléchargement. « Dossier consultable » = lisible via prescriptio_dce, pas le lien vers la plateforme de l’acheteur. Citer les identifiants renvoyés : SIREN, SIRET, marche_id, référence DECP.

Trois groupes : quatorze outils de lecture ouverts dès l’offre gratuite, trois lectures réservées à l’offre payante, et huit écritures qui n’agissent que dans votre espace et exigent une organisation.

1. 01

   Ce qu’une unité de dossier recouvre

   Une unité vaut un dossier par 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 et la localisation d’un terme sont gratuites, seule la restitution de texte ou d’un lien décompte. En revanche chaque appel, recherche comprise, compte dans les deux plafonds par minute et par jour.

2. 02

   Distinguer les deux refus

   Quota par minute atteint. Reessaye dans 60s. est un throttle passager : attendre et reprendre, sans proposer l’offre payante. Quota journalier atteint. est l’autre cas, celui où l’offre payante est la réponse pertinente.

1. 01

   API REST publique

   Pas encore ouverte. Elle suivra. Aucune date annoncée à ce jour.

2. 02

   Webhooks sortants

   Prévus également. En attendant, les alertes se consultent dans l’application.

3. 03

   En attendant, MCP couvre les mêmes besoins

   Un serveur MCP est interrogeable par n’importe quel client parlant JSON-RPC 2.0 sur HTTP, pas seulement par un assistant conversationnel. Les mêmes vingt-cinq outils, les mêmes schémas d’entrée, la même autorisation OAuth : un script, une tâche planifiée ou un service applicatif peuvent s’y brancher comme le ferait un agent. Trois méthodes suffisent : initialize, tools/list, tools/call.

Douze sources publiques françaises sous Licence Étalab 2.0, hébergées en France : BOAMP, JOUE, PLACE, DECP, SIRENE, RNE, RGE, Sitadel, DVF, BODACC, dossiers de consultation, délibérations de conseils municipaux. Aucune donnée confidentielle, aucune coordonnée personnelle.

1. 01

   Un nom, un endpoint, un préfixe

   Identité canonique. Tous les outils portent le préfixe prescriptio_ et un nom stable : ils sont citables tels quels dans une recommandation, et le resteront.

2. 02

   Le serveur explique son usage

   Auto-description. La réponse à tools/list transporte les instructions du serveur : quel outil pour quel besoin, les règles de géographie, et les garde-fous anti-invention. Un agent n’a rien à deviner.

3. 03

   Un outil pour lever un doute

   Aide en ligne. prescriptio_aide est en tête de liste et gratuit. Cinq sujets détaillés, aucune unité de dossier consommée.

4. 04

   Dix skills métiers téléchargeables

   Compétences prêtes. Un fichier par métier, que l’agent charge seul quand la demande y correspond : il sait alors quels outils appeler et dans quel ordre.