Scribe CLI: tus firmas en la terminal y agentes locales

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 desde el navegador.
Una línea de comandos convencional: 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. La CLI es de código abierto bajo licencia MIT. Lee el código, sigue las versiones o informa de un problema en GitHub.

Instalar e iniciar sesión

Instalar desde npm

Requiere Node.js 20 o superior.

npm install -g @scribemail/cli

Iniciar sesión desde el navegador

scribe login

Se abre tu navegador e inicias sesión con tu cuenta de Scribe, sin ninguna clave de API que crear ni pegar. Las credenciales se almacenan en ~/.config/scribe/credentials.json con permisos exclusivos del propietario y se renuevan automáticamente.

Comprobar la sesión

scribe whoami

Muestra el usuario conectado, el espacio de trabajo y el estado del token.

El miembro conectado 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 único espacio de trabajo. Ejecuta de nuevo scribe login para cambiar.

Servir un agente local vía MCP

claude mcp add --scope user scribe -- scribe mcp

Para clientes configurados mediante JSON (Claude Desktop, Cursor y otros):

{
  "mcpServers": {
    "scribe": {
      "command": "scribe",
      "args": ["mcp"]
    }
  }
}

Prefiere la CLI al endpoint alojado cuando tu agente se ejecute en local y quieras que las llamadas a herramientas corran bajo tu sesión de terminal ya autenticada, o cuando tu cliente solo hable stdio. El endpoint alojado (consulta Conectar tu asistente) sigue siendo la opción adecuada para asistentes de chat como Claude en la web y ChatGPT.

Usarla desde la terminal

Los resultados se devuelven como JSON en stdout; los errores, como texto legible en 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"

Convenciones útiles:

scribe tools lista todas las herramientas MCP y su comando CLI; scribe call <tool_name> --json '{...}' invoca 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 proporcionar el objeto de argumentos completo, y los flags explícitos lo sobrescriben.
Los booleanos son --flag / --no-flag; si no se indica ninguno, el campo se omite, de modo que las actualizaciones parciales nunca sobrescriben valores por accidente.
Códigos de salida: 0 éxito, 1 error de la API o de la herramienta, 2 error de uso, 3 sesión no 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.

Trabajar por SSH

Para iniciar sesión se necesita un navegador que pueda acceder a 127.0.0.1 en la máquina donde se ejecuta la CLI. En una máquina remota, redirige el puerto de retorno e imprime la URL en lugar de abrir un navegador:

ssh -L 8976:127.0.0.1:8976 yourserver
scribe login --no-browser

Después, abre la URL impresa en tu navegador local.

Próximos pasos

Referencia de herramientas

Todas las herramientas de Scribe, agrupadas por área

Habilidades

Dale a tu asistente el flujo de trabajo completo de Scribe

Resolución de problemas

Resuelve problemas de conexión y de herramientas

Referencia de la API

La REST API que hay detrás de la CLI y del servidor MCP

Scribe MCP

Scribe AI agent

Scribe CLI: tus firmas en la terminal y agentes locales

Instalar e iniciar sesión

Servir un agente local vía MCP

Usarla desde la terminal

Comandos por área

Trabajar por SSH

Próximos pasos

Referencia de herramientas

Habilidades

Resolución de problemas

Referencia de la API

​Instalar e iniciar sesión

​Servir un agente local vía MCP

​Usarla desde la terminal

​Comandos por área

​Trabajar por SSH

​Próximos pasos

Referencia de herramientas

Habilidades

Resolución de problemas

Referencia de la API

Instalar e iniciar sesión

Servir un agente local vía MCP

Usarla desde la terminal

Comandos por área

Trabajar por SSH

Próximos pasos