Aller au contenu principal

Test the Moulineuse MCP server

Browse the tools exposed by Moulineuse, test them with dedicated forms, and copy the server URL into your conversational agent.

MCP server URL

Add this URL to your conversational agent to give it access to Moulineuse tools.

https://mcp.code4code.eu/mcp
État technique d’Exploratrice

Exploratrice emploie son propre compte de service. Ce compte est distinct de votre connexion personnelle dans Pi, Claude ou un autre client MCP.

Add Moulineuse to your agent

Minimal configuration example for an HTTP MCP client.

{
  "mcpServers": {
    "moulineuse": {
      "transport": "http",
      "url": "https://mcp.code4code.eu/mcp"
    }
  }
}

Comprendre la connexion, sans connaître OAuth

Moulineuse ne reçoit jamais votre mot de passe. Lors de la première connexion, votre client ouvre une page de confiance de Code4Code. Après votre identification, il reçoit deux éléments qu’il doit conserver de façon sûre : un laissez-passer très court pour appeler Moulineuse et, normalement, un moyen de renouveler ce laissez-passer sans vous redemander un courriel.

1. Identification
Le navigateur vous conduit vers Code4Code. Un lien reçu par courriel permet de confirmer votre identité. Le mot de passe ou le lien ne passe pas par Moulineuse.
2. Autorisation
Code4Code remet au client un jeton d’accès limité dans le temps et les autorisations demandées. Le client appelle ensuite Moulineuse en votre nom.
3. Renouvellement
Avant l’expiration du jeton d’accès, un client compatible le renouvelle en arrière-plan. Une expiration toutes les cinq minutes ne doit donc pas provoquer un nouveau courriel.

Durées actuellement appliquées

Ces valeurs décrivent la configuration actuelle de l’instance publique Code4Code. Ce sont des choix d’exploitation, pas des durées imposées par le protocole : elles pourront évoluer. Un client doit toujours respecter la durée annoncée dans la réponse qu’il reçoit.

ÉlémentDurée actuelleConséquence pratique
Jeton d’accès JWT5 minutesLe client doit le renouveler automatiquement. Aucun courriel ne devrait être nécessaire.
Session de renouvellement ordinaire30 minutes sans renouvellement, 10 heures au maximumAprès 30 minutes sans activité de renouvellement, ou après 10 heures même si elle reste active, une nouvelle autorisation peut être nécessaire.
Session longue avec offline_access30 jours sans utilisation ; pas de maximum absolu configuréUne utilisation régulière peut rester autorisée durablement. Une révocation par l’utilisateur ou l’administrateur reste toujours possible.

Choisir entre une session ordinaire et une session longue

Une session ordinaire convient à un poste partagé ou à une utilisation ponctuelle. Sur votre ordinateur personnel correctement protégé, le scope offline_access permet au client de demander une session longue et évite généralement les réauthentifications quotidiennes.

Session ordinaire

Moins persistante, adaptée à un appareil partagé ou temporaire.

Le client utilise un jeton de renouvellement lié à la session Code4Code ordinaire. Une longue interruption ou la limite de dix heures conduit à une nouvelle autorisation dans le navigateur.
Session longue

Recommandée uniquement sur un appareil personnel de confiance.

Le client demande explicitement offline_access et conserve le jeton de renouvellement dans le trousseau sécurisé du système. Ce scope prolonge la session ; il n’accorde aucun accès supplémentaire aux données.

L’autorisation doit exister dans l’enregistrement du client et être demandée pendant la connexion. Le client doit vérifier qu’elle a réellement été accordée dans la réponse du serveur, sans simplement la supposer.

Autorisations disponibles

Une autorisation, appelée « scope », délimite ce que le client peut faire. Demandez seulement celles dont vous avez besoin.

ScopeUsage
moulineuse:readLire les recettes, les schémas et les données publiques.
moulineuse:sqlExécuter des requêtes SQL en lecture seule.
moulineuse:scriptExécuter les scripts autorisés dans le bac à sable.
moulineuse:contributeProposer une nouvelle recette.
offline_accessConserver une session longue ; ne donne accès à aucun outil supplémentaire.

Configuration conseillée pour Pi

