> ## 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.

# Vue d'ensemble du MCP

> Comment le serveur MCP Stratta s'authentifie, résout votre clé et expose ses outils.

Le serveur MCP Stratta (`@stratta/mcp`) connecte votre client Claude à votre espace de travail
Stratta. Il communique via le [Model Context Protocol](https://modelcontextprotocol.io) sur stdio
et expose **18 outils** : 8 pour lire les normes et 10 pour les ingérer.

|                  |                                                              |
| ---------------- | ------------------------------------------------------------ |
| Package          | [`@stratta/mcp`](https://www.npmjs.com/package/@stratta/mcp) |
| Binaire          | `stratta-mcp`                                                |
| Transport        | stdio                                                        |
| Runtime          | Node.js ≥ 20                                                 |
| Authentification | clé 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 :

<Steps>
  <Step title="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.
  </Step>

  <Step title="~/.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`) :

    ```json theme={null}
    { "apiKey": "sk_strt_xxx" }
    ```
  </Step>

  <Step title="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.
  </Step>
</Steps>

### Variables d'environnement

<ParamField path="STRATTA_API_KEY" type="string">
  Votre clé API depuis [stratta.ch/api-keys](https://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.
</ParamField>

<ParamField path="STRATTA_CONVEX_URL" type="string" default="Stratta production backend">
  Surcharge l'URL du backend. Nécessaire uniquement si vous auto-hébergez Stratta.
</ParamField>

## 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 :

<Steps>
  <Step title="get_methodology">
    Le premier appel obligatoire — charge la persona, les règles de navigation et le format de citation.
  </Step>

  <Step title="list_norms">
    Voir quelles normes sont disponibles dans votre espace de travail.
  </Step>

  <Step title="get_toc → get_subtree">
    Ouvrir la table des matières et explorer le chapitre pertinent.
  </Step>

  <Step title="get_section">
    Lire le contenu complet d'une section (texte, formules, tableaux, figures, références croisées).
  </Step>

  <Step title="get_cross_refs → get_section">
    Suivre les liens vers d'autres normes et les lire également, pour les questions composées.
  </Step>

  <Step title="get_figure">
    Récupérer un schéma lorsque la réponse en dépend.
  </Step>
</Steps>

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

<CardGroup cols={2}>
  <Card title="Outils de lecture" icon="book-open" href="/fr/mcp/read-tools">
    Les 8 outils que Claude utilise pour interroger les normes.
  </Card>

  <Card title="Outils d'ingestion" icon="file-arrow-up" href="/fr/mcp/ingestion-tools">
    Les 10 outils `ingest_*` qui écrivent les normes.
  </Card>
</CardGroup>