Skip to main content
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의 호스팅 서버와 동일한 코드에서 생성되므로, 도구·이름·동작이 서로 어긋나지 않아요.

설치 및 로그인

1

npm에서 설치

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

브라우저로 로그인

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

세션 확인

로그인한 사용자, 워크스페이스, 토큰 상태를 보여줘요.
로그인한 멤버는 워크스페이스의 소유자 또는 관리자여야 하며, 워크스페이스 요금제에 API 접근 권한이 포함되어 있어야 해요. 하나의 로그인은 하나의 워크스페이스에 연결되며, 전환하려면 scribe login를 다시 실행하세요.

MCP를 통해 로컬 에이전트에 제공하기

JSON으로 구성된 클라이언트(Claude Desktop, Cursor 등)의 경우:
에이전트가 로컬에서 실행되고 이미 로그인된 터미널 세션으로 도구 호출을 실행하려는 경우, 또는 클라이언트가 stdio만 지원하는 경우에는 호스팅된 엔드포인트 대신 CLI를 사용하세요. 호스팅된 엔드포인트(어시스턴트 연결 참고)는 웹의 Claude나 ChatGPT 같은 채팅 어시스턴트에 적합합니다.

셸에서 사용하기

결과는 stdout에 JSON으로 출력되고, 오류는 stderr에 읽기 쉬운 텍스트로 출력됩니다.
유용한 규칙:
  • scribe tools는 모든 MCP 도구와 해당 CLI 명령어를 나열하고, scribe call <tool_name> --json '{...}'는 정확한 MCP 이름으로 도구를 호출합니다.
  • 서명 콘텐츠 트리 같은 복잡한 필드는 인라인 JSON, @file, 또는 stdin용 -를 허용합니다. --json로 전체 인수 객체를 전달할 수 있으며, 명시적인 플래그가 이를 재정의합니다.
  • 불리언은 --flag / --no-flag이며, 둘 다 지정하지 않으면 필드가 생략되므로 부분 업데이트가 실수로 값을 덮어쓰지 않습니다.
  • 종료 코드: 0 성공, 1 API 또는 도구 오류, 2 사용법 오류, 3 로그인되지 않음.

영역별 명령어

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

SSH 환경에서 사용하기

로그인하려면 CLI를 실행 중인 컴퓨터에서 127.0.0.1에 접근할 수 있는 브라우저가 필요해요. 원격 컴퓨터에서는 콜백 포트를 포워딩하고 브라우저를 열지 않고 URL을 출력하도록 설정하세요:
그런 다음 출력된 URL을 로컬 브라우저에서 여세요.

다음 단계

도구 레퍼런스

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

스킬

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

문제 해결

연결 및 도구 문제 해결

API 레퍼런스

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