Scribe CLI : vos signatures dans le terminal et vos agents locaux

Le Scribe CLI (@scribemail/cli) met toute la surface d’outils Scribe sur votre machine. Il a deux visages :

Un serveur MCP local — scribe mcp expose exactement les mêmes outils que le serveur MCP hébergé à tout agent capable de lancer une commande (Claude Code, Claude Desktop, Cursor et tout client MCP stdio), en s’exécutant sous votre identité après une connexion unique dans le navigateur.
Une ligne de commande classique — chaque outil est aussi une sous-commande (scribe signatures list, scribe campaigns schedule), avec une sortie JSON pensée pour les scripts et les shells.

Les deux sont générés à partir du même code que le serveur hébergé sur mcp.scribe-mail.com, ce qui garantit que les outils, les noms et les comportements ne divergent jamais.

Installer et se connecter

Installer depuis npm

Nécessite Node.js 20 ou une version plus récente.

npm install -g @scribemail/cli

Se connecter avec votre navigateur

scribe login

Votre navigateur s’ouvre et vous vous connectez avec votre compte Scribe — aucune clé API à créer ni à coller. Les identifiants sont stockés dans ~/.config/scribe/credentials.json avec des permissions réservées au propriétaire et sont renouvelés automatiquement.

Vérifier la session

scribe whoami

Affiche l’utilisateur connecté, l’espace de travail et l’état du token.

Le membre connecté doit être propriétaire ou administrateur de l’espace de travail, et le forfait de l’espace de travail doit inclure l’accès à l’API. Une connexion est liée à un seul espace de travail — relancez scribe login pour en changer.

Exposer un agent local via MCP

claude mcp add --scope user scribe -- scribe mcp

Pour les clients configurés en JSON (Claude Desktop, Cursor et autres) :

{
  "mcpServers": {
    "scribe": {
      "command": "scribe",
      "args": ["mcp"]
    }
  }
}

Préférez la CLI à l’endpoint hébergé lorsque votre agent s’exécute localement et que vous voulez que les appels d’outils s’exécutent avec la session terminal déjà connectée, ou lorsque votre client ne parle que stdio. L’endpoint hébergé (voir Connecter votre assistant) reste le bon choix pour les assistants de chat comme Claude sur le web et ChatGPT.

Utilisation depuis le shell

Les résultats sont en JSON sur stdout ; les erreurs sont du texte lisible sur stderr.

scribe signatures list --limit 10
scribe signatures create --name "Sales" --draft-content @tree.json
scribe signatures publish --id 0c9f…
scribe teammates list --auto-paginate
scribe analytics views --start-date 2026-07-01 --end-date 2026-08-01 --group-by signature_template
scribe docs search "dns setup"

Conventions utiles :

scribe tools liste chaque outil MCP et sa commande CLI ; scribe call <tool_name> --json '{...}' appelle n’importe quel outil par son nom MCP exact.
Les champs complexes comme les arbres de contenu de signature acceptent du JSON en ligne, @file, ou - pour stdin. --json peut fournir l’objet d’arguments complet, et les flags explicites le remplacent.
Les booléens sont --flag / --no-flag ; laisser les deux inactifs omet le champ, ce qui évite qu’une mise à jour partielle n’écrase des valeurs par accident.
Codes de sortie : 0 succès, 1 erreur d’API ou d’outil, 2 erreur d’usage, 3 non connecté.

Commandes par domaine

Groupe	Commandes
`signatures`	`list` `create` `update` `delete` `publish` `install` `preview` `html` `installations`
`signatures variants`	`list` `update` `publish` `delete`
`signatures recipients`	`list` `add` `remove` `set-rules` `add-entities` `remove-entities`
`teammates`, `emails`, `smart-fields`, `folders`, `assets`	`list` `create` `update` `delete`
`campaigns`	`list` `create` `update` `delete` `preview` `schedule` `pause` `resume`
`analytics`	`views` `clicks` `events` `events-summary`
`visitors`	`list` `get` `breakdown`
`integrations`	`list` `entities`
Niveau supérieur	`workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback`
Session	`login` · `logout` · `whoami` · `mcp` · `tools` · `call`

Le comportement par outil est identique à celui des outils MCP — voir la référence des outils.

Utilisation via SSH

La connexion nécessite un navigateur capable d’atteindre 127.0.0.1 sur la machine qui exécute la CLI. Sur une machine distante, transférez le port de callback et affichez l’URL au lieu d’ouvrir un navigateur :

ssh -L 8976:127.0.0.1:8976 yourserver
scribe login --no-browser

Ouvrez ensuite l’URL affichée dans votre navigateur local.

Étapes suivantes

Référence des outils

Tous les outils Scribe, regroupés par domaine

Skills

Donnez à votre assistant le workflow Scribe complet

Dépannage

Résolvez les problèmes de connexion et d’outils

Référence de l'API

L’API REST derrière la CLI et le serveur MCP

Getting started

Product FAQ

Industry

Departments

Company type

Climate

Affiliate

Scribe CLI : vos signatures dans le terminal et vos agents locaux

Installer et se connecter

Exposer un agent local via MCP

Utilisation depuis le shell

Commandes par domaine

Utilisation via SSH

Étapes suivantes

Référence des outils

Skills

Dépannage

Référence de l'API

​Installer et se connecter

​Exposer un agent local via MCP

​Utilisation depuis le shell

​Commandes par domaine

​Utilisation via SSH

​Étapes suivantes

Référence des outils

Skills

Dépannage

Référence de l'API

Installer et se connecter

Exposer un agent local via MCP

Utilisation depuis le shell

Commandes par domaine

Utilisation via SSH

Étapes suivantes