> ## 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: tus firmas en la terminal y agentes locales
> Instala la CLI de Scribe, inicia sesión una vez y gestiona firmas desde tu terminal — o expón todas las herramientas de Scribe a un agente de IA local a través de MCP.
La CLI de Scribe (`@scribemail/cli`) trae toda la superficie de herramientas de Scribe a tu máquina. Tiene dos caras:
* **Un servidor MCP local** — `scribe mcp` expone exactamente las mismas herramientas que el servidor MCP alojado a cualquier agente capaz de lanzar un comando (Claude Code, Claude Desktop, Cursor y cualquier cliente MCP por stdio), ejecutándose con tu identidad tras un único inicio de sesión en el navegador.
* **Una línea de comandos clásica** — cada herramienta es también un subcomando (`scribe signatures list`, `scribe campaigns schedule`), con salida JSON pensada para scripts y shells.
Ambas se generan a partir del mismo código que el servidor alojado en `mcp.scribe-mail.com`, por lo que las herramientas, los nombres y el comportamiento nunca divergen.
## Instalar e iniciar sesión
Requiere Node.js 20 o superior.
```bash theme={null}
npm install -g @scribemail/cli
```
```bash theme={null}
scribe login
```
Se abre tu navegador e inicias sesión con tu cuenta de Scribe — sin claves de API que crear ni pegar. Las credenciales se guardan en `~/.config/scribe/credentials.json` con permisos exclusivos del propietario y se renuevan automáticamente.
```bash theme={null}
scribe whoami
```
Muestra el usuario con sesión iniciada, el espacio de trabajo y el estado del token.
El miembro con sesión iniciada debe ser **propietario o administrador** del espacio de trabajo, y el plan del espacio de trabajo debe incluir acceso a la API. Un inicio de sesión está vinculado a un solo espacio de trabajo — vuelve a ejecutar `scribe login` para cambiar.
## Exponer un agente local a través de MCP
```bash theme={null}
claude mcp add --scope user scribe -- scribe mcp
```
Para clientes configurados con JSON (Claude Desktop, Cursor y otros):
```json theme={null}
{
"mcpServers": {
"scribe": {
"command": "scribe",
"args": ["mcp"]
}
}
}
```
Prefiere la CLI al endpoint alojado cuando tu agente se ejecuta localmente y quieres que las llamadas a herramientas se ejecuten como tu sesión de terminal ya autenticada, o cuando tu cliente solo habla stdio. El endpoint alojado (consulta [Conecta tu asistente](/es/ai-agents/connect)) sigue siendo la opción adecuada para asistentes de chat como Claude en la web y ChatGPT.
## Uso desde el shell
Los resultados son JSON por stdout; los errores son texto legible por 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"
```
Convenciones útiles:
* `scribe tools` lista todas las herramientas MCP y su comando CLI; `scribe call --json '{...}'` llama a cualquier herramienta por su nombre MCP exacto.
* Los campos complejos, como los árboles de contenido de firma, aceptan JSON en línea, `@file` o `-` para stdin. `--json` puede suministrar el objeto de argumentos completo, y las flags explícitas lo sobrescriben.
* Los booleanos son `--flag` / `--no-flag`; dejar ambos desactivados omite el campo, de modo que las actualizaciones parciales nunca sobrescriben valores por accidente.
* Códigos de salida: `0` éxito, `1` error de API o herramienta, `2` error de uso, `3` sin sesión iniciada.
## Comandos por área
| Grupo | Comandos |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `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` |
| Nivel superior | `workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback` |
| Sesión | `login` · `logout` · `whoami` · `mcp` · `tools` · `call` |
El comportamiento por herramienta es idéntico al de las herramientas MCP: consulta la [referencia de herramientas](/es/ai-agents/tools).
## Uso a través de SSH
Iniciar sesión requiere un navegador que pueda acceder a `127.0.0.1` en la máquina que ejecuta el CLI. En una máquina remota, redirige el puerto de callback e imprime la URL en lugar de abrir un navegador:
```bash theme={null}
ssh -L 8976:127.0.0.1:8976 yourserver
scribe login --no-browser
```
Luego abre la URL impresa en tu navegador local.
## Siguientes pasos
Todas las herramientas de Scribe, agrupadas por área
Dale a tu asistente el flujo completo de Scribe
Resuelve problemas de conexión y de herramientas
La API REST detrás del CLI y del servidor MCP