Scribe CLI: 터미널과 로컬 에이전트에서 사용하는 서명

Scribe CLI(@scribemail/cli)는 Scribe의 모든 도구를 사용자의 머신에서 사용할 수 있게 해줘요. 두 가지 방식으로 동작해요:

로컬 MCP 서버: scribe mcp는 호스팅된 MCP 서버와 완전히 동일한 도구를, 명령을 실행할 수 있는 모든 에이전트(Claude Code, Claude Desktop, Cursor 및 모든 stdio MCP 클라이언트)에 제공해요. 브라우저에서 한 번 로그인하면 사용자 권한으로 실행돼요.
일반 커맨드 라인: 모든 도구는 서브커맨드(scribe signatures list, scribe campaigns schedule)로도 제공되며, 스크립트와 셸에 최적화된 JSON 출력을 지원해요.

두 방식 모두 mcp.scribe-mail.com의 호스팅 서버와 동일한 코드에서 생성되므로, 도구·이름·동작이 서로 어긋나지 않아요. CLI는 MIT 라이선스로 공개된 오픈 소스입니다. 코드를 확인하거나 릴리스를 확인하거나, 이슈를 보고하려면 GitHub에서 할 수 있어요.

설치 및 로그인

Install from npm

Node.js 20 이상이 필요해요.

npm install -g @scribemail/cli

scribe login

브라우저가 열리고 Scribe 계정으로 로그인해요. API 키를 만들거나 붙여넣을 필요가 없어요. 자격 증명은 ~/.config/scribe/credentials.json에 소유자 전용 권한으로 저장되고 자동으로 갱신돼요.

Check the session

scribe whoami

로그인한 사용자, 워크스페이스, 토큰 상태를 보여줘요.

로그인한 멤버는 워크스페이스의 소유자 또는 관리자여야 하며, 워크스페이스 요금제에 API 액세스가 포함되어 있어야 해요. 하나의 로그인은 하나의 워크스페이스에 연결돼요. 전환하려면 scribe login을(를) 다시 실행하세요.

MCP로 로컬 에이전트 제공

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

JSON으로 구성된 클라이언트(Claude Desktop, Cursor 등)용:

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

에이전트가 로컬에서 실행되고 이미 로그인된 터미널 세션으로 도구 호출을 실행하고 싶거나, 클라이언트가 stdio만 지원하는 경우에는 호스팅 엔드포인트보다 CLI를 사용하세요. 호스팅 엔드포인트(Connect your assistant 참고)는 웹의 Claude나 ChatGPT 같은 챗 어시스턴트에 적합해요.

셸에서 사용하기

결과는 stdout에 JSON으로, 오류는 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"

유용한 규칙:

scribe tools는 모든 MCP 도구와 해당 CLI 명령을 나열하고, scribe call <tool_name> --json '{...}'는 정확한 MCP 이름으로 모든 도구를 호출해요.
서명 콘텐츠 트리와 같은 복잡한 필드는 인라인 JSON, @file, 또는 stdin용 -를 지원해요. --json는 전체 인수 객체를 제공할 수 있고, 명시적 플래그가 이를 재정의해요.
불리언은 --flag / --no-flag예요. 둘 다 지정하지 않으면 해당 필드가 생략되므로 부분 업데이트가 실수로 값을 덮어쓰지 않아요.
종료 코드: 0는 성공, 1는 API 또는 도구 오류, 2는 사용법 오류, 3는 로그인되지 않음을 나타내요.

영역별 명령어

그룹	명령어
`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`
최상위	`workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback`
세션	`login` · `logout` · `whoami` · `mcp` · `tools` · `call`

도구별 동작은 MCP 도구와 동일해요. 도구 레퍼런스를 참고하세요.

SSH로 작업하기

로그인하려면 CLI를 실행 중인 머신에서 127.0.0.1에 접근할 수 있는 브라우저가 필요해요. 원격 머신에서는 콜백 포트를 포워딩하고 브라우저를 열지 않고 URL을 출력하세요:

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

그런 다음 출력된 URL을 로컬 브라우저에서 여세요.

다음 단계

도구 레퍼런스

영역별로 정리된 모든 Scribe 도구

스킬

어시스턴트에 Scribe 워크플로 전체를 제공하세요

문제 해결

연결 및 도구 문제 해결

API 레퍼런스

CLI와 MCP 서버를 뒷받침하는 REST API

Scribe MCP

Scribe AI agent

Scribe CLI: 터미널과 로컬 에이전트에서 사용하는 서명

설치 및 로그인

MCP로 로컬 에이전트 제공

셸에서 사용하기

영역별 명령어

SSH로 작업하기

다음 단계

도구 레퍼런스

스킬

문제 해결

API 레퍼런스

​설치 및 로그인

​MCP로 로컬 에이전트 제공

​셸에서 사용하기

​영역별 명령어

​SSH로 작업하기

​다음 단계

도구 레퍼런스

스킬

문제 해결

API 레퍼런스

설치 및 로그인

MCP로 로컬 에이전트 제공

셸에서 사용하기

영역별 명령어

SSH로 작업하기

다음 단계