L’exemple suivant demande une session longue, la lecture des recettes et le SQL en lecture seule. Ajoutez moulineuse:script ou moulineuse:contribute seulement si nécessaire. Placez cette entrée dans votre configuration MCP utilisateur ou utilisez le panneau /mcp de Pi.

{
  "mcpServers": {
    "moulineuse": {
      "auth": "oauth",
      "oauth": {
        "scope": "openid offline_access moulineuse:read moulineuse:sql"
      },
      "protocolVersion": "auto",
      "url": "https://mcp.code4code.eu/mcp"
    }
  }
}
Commandes de réparation

/mcp reconnect moulineuse — reconnecter avec les identifiants déjà conservés. C’est la première action à essayer.

/mcp-auth moulineuse — relancer l’autorisation dans le navigateur lorsqu’elle est nécessaire.

/mcp logout moulineuse — effacer les identifiants OAuth locaux et déconnecter le serveur. N’utiliser cette commande qu’en dernier recours, puis relancer /mcp-auth moulineuse.

Si votre entrée porte un autre nom, remplacez moulineuse dans les commandes par ce nom.

Pi distant ou sans navigateur

Ouvrez localement l’URL d’autorisation affichée par Pi. Si le navigateur n’arrive pas à joindre l’adresse localhost finale, copiez son URL complète depuis la barre d’adresse et collez-la dans le dialogue prévu par Pi.

Cette URL finale et son code sont sensibles et temporaires : ne les publiez pas et ne les réutilisez pas dans une autre session Pi.

Sur Linux sans interface graphique, Pi a besoin d’un service de trousseau Secret Service/libsecret déverrouillé. Une erreur de trousseau ne se répare pas en allongeant la durée des JWT.

La déconnexion automatique d’un serveur MCP inactif par Pi — dix minutes par défaut — économise des ressources. Elle est indépendante de la durée OAuth : Pi doit pouvoir se reconnecter avec les jetons conservés sans nouveau courriel.

Réparer une connexion

Commencez par relever le message exact et le moment où la panne survient. Ne transmettez jamais le jeton, le lien reçu par courriel, le code d’autorisation ou une URL de callback complète.

SymptômeCause probableAction
La connexion tombe environ toutes les cinq minutesLe client ne renouvelle pas le jeton d’accès ou ne conserve pas le jeton de renouvellement.Reconnecter, puis vérifier la prise en charge OAuth et le stockage sécurisé du client. Ne pas augmenter la durée du JWT pour masquer le problème.
401, invalid_token ou jeton expiréLe jeton court a expiré ; son renouvellement n’a pas encore eu lieu ou a échoué.Essayer d’abord une reconnexion simple. Si l’erreur revient, contrôler le jeton de renouvellement et le trousseau.
invalid_grant pendant le renouvellementSession expirée, jeton révoqué, déjà remplacé ou associé à un autre enregistrement de client.Relancer l’autorisation. Si le problème persiste, se déconnecter localement puis enregistrer et autoriser à nouveau le client.
Un nouveau courriel est demandé après chaque longue pauseSession ordinaire utilisée, ou offline_access demandé mais non accordé.Sur un appareil de confiance, ajouter offline_access, refaire l’autorisation et vérifier le scope réellement accordé.
insufficient_scope, outil absent ou refuséL’authentification fonctionne, mais l’autorisation requise manque.Ajouter uniquement le scope correspondant à l’outil, puis refaire l’autorisation. Ne pas demander tous les scopes par défaut.
Erreur de callback ou d’URI de redirectionL’adresse de retour choisie par le client ne correspond pas à son enregistrement OAuth.Conserver exactement l’hôte et le chemin attendus. Pour un client dynamique devenu incohérent, le réenregistrer plutôt que créer un motif générique permissif.
Trousseau indisponible ou verrouilléLe client refuse à juste titre de conserver les jetons en clair.Déverrouiller ou initialiser le trousseau du système, puis refaire l’autorisation. Ne pas placer le jeton dans la configuration MCP.
Audience, émetteur ou signature du jeton refusésDésaccord de configuration entre Code4Code et Moulineuse, et non simple expiration de session.Transmettre à l’exploitant le message et l’heure, sans le jeton. L’exploitant contrôle l’émetteur, l’audience et les clés publiques.
Contrôles non sensibles pour un agent conversationnel ou un exploitant

