> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Scribe CLI를 설치하고 한 번만 로그인하면 터미널에서 서명을 관리하거나, MCP를 통해 모든 Scribe 도구를 로컬 AI 에이전트에 제공할 수 있어요.

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

## 설치 및 로그인

<Steps>
  <Step title="npm에서 설치">
    Node.js 20 이상이 필요해요.

    ```bash theme={null}
    npm install -g @scribemail/cli
    ```
  </Step>

  <Step title="브라우저로 로그인">
    ```bash theme={null}
    scribe login
    ```

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

  <Step title="세션 확인">
    ```bash theme={null}
    scribe whoami
    ```

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

<Note>
  로그인한 멤버는 워크스페이스의 **소유자 또는 관리자**여야 하며, 워크스페이스 요금제에 API 접근 권한이 포함되어 있어야 해요. 하나의 로그인은 하나의 워크스페이스에 연결되며, 전환하려면 `scribe login`를 다시 실행하세요.
</Note>

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

```bash theme={null}
claude mcp add --scope user scribe -- scribe mcp
```

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

```json theme={null}
{
  "mcpServers": {
    "scribe": {
      "command": "scribe",
      "args": ["mcp"]
    }
  }
}
```

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

## 셸에서 사용하기

결과는 stdout에 JSON으로 출력되고, 오류는 stderr에 읽기 쉬운 텍스트로 출력됩니다.

```bash theme={null}
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 도구와 동일해요 — [도구 레퍼런스](/ko/ai-agents/tools)를 참고하세요.

## SSH 환경에서 사용하기

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

```bash theme={null}
ssh -L 8976:127.0.0.1:8976 yourserver
scribe login --no-browser
```

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

## 다음 단계

<CardGroup cols={2}>
  <Card title="도구 레퍼런스" icon="wrench" href="/ko/ai-agents/tools">
    영역별로 정리된 모든 Scribe 도구
  </Card>

  <Card title="스킬" icon="book" href="/ko/ai-agents/skills">
    어시스턴트에게 Scribe 워크플로 전체를 제공
  </Card>

  <Card title="문제 해결" icon="bug" href="/ko/ai-agents/troubleshooting">
    연결 및 도구 문제 해결
  </Card>

  <Card title="API 레퍼런스" icon="code" href="/api-reference/introduction">
    CLI와 MCP 서버를 뒷받침하는 REST API
  </Card>
</CardGroup>