CLI di Scribe: le tue firme nel terminale e per gli agenti locali

La CLI di Scribe (@scribemail/cli) porta l’intera superficie degli strumenti di Scribe sulla tua macchina. Ha due volti:

Un server MCP locale: scribe mcp mette a disposizione esattamente gli stessi strumenti del server MCP in hosting a qualsiasi agente in grado di avviare un comando (Claude Code, Claude Desktop, Cursor e qualsiasi client MCP stdio), eseguendosi con la tua identità dopo un unico accesso dal browser.
Una normale riga di comando: ogni strumento è anche un sottocomando (scribe signatures list, scribe campaigns schedule), con output JSON pensato per script e shell.

Entrambi sono generati dallo stesso codice del server ospitato su mcp.scribe-mail.com, quindi strumenti, nomi e comportamenti non divergono mai. La CLI è open source con licenza MIT. Leggi il codice, segui le release o segnala un problema su GitHub.

Installazione e accesso

Installare da npm

Richiede Node.js 20 o versioni successive.

npm install -g @scribemail/cli

Accedere dal browser

scribe login

Il browser si apre e accedi con il tuo account Scribe, senza chiavi API da creare o incollare. Le credenziali sono archiviate in ~/.config/scribe/credentials.json con permessi riservati al proprietario e vengono aggiornate automaticamente.

Verificare la sessione

scribe whoami

Mostra l’utente connesso, l’area di lavoro e lo stato del token.

Il membro connesso deve essere proprietario o amministratore dell’area di lavoro e il piano dell’area di lavoro deve includere l’accesso API. Un login è associato a una sola area di lavoro. Esegui di nuovo scribe login per cambiarla.

Avviare un agente locale su MCP

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

Per i client configurati con JSON (Claude Desktop, Cursor e altri):

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

Preferisci la CLI all’endpoint hosted quando l’agente gira in locale e vuoi che le chiamate agli strumenti vengano eseguite nella sessione del terminale già autenticata, o quando il client supporta solo stdio. L’endpoint hosted (vedi Connetti il tuo assistente) resta la scelta giusta per gli assistenti chat come Claude sul web e ChatGPT.

Usarla dalla shell

I risultati sono in formato JSON su stdout; gli errori sono testo leggibile su 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"

Convenzioni utili:

scribe tools elenca ogni strumento MCP e il relativo comando CLI; scribe call <tool_name> --json '{...}' chiama qualunque strumento con il suo nome MCP esatto.
I campi complessi, come gli alberi dei contenuti della firma, accettano JSON inline, @file o - per lo stdin. --json può fornire l’intero oggetto degli argomenti e i flag espliciti hanno la precedenza.
I booleani sono --flag / --no-flag; se li ometti entrambi, il campo non viene inviato, così gli aggiornamenti parziali non sovrascrivono mai valori per errore.
Codici di uscita: 0 operazione riuscita, 1 errore API o dello strumento, 2 errore d’uso, 3 non autenticato.

Comandi per area

Gruppo	Comandi
`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`
Livello principale	`workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback`
Sessione	`login` · `logout` · `whoami` · `mcp` · `tools` · `call`

Il comportamento specifico di ciascuno strumento è identico a quello degli strumenti MCP. Vedi il riferimento agli strumenti.

Lavorare tramite SSH

Per l’accesso serve un browser che possa raggiungere 127.0.0.1 sulla macchina che esegue la CLI. Su una macchina remota, inoltra la porta di callback e stampa l’URL invece di aprire un browser:

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

Poi apri l’URL stampato nel browser locale.

Prossimi passi

Riferimento agli strumenti

Tutti gli strumenti Scribe, raggruppati per area

Skill

Dai al tuo assistente il flusso di lavoro completo di Scribe

Risoluzione dei problemi

Risolvi i problemi di connessione e degli strumenti

Riferimento API

L’API REST alla base della CLI e del server MCP

Scribe MCP

Scribe AI agent

CLI di Scribe: le tue firme nel terminale e per gli agenti locali

Installazione e accesso

Avviare un agente locale su MCP

Usarla dalla shell

Comandi per area

Lavorare tramite SSH

Prossimi passi

Riferimento agli strumenti

Skill

Risoluzione dei problemi

Riferimento API

​Installazione e accesso

​Avviare un agente locale su MCP

​Usarla dalla shell

​Comandi per area

​Lavorare tramite SSH

​Prossimi passi

Riferimento agli strumenti

Skill

Risoluzione dei problemi

Riferimento API

Installazione e accesso

Avviare un agente locale su MCP

Usarla dalla shell

Comandi per area

Lavorare tramite SSH

Prossimi passi