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.
Add this URL to your conversational agent to give it access to Moulineuse tools.
https://mcp.code4code.eu/mcp
Exploratrice emploie son propre compte de service. Ce compte est distinct de votre connexion personnelle dans Pi, Claude ou un autre client MCP.
moulineuse:contribute profile moulineuse:read offline_access moulineuse:sql email moulineuse:scriptMinimal 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.
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ément | Durée actuelle | Conséquence pratique |
|---|---|---|
| Jeton d’accès JWT | 5 minutes | Le client doit le renouveler automatiquement. Aucun courriel ne devrait être nécessaire. |
| Session de renouvellement ordinaire | 30 minutes sans renouvellement, 10 heures au maximum | Aprè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_access | 30 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.
Moins persistante, adaptée à un appareil partagé ou temporaire.
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.
| Scope | Usage |
|---|---|
moulineuse:read | Lire les recettes, les schémas et les données publiques. |
moulineuse:sql | Exécuter des requêtes SQL en lecture seule. |
moulineuse:script | Exécuter les scripts autorisés dans le bac à sable. |
moulineuse:contribute | Proposer une nouvelle recette. |
offline_access | Conserver 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"
}
}
} /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.
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ôme | Cause probable | Action |
|---|---|---|
| La connexion tombe environ toutes les cinq minutes | Le 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 renouvellement | Session 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 pause | Session 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 redirection | L’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és | Dé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
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.
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
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
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
Liste les recettes internes disponibles sans charger leur contenu complet. Utile pour découvrir le corpus avant une recherche plus ciblée.
get_recipe
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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é.