Ces requêtes vérifient le service et ses documents publics. Elles ne nécessitent et ne doivent contenir aucun jeton.

curl -fsS https://mcp.code4code.eu/health
curl -fsS https://mcp.code4code.eu/.well-known/oauth-protected-resource/mcp
curl -fsS https://mcp.code4code.eu/.well-known/oauth-authorization-server

Un agent doit ensuite demander le nom du client, le message d’erreur exact, le délai avant la panne et si un nouveau courriel a été requis. Il ne doit jamais demander un jeton, un code OAuth, un secret de client ou l’URL complète du callback.

Repères techniques pour les clients et les agents

Connexion d’une personne

Le client utilise le flux Authorization Code avec PKCE S256. Il découvre d’abord la ressource protégée, puis le serveur d’autorisation. Aucun secret partagé ne doit être installé dans une application publique ou un poste utilisateur.

Le client peut être préenregistré, identifié par un document public de métadonnées, ou enregistré dynamiquement. Dans ce dernier cas, offline_access doit être autorisé à l’enregistrement puis demandé lors de l’autorisation.

Connexion d’un service

Exploratrice utilise le flux client_credentials avec un compte technique confidentiel. Il n’y a ni personne, ni navigateur, ni jeton de renouvellement : Exploratrice redemande un jeton court avec son secret de service.

Ce mode ne doit pas être reproduit dans Pi ou une application installée chez l’utilisateur, car ces clients ne peuvent pas garder un secret collectif de manière fiable.

Moulineuse vérifie la signature, l’émetteur, l’audience, l’expiration et les scopes de chaque jeton. Code4Code fixe la durée des sessions et les autorisations accordables. Le client est responsable de demander les bons scopes, de conserver les jetons dans un stockage sécurisé et de les renouveler. Ces trois responsabilités ne doivent pas être confondues.

Paramètres exacts à contrôler côté serveur et côté client

Code4Code / Keycloak — durée des jetons et des sessions

  • Access Token Lifespan : 5 minutes ;
  • SSO Session Idle : 30 minutes ;
  • SSO Session Max : 10 heures ;
  • Offline Session Idle : 30 jours ;
  • Offline Session Max Limited : désactivé.

Des réglages propres à un client peuvent raccourcir les valeurs du realm. Ils sont donc à contrôler lorsqu’un seul logiciel est affecté.

Moulineuse — découverte et validation

MCP_AUTH_ISSUER, MCP_AUTH_TOKEN_ISSUER, MCP_AUTH_RESOURCE, MCP_AUTH_AUDIENCE, MCP_AUTH_JWKS_URL et les endpoints d’autorisation, de token et d’enregistrement indiquent à Moulineuse qui émet le jeton et comment le vérifier. Les variables MCP_AUTH_SCOPE_* nomment les scopes exigés. MCP_AUTH_SERVICE_DOCUMENTATION_URL publie cette page de secours. Ces paramètres ne fixent pas la durée des sessions.

Client MCP — demande et conservation

Contrôler la liste scope, le type de flux, l’URI de redirection, l’enregistrement préétabli, CIMD ou DCR, et le stockage sécurisé. Si plusieurs clients sont affectés de la même façon, le réglage du realm est suspect ; si un seul l’est, commencer par sa configuration et son trousseau.

Outils disponibles

Cette liste nécessite la connexion technique d’Exploratrice. La procédure de dépannage ci-dessus reste utilisable même si la liste ne charge pas.

get_legifrance_article

get_legifrance_article

Available

Retrouve les versions d’un article Légifrance à partir de l’identifiant du texte (`LEGITEXT…`, `JORFTEXT…`, `KALITEXT…` ou ELI) et de son numéro (`GN 1`, `L 123-4`), ou directement à partir d’un identifiant d’article (`LEGIARTI…`, `JORFARTI…`, `KALIARTI…`). Résout automatiquement le `cid` réellement porté par les articles, puis renvoie `{ texte, article, date, versions }` ; chaque version contient `id`, `num`, `date_debut`, `date_fin`, `etat` et `contenu` nettoyé. Avec un identifiant d’article, toutes les versions de ce numéro sont renvoyées ; si `texte` est aussi fourni, il doit correspondre au texte de l’article. À préférer à une requête `ILIKE` sur `legifrance.article` quand le texte et le numéro sont connus.

