Skip to main content
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 localscribe mcp disponibiliza exatamente as mesmas ferramentas do servidor MCP hospedado para qualquer agente capaz de executar um comando (Claude Code, Claude Desktop, Cursor e qualquer cliente MCP stdio), rodando como você 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.

Instalar e entrar

1

Instalar do npm

Requer Node.js 20 ou superior.
2

Entrar pelo navegador

Seu navegador abre e você entra com sua conta Scribe — sem chave de API para criar ou colar. As credenciais ficam em ~/.config/scribe/credentials.json com permissões restritas ao proprietário e são renovadas automaticamente.
3

Verificar a sessão

Mostra o usuário logado, o espaço de trabalho e o estado do token.
O membro logado 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 corresponde a um espaço de trabalho — execute scribe login novamente para trocar.

Disponibilizar um agente local via MCP

Para clientes configurados com JSON (Claude Desktop, Cursor e outros):
Prefira a CLI ao endpoint hospedado quando seu agente roda localmente e você quer que as chamadas de ferramenta sejam executadas na sessão de terminal em que você já está autenticado, ou quando seu cliente só se comunica via stdio. O endpoint hospedado (veja Conectar seu assistente) continua sendo a escolha certa para assistentes de chat como Claude na web e ChatGPT.

Uso pelo shell

Os resultados são JSON no stdout; os erros são texto legível no stderr.
Convenções úteis:
  • scribe tools lista todas as ferramentas MCP e seus comandos de CLI; scribe call <tool_name> --json '{...}' chama qualquer ferramenta pelo nome MCP exato.
  • Campos complexos, como árvores de conteúdo de assinatura, aceitam JSON inline, @file ou - para stdin. --json pode fornecer todo o objeto de argumentos, e flags explícitas o sobrescrevem.
  • Booleanos são --flag / --no-flag; omitir os dois deixa o campo de fora, então atualizações parciais nunca sobrescrevem valores por engano.
  • Códigos de saída: 0 sucesso, 1 erro de API ou ferramenta, 2 erro de uso, 3 não autenticado.

Comandos por área

O comportamento por ferramenta é idêntico ao das ferramentas MCP — consulte a referência de ferramentas.

Uso via SSH

Para fazer login, é necessário 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 imprima a URL em vez de abrir um navegador:
Depois, abra a URL impressa no 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