> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CLI di Scribe: le tue firme nel terminale e per gli agenti locali
> Installa la CLI di Scribe, accedi una volta e gestisci le firme dal terminale — oppure metti a disposizione ogni strumento di Scribe a un agente AI locale tramite MCP.
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 gli stessi strumenti del server MCP ospitato a qualsiasi agente in grado di lanciare un comando (Claude Code, Claude Desktop, Cursor e ogni client MCP stdio), eseguendo le azioni per tuo conto 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
Richiede Node.js 20 o versioni successive.
```bash theme={null}
npm install -g @scribemail/cli
```
```bash theme={null}
scribe login
```
Il browser si apre e accedi con il tuo account Scribe — nessuna chiave API da creare o incollare. Le credenziali vengono salvate in `~/.config/scribe/credentials.json` con permessi riservati al proprietario e si aggiornano automaticamente.
```bash theme={null}
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 alle API. Un accesso è associato a una sola area di lavoro — esegui di nuovo `scribe login` per cambiare.
## Servire un agente locale tramite MCP
```bash theme={null}
claude mcp add --scope user scribe -- scribe mcp
```
Per i client configurati con JSON (Claude Desktop, Cursor e altri):
```json theme={null}
{
"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](/it/ai-agents/connect)) 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.
```bash theme={null}
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 --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](/it/ai-agents/tools).
## 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:
```bash theme={null}
ssh -L 8976:127.0.0.1:8976 yourserver
scribe login --no-browser
```
Poi apri l'URL stampato nel tuo browser locale.
## Prossimi passi
Ogni strumento di Scribe, raggruppato per area
Fornisci al tuo assistente il workflow completo di Scribe
Risolvi problemi di connessione e degli strumenti
L'API REST dietro la CLI e il server MCP