search_recipes

search_recipes

Available

Recherche dans les recettes internes, la base de connaissances des méthodes Tricoteuses. Retourne un extrait court, pas le contenu complet : utilise `get_recipe` pour lire une recette. Filtre avec `tags` pour restreindre à un domaine. À utiliser avant toute recherche Web pour les questions concernant Service-Public, Légifrance, l'Assemblée, le Sénat, le droit français ou la jurisprudence.

list_recipes

list_recipes

Available

Liste les recettes internes disponibles sans charger leur contenu complet. Utile pour découvrir le corpus avant une recherche plus ciblée.

get_recipe

get_recipe

Available

Récupère le contenu complet d’une recette précise. Lis la recette avant de choisir entre FTS, SQL ou script : elle contient souvent la stratégie la plus adaptée au besoin.

propose_recipe

propose_recipe

Available

Crée une demande de recette ou une proposition de pull request sur Forgejo pour enrichir la base de connaissances du projet.

get_assemblee_realtime_events

get_assemblee_realtime_events

Available

Lit les événements persistés du dérouleur public (`assemblee.derouleur_lignes`) et/ou d’Eliasse (`assemblee.eliasse_amendements`). Utilise `since` avec le `next_cursor` renvoyé pour reprendre après coupure ; avec `wait_ms`, l’appel attend un nouvel événement puis retourne sans garder une session infinie.

list_tables

list_tables

Available

Liste les tables et vues accessibles d’un schéma PostgreSQL de `canutes`. À utiliser seulement après les recettes, quand une exploration directe du schéma devient nécessaire.

describe_table

describe_table

Available

Décrit une table ou une vue accessible de `canutes`, y compris ses colonnes et, lorsqu’ils existent, ses contraintes, clés et index. À réserver à l’exploration du schéma après lecture des recettes utiles.

get_json_schemas

get_json_schemas

Available

Récupère les schémas JSON publiés qui documentent les champs `data` des schémas `annuaire`, `assemblee`, `droits_et_demarches`, `legifrance` et `senat`. Le schéma relationnel `tisseuse` s’explore avec `list_tables` et `describe_table`.

query_sql

query_sql

Available

Utilise cet outil après les recettes, quand il faut interroger directement `canutes`. Ajoute toujours une clause `LIMIT` pour borner le nombre de lignes. Les relations doivent toujours être qualifiées explicitement, par exemple `ameli.circular_version`, `annuaire.service`, `assemblee.acteurs`, `bofip.document_version`, `boss.document_version`, `europe.document_version`, `legifrance.article`, `parlement_europeen.deputes`, `traites_internationaux.traite`, `judilibre_api.confirmed_cass_links`, `tisseuse.article_lien_extrait` ou `transcriptions.current_segments`. Par défaut, `auto_truncate` tronque la réponse si elle dépasse la taille maximale ; ajoute une `LIMIT` adaptée plutôt que de désactiver la troncature.

query_typesense

query_typesense

Available

Exécute une recherche Typesense sur une collection arbitraire. Les recettes indiquent souvent si cette voie est préférable au SQL ; pour la recherche juridique courante, préfère `search_legal_texts`.

search_legal_texts

search_legal_texts

Available

Interroge l’alias Typesense `textes_juridiques_live` pour retrouver rapidement des textes juridiques et parlementaires indexés. L’ancien nom `textes_juridiques` est redirigé vers cet alias. La réponse est compacte (`found`, `hits` avec `text_id`, `type`, `badge` et `snippet`). Ne couvre que les textes indexés : pour un article Légifrance précis, préférer `get_legifrance_article` ; pour une recherche thématique, `search_articles_legifrance_semantic`.

search_amendements_semantic

search_amendements_semantic

Available

