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.

Installare e accedere

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 dover creare o incollare alcuna chiave API. Le credenziali vengono salvate in ~/.config/scribe/credentials.json con permessi accessibili solo al proprietario e si aggiornano automaticamente.

Verificare la sessione

scribe whoami

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

Il membro che ha effettuato l’accesso deve essere proprietario o amministratore dell’area di lavoro, e il piano dell’area di lavoro deve includere l’accesso all’API. Un accesso è associato a una sola area di lavoro. Esegui di nuovo scribe login per cambiare.

Servire un agente locale tramite 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 in cui hai già effettuato l’accesso, oppure quando il tuo client parla solo stdio. L’endpoint hosted (vedi Connettere l’assistente) resta la scelta giusta per assistenti di chat come Claude sul web e ChatGPT.

Usarla dalla shell

I risultati sono in 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 '{...}' richiama qualsiasi strumento tramite il suo nome MCP esatto.
I campi complessi come gli alberi dei contenuti della firma accettano JSON inline, @file o - per stdin. --json può fornire l’intero oggetto argomenti, e i flag espliciti hanno la precedenza.
I booleani sono --flag / --no-flag; lasciando entrambi off il campo viene omesso, quindi gli aggiornamenti parziali non sovrascrivono mai valori per errore.
Codici di uscita: 0 successo, 1 errore dell’API o dello strumento, 2 errore di utilizzo, 3 accesso non effettuato.

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

Il comportamento per singolo strumento è identico a quello degli strumenti MCP. Consulta il Riferimento degli strumenti.

Utilizzo tramite SSH

Per accedere 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 tuo browser locale.

Prossimi passi

Riferimento degli strumenti

Ogni strumento di Scribe, raggruppato per area

Skill

Fornisci al tuo assistente il workflow completo di Scribe

Risoluzione dei problemi

Risolvi problemi di connessione e degli strumenti

Riferimento API

L’API REST dietro la CLI e il server MCP

Getting started

Product FAQ

Industry

Departments

Company type

Climate

Affiliate

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

Installare e accedere

Servire un agente locale tramite MCP

Usarla dalla shell

Comandi per area

Utilizzo tramite SSH

Prossimi passi

Riferimento degli strumenti

Skill

Risoluzione dei problemi

Riferimento API

​Installare e accedere

​Servire un agente locale tramite MCP

​Usarla dalla shell

​Comandi per area

​Utilizzo tramite SSH

​Prossimi passi

Riferimento degli strumenti

Skill

Risoluzione dei problemi

Riferimento API

Installare e accedere

Servire un agente locale tramite MCP

Usarla dalla shell

Comandi per area

Utilizzo tramite SSH

Prossimi passi