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 seule connexion via le navigateur.
Une ligne de commande classique : chaque outil est aussi une sous-commande (scribe signatures list, scribe campaigns schedule), avec une sortie JSON conçue 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. La CLI est open source sous licence MIT. Consultez le code, suivez les versions ou signalez un problème sur GitHub.

Installation et connexion

Installer depuis npm

Nécessite Node.js 20 ou plus récent.

npm install -g @scribemail/cli

Se connecter depuis le navigateur

scribe login

Votre navigateur s’ouvre et vous vous connectez avec votre compte Scribe, sans clé API à créer ou à 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 jeton.

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 API. Une connexion est liée à un seul espace de travail. Exécutez scribe login à nouveau pour changer.

Exécuter 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"]
    }
  }
}

Privilégiez la CLI plutôt que le point de terminaison hébergé lorsque votre agent s’exécute en local et que vous souhaitez que les appels d’outils s’exécutent dans votre session terminal déjà connectée, ou lorsque votre client ne communique qu’en stdio. Le point de terminaison hébergé (voir Connecter votre assistant) reste le bon choix pour les assistants conversationnels comme Claude sur le web et ChatGPT.

Utilisation depuis le shell

Les résultats sont retournés 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 arborescences de contenu de signature acceptent du JSON en ligne, @file ou - pour stdin. --json peut fournir l’objet d’arguments complet, et les options explicites le remplacent.
Les booléens sont --flag / --no-flag ; omettre les deux retire le champ, ce qui garantit que les mises à jour partielles n’écrasent jamais de valeurs par accident.
Codes de sortie : 0 succès, 1 erreur API ou outil, 2 erreur d’utilisation, 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 de chaque outil est identique à celui des outils MCP. Consultez 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 rappel 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

Scribe MCP

Scribe AI agent

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

Installation et connexion

Exécuter 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

​Installation et connexion

​Exécuter 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

Installation et connexion

Exécuter un agent local via MCP

Utilisation depuis le shell

Commandes par domaine

Utilisation via SSH

Étapes suivantes