Vue d'ensemble du MCP

Stratta se joint de deux façons. Les deux parlent le Model Context Protocol, lisent le même corpus et comptent le même quota ; seule change la façon de prouver qui vous êtes.

Le connecteur distant est le plus court, et le seul qui fonctionne dans un agent qui tourne dans le cloud, claude.ai par exemple. Voir Connecter un agent par le navigateur.

Le serveur local reste nécessaire pour un agent qui ne peut pas ouvrir de navigateur, et pour add_attachment, le seul outil qui lit un fichier sur votre disque. L'ingestion est servie aux deux : la pré-passe tourne sur la machine de l'agent, les écritures passent par le transport branché.

Authentification#

Chaque appel d'outil est authentifié. Le connecteur distant porte un jeton OAuth de courte durée ; le serveur local, une clé API. Stratta résout l'un ou l'autre vers votre utilisateur et votre organisation, et restreint toutes les lectures et écritures en conséquence. L'organisation est dérivée du justificatif validé. 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 continu en intégration.

2. ~/.stratta/config.json

   Écrit par npx -y @stratta/mcp login ou par l'invite au premier usage. Stocké avec accès 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#

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_corpus quand la norme elle-même est inconnue, et search_in_norm chaque fois que le chemin de section l'est.

Ressources et prompts#

Les deux transports servent quatre ressources stratta://, cloisonnées à votre espace comme les outils et hors quota : stratta://norms (JSON), stratta://methodology (Markdown), stratta://norm/{code}/toc (table des matières jusqu'à la profondeur 2, code encodé pour l'URL) et stratta://dossier/{id} (un dossier de projet en Markdown). Un client qui gère les ressources permet d'en épingler une à la conversation ; un agent peut la lire sans appel d'outil.

Le serveur local propose aussi trois prompts, affichés comme commandes dans les clients qui les gèrent : investigate-question, resume-dossier et check-value.

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, utilisant 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#