> ## 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: Ihre Signaturen im Terminal und lokale Agenten
> Installieren Sie das Scribe CLI, melden Sie sich einmal an und verwalten Sie Signaturen aus Ihrem Terminal — oder stellen Sie jedes Scribe-Tool einem lokalen KI-Agenten über MCP bereit.
Das Scribe CLI (`@scribemail/cli`) bringt die gesamte Scribe-Tool-Oberfläche auf Ihren Rechner. Es hat zwei Gesichter:
* **Ein lokaler MCP-Server** — `scribe mcp` stellt genau dieselben Tools wie der gehostete MCP-Server jedem Agenten bereit, der einen Befehl starten kann (Claude Code, Claude Desktop, Cursor und jeder stdio-MCP-Client), und läuft nach einer einzigen Browser-Anmeldung unter Ihrer Identität.
* **Eine reguläre Befehlszeile** — jedes Tool ist auch ein Unterbefehl (`scribe signatures list`, `scribe campaigns schedule`), mit JSON-Ausgabe für Skripte und Shells.
Beide werden aus demselben Code wie der gehostete Server unter `mcp.scribe-mail.com` generiert — Tools, Namen und Verhalten weichen also nie voneinander ab.
## Installieren und anmelden
Erfordert Node.js 20 oder neuer.
```bash theme={null}
npm install -g @scribemail/cli
```
```bash theme={null}
scribe login
```
Ihr Browser öffnet sich, und Sie melden sich mit Ihrem Scribe-Konto an — kein API-Schlüssel zum Erstellen oder Einfügen. Anmeldedaten werden in `~/.config/scribe/credentials.json` mit Berechtigungen ausschließlich für den Eigentümer gespeichert und automatisch aktualisiert.
```bash theme={null}
scribe whoami
```
Zeigt den angemeldeten Nutzer, den Workspace und den Token-Status an.
Das angemeldete Mitglied muss **Eigentümer oder Administrator** des Workspaces sein, und der Workspace-Tarif muss API-Zugriff enthalten. Eine Anmeldung ist an einen Workspace gebunden — führen Sie `scribe login` erneut aus, um zu wechseln.
## Lokalen Agenten über MCP bereitstellen
```bash theme={null}
claude mcp add --scope user scribe -- scribe mcp
```
Für Clients, die mit JSON konfiguriert werden (Claude Desktop, Cursor und andere):
```json theme={null}
{
"mcpServers": {
"scribe": {
"command": "scribe",
"args": ["mcp"]
}
}
}
```
Bevorzugen Sie die CLI gegenüber dem gehosteten Endpoint, wenn Ihr Agent lokal läuft und Tool-Aufrufe in Ihrer bereits angemeldeten Terminal-Session ausgeführt werden sollen, oder wenn Ihr Client nur stdio spricht. Der gehostete Endpoint (siehe [Assistent verbinden](/de/ai-agents/connect)) bleibt die richtige Wahl für Chat-Assistenten wie Claude im Web und ChatGPT.
## In der Shell verwenden
Ergebnisse werden als JSON auf stdout ausgegeben; Fehler als lesbarer Text auf 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"
```
Nützliche Konventionen:
* `scribe tools` listet jedes MCP-Tool und seinen CLI-Befehl auf; `scribe call --json '{...}'` ruft jedes Tool anhand seines exakten MCP-Namens auf.
* Komplexe Felder wie Signaturinhaltsbäume akzeptieren Inline-JSON, `@file` oder `-` für stdin. `--json` kann das gesamte Arguments-Objekt liefern, und explizite Flags überschreiben es.
* Boolesche Werte sind `--flag` / `--no-flag`; werden beide weggelassen, entfällt das Feld, sodass partielle Updates niemals versehentlich Werte überschreiben.
* Exit-Codes: `0` Erfolg, `1` API- oder Tool-Fehler, `2` Nutzungsfehler, `3` nicht angemeldet.
## Befehle nach Bereich
| Gruppe | Befehle |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `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` |
| Oberste Ebene | `workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback` |
| Session | `login` · `logout` · `whoami` · `mcp` · `tools` · `call` |
Das Verhalten pro Tool ist identisch mit den MCP-Tools — siehe [Tools-Referenz](/de/ai-agents/tools).
## Arbeiten über SSH
Für die Anmeldung wird ein Browser benötigt, der `127.0.0.1` auf dem Rechner erreichen kann, auf dem die CLI läuft. Auf einem Remote-Rechner leiten Sie den Callback-Port weiter und geben die URL aus, statt einen Browser zu öffnen:
```bash theme={null}
ssh -L 8976:127.0.0.1:8976 yourserver
scribe login --no-browser
```
Öffnen Sie dann die ausgegebene URL in Ihrem lokalen Browser.
## Nächste Schritte
Alle Scribe-Tools, nach Bereich gruppiert
Geben Sie Ihrem Assistenten den vollständigen Scribe-Workflow
Verbindungs- und Tool-Probleme beheben
Die REST-API hinter der CLI und dem MCP-Server