> ## 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.
# Scribe CLI: je handtekeningen in de terminal en lokale agents
> Installeer de Scribe CLI, meld je één keer aan en beheer handtekeningen vanuit je terminal — of stel elke Scribe-tool beschikbaar aan een lokale AI-agent via MCP.
De Scribe CLI (`@scribemail/cli`) brengt het volledige Scribe-toolaanbod naar je machine. Hij heeft twee gezichten:
* **Een lokale MCP-server** — `scribe mcp` biedt exact dezelfde tools als de gehoste MCP-server aan elke agent die een commando kan starten (Claude Code, Claude Desktop, Cursor en elke stdio-MCP-client), en draait onder jouw account na één browseraanmelding.
* **Een gewone commandoregel** — elke tool is ook een subcommando (`scribe signatures list`, `scribe campaigns schedule`), met JSON-uitvoer die is gemaakt voor scripts en shells.
Beide worden gegenereerd uit dezelfde code als de gehoste server op `mcp.scribe-mail.com`, waardoor de tools, namen en het gedrag nooit uit elkaar lopen.
## Installeren en aanmelden
Vereist Node.js 20 of nieuwer.
```bash theme={null}
npm install -g @scribemail/cli
```
```bash theme={null}
scribe login
```
Je browser wordt geopend en je meldt je aan met je Scribe-account — geen API-sleutel om aan te maken of te plakken. Inloggegevens worden opgeslagen in `~/.config/scribe/credentials.json` met rechten alleen voor de eigenaar en worden automatisch vernieuwd.
```bash theme={null}
scribe whoami
```
Toont de aangemelde gebruiker, Workspace en tokenstatus.
De aangemelde deelnemer moet **eigenaar of beheerder** van de Workspace zijn en het abonnement van de Workspace moet API-toegang bevatten. Eén login is gekoppeld aan één Workspace — voer `scribe login` opnieuw uit om te wisselen.
## Een lokale agent bedienen via MCP
```bash theme={null}
claude mcp add --scope user scribe -- scribe mcp
```
Voor clients die met JSON zijn geconfigureerd (Claude Desktop, Cursor en andere):
```json theme={null}
{
"mcpServers": {
"scribe": {
"command": "scribe",
"args": ["mcp"]
}
}
}
```
Kies voor de CLI in plaats van het gehoste eindpunt wanneer je agent lokaal draait en je wilt dat toolaanroepen worden uitgevoerd als je al aangemelde terminalsessie, of wanneer je client alleen stdio spreekt. Het gehoste eindpunt (zie [Verbind je assistent](/nl/ai-agents/connect)) blijft de juiste keuze voor chatassistenten zoals Claude op het web en ChatGPT.
## Gebruik vanaf de shell
Resultaten zijn JSON op stdout; fouten zijn leesbare tekst op 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"
```
Handige conventies:
* `scribe tools` geeft een lijst van elke MCP-tool en het bijbehorende CLI-commando; `scribe call --json '{...}'` roept elke tool aan met zijn exacte MCP-naam.
* Complexe velden zoals handtekening-content-trees accepteren inline JSON, `@file` of `-` voor stdin. `--json` kan het volledige arguments-object leveren, en expliciete vlaggen overschrijven dit.
* Booleans zijn `--flag` / `--no-flag`; beide weglaten laat het veld weg, zodat gedeeltelijke updates nooit per ongeluk waarden overschrijven.
* Exit-codes: `0` geslaagd, `1` API- of toolfout, `2` gebruiksfout, `3` niet aangemeld.
## Commando's per gebied
| Groep | Commando's |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `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` |
| Hoofdniveau | `workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback` |
| Sessie | `login` · `logout` · `whoami` · `mcp` · `tools` · `call` |
Het gedrag per tool is identiek aan dat van de MCP-tools — zie de [Tools-referentie](/nl/ai-agents/tools).
## Werken via SSH
Voor het aanmelden is een browser nodig die `127.0.0.1` kan bereiken op de machine waarop de CLI draait. Stuur op een externe machine de callback-poort door en print de URL in plaats van een browser te openen:
```bash theme={null}
ssh -L 8976:127.0.0.1:8976 yourserver
scribe login --no-browser
```
Open vervolgens de geprinte URL in je lokale browser.
## Volgende stappen
Alle Scribe-tools, gegroepeerd per gebied
Geef je assistent de volledige Scribe-workflow
Los verbindings- en toolproblemen op
De REST API achter de CLI en MCP-server