CLI et commandes

Le package @stratta/mcp est à la fois le serveur MCP et un petit CLI de configuration. Vous l’exécutez rarement directement (c’est votre client Claude qui le lance), mais ces commandes couvrent l’installation et l’authentification.

Ajouter à Claude Code#

claude mcp add stratta --scope user -- npx -y @stratta/mcp

--scope user enregistre le serveur pour votre utilisateur, donc dans tous vos projets. Sans cette option, la commande écrit dans la configuration du dossier courant et le serveur n’existe que là.

Raccourci : stratta#

Toutes les commandes passent par npx, mais une installation globale donne un nom plus court :

npm install -g @stratta/mcp

stratta doctor
stratta whoami

L’installation globale n’est utile que pour vous : votre agent lance le serveur par npx, et continue de fonctionner sans elle.

Se connecter#

npx -y @stratta/mcp login

Ouvre votre navigateur sur Stratta, où vous voyez quelle machine demande l’accès et pour quelle organisation, puis vous autorisez. La clé revient sur un port local éphémère lié à 127.0.0.1 et s’écrit dans ~/.stratta/config.json (accès propriétaire uniquement, mode 0600). Relancez la commande à tout moment pour remplacer la clé.

Sans navigateur#

npx -y @stratta/mcp login --paste

Attend une clé créée depuis Intégrations › Clés d’API, saisie masquée. Pour un poste géré ou une intégration continue, la clé peut aussi venir de l’environnement :

claude mcp add stratta --scope user --env STRATTA_API_KEY=sk_strt_xxx -- npx -y @stratta/mcp

Ajouter à Claude Desktop#

Après login, ajoutez le serveur à claude_desktop_config.json (Settings → Developer → Edit Config) :

{
  "mcpServers": {
    "stratta": {
      "command": "npx",
      "args": ["-y", "@stratta/mcp"]
    }
  }
}

Voir Installer dans Claude Desktop pour la procédure complète, y compris la conservation de la clé dans la configuration via un bloc env.

Installation globale (optionnelle)#

npm install -g @stratta/mcp

Référencez ensuite le binaire directement au lieu de npx :

{
  "mcpServers": {
    "stratta": {
      "command": "stratta-mcp"
    }
  }
}

Exécuter le serveur directement#

Pour des tests locaux uniquement (votre client Claude le fait normalement) :

npx -y @stratta/mcp

Il se connecte via stdio et journalise sur stderr (stdout est réservé au protocole MCP). Inspectez-le avec l’inspecteur MCP officiel :

npx @modelcontextprotocol/inspector npx -y @stratta/mcp

Mode simple et familles d’outils#

Par défaut le serveur local annonce ses 59 outils (mode complet), soit environ 67 000 caractères de schémas lus par l’agent à chaque conversation. Le mode simple n’en annonce que les 10 de lecture des normes (environ 11 000 caractères).

claude mcp add stratta --scope user -- npx -y @stratta/mcp --simple

Les familles : norms (toujours là : get_methodology, whoami, list_norms, get_toc, get_subtree, get_section, search_in_norm, search_corpus, get_cross_refs, get_figure), dossiers (dossiers, questions, décisions, pièces, modèles, livrables, méthodes du bureau), sites (fiche de site) et ingest (ingestion, en local seulement). Une famille inconnue est ignorée.

Quand choisir quoi. Le mode simple suffit à un agent qui lit des normes : moins de contexte consommé, des réponses plus rapides. Ajoutez dossiers ou sites quand vous travaillez sur un projet. Gardez le mode complet pour l’ingestion et si vous ne savez pas encore ce qu’il vous faut.

Pour le connecteur distant, le choix se fait sans ligne de commande : sur Intégrations, le menu Outils de chaque agent propose Tous les outils, Normes et dossiers, Normes et sites et Simple : normes seules. L’agent voit le changement à sa prochaine connexion. Seule la liste annoncée est filtrée : un appel à un outil masqué fonctionne encore.

Récapitulatif des commandes#

Liens connexes#