Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.stratta.ch/llms.txt

Use this file to discover all available pages before exploring further.

Le serveur MCP Stratta (@stratta/mcp) connecte votre client Claude à votre espace de travail Stratta. Il communique via le Model Context Protocol sur stdio et expose 18 outils : 8 pour lire les normes et 10 pour les ingérer.
Package@stratta/mcp
Binairestratta-mcp
Transportstdio
RuntimeNode.js ≥ 20
Authentificationclé API (sk_strt_…)

​
Authentification

Chaque appel d’outil est authentifié avec votre clé API. Le serveur valide la clé auprès du backend Stratta, la résout vers votre utilisateur et votre organisation, et restreint toutes les lectures et écritures en conséquence. L’organisation est dérivée de la clé — elle n’est jamais un paramètre qu’un client peut définir.

​
Comment votre clé est résolue

Le serveur cherche votre clé dans cet ordre et utilise la première qu’il trouve :
1

Variable d'environnement STRATTA_API_KEY

Si elle est définie, elle a la priorité. Idéale pour un usage éphémère ou de type CI.
2

~/.stratta/config.json

Écrit par npx -y @stratta/mcp login ou par l’invite au premier usage. Stocké accessible au propriétaire uniquement (mode 0600) :
{ "apiKey": "sk_strt_xxx" }
3

Invite au premier usage (elicitation)

Si aucune clé n’est trouvée et que votre client le prend en charge, le serveur demande la clé au premier appel d’outil, la valide et l’enregistre dans le fichier de configuration.

​
Variables d’environnement

​
STRATTA_API_KEY
string
Votre clé API depuis stratta.ch/api-keys. Optionnelle : si elle n’est pas définie, le serveur se rabat sur ~/.stratta/config.json ou la demande au premier usage.
​
STRATTA_CONVEX_URL
string
défaut:"Stratta production backend"
Surcharge l’URL du backend. Nécessaire uniquement si vous auto-hébergez Stratta.

​
Comment Claude utilise les outils

Claude est guidé pour naviguer dans les normes dans un ordre déterministe, de sorte que chaque réponse soit étayée par une citation réelle :
1

get_methodology

Le premier appel obligatoire — charge la persona, les règles de navigation et le format de citation.
2

list_norms

Voir quelles normes sont disponibles dans votre espace de travail.
3

get_toc → get_subtree

Ouvrir la table des matières et explorer le chapitre pertinent.
4

get_section

Lire le contenu complet d’une section (texte, formules, tableaux, figures, références croisées).
5

get_cross_refs → get_section

Suivre les liens vers d’autres normes et les lire également, pour les questions composées.
6

get_figure

Récupérer un schéma lorsque la réponse en dépend.
Utilisez search_in_norm chaque fois que le chemin de section est inconnu.

​
Suivi de l’usage

Après chaque appel d’outil réussi, le serveur enregistre un événement d’usage (nom de l’outil, statut, durée) associé à votre clé. Cela alimente les statistiques de votre tableau de bord et la facturation future. Le suivi n’a lieu qu’après l’authentification et utilise la clé comme preuve de possession — l’usage ne peut pas être attribué à la clé de quelqu’un d’autre.

​
Référence des outils

Outils de lecture

Les 8 outils que Claude utilise pour interroger les normes.

Outils d'ingestion

Les 10 outils ingest_* qui écrivent les normes.