Retrouve les amendements de l’Assemblée nationale par proximité de sens (vecteurs BGE-M3, index HNSW dans `canutes`), sans exiger les mêmes mots que le texte des amendements. Couverture : L15, L16 et L17 jusqu’à la collecte du 4 août 2026. Pour une recherche par mots exacts ou par numéro, préférer `query_sql` sur `assemblee.amendements`.

search_articles_legifrance_semantic

search_articles_legifrance_semantic

Available

Retrouve les articles et textes Légifrance (LEGI) ainsi que les dossiers législatifs (DOLE) par proximité de sens (vecteurs BGE-M3, index HNSW dans `canutes`), sans exiger les mêmes mots que le contenu. Couverture : corpus LexMachine du 27 avril 2026. Pour une recherche par mots exacts, préférer `query_typesense` sur la collection `textes_juridiques`.

search_amendements_senat_semantic

search_amendements_senat_semantic

Available

Retrouve les amendements du Sénat par proximité de sens (vecteurs BGE-M3, index HNSW dans `canutes`), sans exiger les mêmes mots que le texte des amendements. Couverture : sessions 2001-2002 à 2025-2026, corpus LexMachine du 27 avril 2026. Pour une recherche par mots exacts ou par numéro, préférer `query_sql` sur `senat.ameli_amd`.

list_parlement_items

list_parlement_items

Available

Client HTTP read-only vers `parlement.tricoteuses.fr` pour les familles non encore disponibles directement dans Moulineuse : questions, débats/interventions, réunions/ODJ, HATVP, statistiques/métriques, liens d’amitié, participants de dossiers et paragraphes directs. Les alinéas/subdivisions et auteurs/cosignataires ne sont pas exposés ici.

get_parlement_item

get_parlement_item

Available

Client HTTP read-only vers `parlement.tricoteuses.fr` pour récupérer un détail ou un résumé IA autorisé. Les détails sont exposés pour questions, débats/interventions, réunions/ODJ, HATVP, statistiques/métriques, participants de dossiers et paragraphes directs ; les résumés pour questions, débats, participants de dossiers, amendements, documents et directs.

list_package_schemas

list_package_schemas

Available

Utilise cet outil seulement pour écrire un script. Il liste les symboles exportés par un package `@tricoteuses/*` afin de choisir quel type, constante ou fonction réutiliser.

get_package_symbol_json_schema

get_package_symbol_json_schema

Available

Utilise cet outil seulement pour écrire un script. Il génère le schéma JSON d’un symbole exporté par un package `@tricoteuses/*`.

get_typescript_types

get_typescript_types

Available

Utilise cet outil seulement pour écrire un script. Il récupère la définition TypeScript d’un type, d’une interface, d’une constante ou d’un autre symbole exporté par un package `@tricoteuses/*`.

get_symbol_source

get_symbol_source

Available

Utilise cet outil surtout pour écrire ou adapter un script. Il récupère le code source TypeScript d’un symbole exporté par un package `@tricoteuses/*` : fonction, constante, type ou interface. Il peut servir à reprendre une fonction existante et à l’adapter exactement au besoin.

run_script

run_script

Available

Utilise cet outil rarement, lorsque les recettes montrent qu’il faut mélanger FTS, SQL, Typesense, API Parlement, métadonnées de schéma, temps réel Assemblée et programmation, ou lorsqu’il faut appeler ou adapter des fonctions JavaScript ou TypeScript du projet Tricoteuses. Le script doit définir `async function agentTask(tricoteuses)` et utiliser l’API `tricoteuses` injectée.

add_links

add_links

Available

Ajoute des liens résolus via `@tricoteuses/tisseuse` dans un texte HTML ou Markdown. Les avertissements de résolution sont portés par des attributs `data-tisseuse-*` dans la sortie HTML uniquement ; `includeLinkDecisions` renvoie les décisions structurées pour les deux formats.

get_pastilled_article

get_pastilled_article

Available

Retourne un article, et si possible un alinéa pastillé, depuis un document Assemblée ou un texte Sénat. Pour l’Assemblée, fournir `documentUid` ou `sourceUrl` ; pour le Sénat, fournir `texteCode`, `texteId` ou `sourceUrl`. La réponse est un objet JSON `{ source, document, article, alinea, warnings }` : `article.html` contient le HTML pastillé et `alinea.html` l’extrait demandé.

fren