CLI da Scribe: suas assinaturas no terminal e agentes locais

A CLI da Scribe (@scribemail/cli) traz toda a superfície de ferramentas da Scribe para sua máquina. Ela tem duas faces:

Um servidor MCP local: scribe mcp disponibiliza exatamente as mesmas ferramentas do servidor MCP hospedado para qualquer agente capaz de iniciar um comando (Claude Code, Claude Desktop, Cursor e qualquer cliente MCP stdio), executando em seu nome após um único login pelo navegador.
Uma linha de comando comum: cada ferramenta também é um subcomando (scribe signatures list, scribe campaigns schedule), com saída JSON pensada para scripts e shells.

Ambas são geradas a partir do mesmo código do servidor hospedado em mcp.scribe-mail.com, então as ferramentas, os nomes e o comportamento nunca divergem. A CLI é open source sob a licença MIT. Leia o código, acompanhe os releases ou abra uma issue no GitHub.

Instalar pelo npm

Requer Node.js 20 ou mais recente.

npm install -g @scribemail/cli

Fazer login pelo navegador

scribe login

Seu navegador abre e você faz login com sua conta Scribe, sem precisar criar nem colar uma chave de API. As credenciais ficam armazenadas em ~/.config/scribe/credentials.json com permissões exclusivas do proprietário e são renovadas automaticamente.

Verificar a sessão

scribe whoami

Mostra o usuário autenticado, o espaço de trabalho e o estado do token.

O membro autenticado precisa ser proprietário ou administrador do espaço de trabalho, e o plano do espaço de trabalho precisa incluir acesso à API. Um login está vinculado a um único espaço de trabalho. Execute scribe login novamente para alternar.

Executar um agente local via MCP

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

Para clientes configurados via JSON (Claude Desktop, Cursor e outros):

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

Prefira a CLI ao endpoint hospedado quando seu agente rodar localmente e você quiser que as chamadas de ferramentas usem a sessão de terminal já autenticada, ou quando seu cliente só suportar stdio. O endpoint hospedado (ver Conectar seu assistente) continua sendo a escolha certa para assistentes de chat como Claude na web e ChatGPT.

Usar pelo shell

Os resultados saem como JSON no stdout; os erros saem como texto legível no 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"

Convenções úteis:

scribe tools lista cada ferramenta MCP e seu comando CLI; scribe call <tool_name> --json '{...}' chama qualquer ferramenta pelo seu nome MCP exato.
Campos complexos como árvores de conteúdo de assinatura aceitam JSON inline, @file ou - para stdin. --json pode fornecer o objeto inteiro de argumentos, e flags explícitas prevalecem sobre ele.
Booleanos são --flag / --no-flag; deixar os dois de fora omite o campo, então atualizações parciais nunca sobrescrevem valores por acidente.
Códigos de saída: 0 sucesso, 1 erro de API ou ferramenta, 2 erro de uso, 3 não autenticado.

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`
Nível superior	`workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback`
Sessão	`login` · `logout` · `whoami` · `mcp` · `tools` · `call`

O comportamento por ferramenta é idêntico ao das ferramentas MCP. Veja a Referência de ferramentas.

Trabalhando por SSH

Para fazer login, é preciso um navegador que consiga acessar 127.0.0.1 na máquina que executa a CLI. Em uma máquina remota, encaminhe a porta de callback e exiba a URL em vez de abrir um navegador:

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

Em seguida, abra a URL exibida no seu navegador local.

Próximos passos

Referência de ferramentas

Todas as ferramentas da Scribe, agrupadas por área

Skills

Dê ao seu assistente o fluxo de trabalho completo da Scribe

Solução de problemas

Resolva problemas de conexão e de ferramentas

Referência da API

A API REST por trás da CLI e do servidor MCP

Scribe MCP

Scribe AI agent

CLI da Scribe: suas assinaturas no terminal e agentes locais

Executar um agente local via MCP

Usar pelo shell

Comandos por área

Trabalhando por SSH

Próximos passos

Referência de ferramentas

Skills

Solução de problemas

Referência da API

​Instalar e fazer login

​Executar um agente local via MCP

​Usar pelo shell

​Comandos por área

​Trabalhando por SSH

​Próximos passos

Referência de ferramentas

Skills

Solução de problemas

Referência da API

Instalar e fazer login

Executar um agente local via MCP

Usar pelo shell

Comandos por área

Trabalhando por SSH

Próximos passos