> ## 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: tanda tangan Anda di terminal dan agen lokal

> Instal Scribe CLI, masuk sekali, dan kelola tanda tangan dari terminal Anda — atau sajikan setiap tool Scribe ke agen AI lokal melalui MCP.

Scribe CLI (`@scribemail/cli`) menghadirkan seluruh permukaan tool Scribe ke mesin Anda. CLI ini memiliki dua wajah:

* **Server MCP lokal** — `scribe mcp` menyajikan tool yang persis sama dengan server MCP hosted ke agen mana pun yang dapat menjalankan perintah (Claude Code, Claude Desktop, Cursor, dan klien MCP stdio mana pun), berjalan atas nama Anda setelah satu kali sign-in di browser.
* **Command line biasa** — setiap tool juga tersedia sebagai subcommand (`scribe signatures list`, `scribe campaigns schedule`), dengan output JSON yang dirancang untuk skrip dan shell.

Keduanya dihasilkan dari kode yang sama dengan server hosted di `mcp.scribe-mail.com`, sehingga tool, nama, dan perilakunya tidak pernah berbeda.

## Instal dan masuk

<Steps>
  <Step title="Instal dari npm">
    Membutuhkan Node.js 20 atau lebih baru.

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

  <Step title="Masuk melalui browser">
    ```bash theme={null}
    scribe login
    ```

    Browser Anda terbuka dan Anda masuk dengan akun Scribe — tanpa perlu membuat atau menempelkan API key. Kredensial disimpan di `~/.config/scribe/credentials.json` dengan izin khusus pemilik dan diperbarui secara otomatis.
  </Step>

  <Step title="Periksa sesi">
    ```bash theme={null}
    scribe whoami
    ```

    Menampilkan pengguna yang masuk, ruang kerja, dan status token.
  </Step>
</Steps>

<Note>
  Anggota yang masuk harus berstatus **owner atau admin** ruang kerja, dan paket ruang kerja harus mencakup akses API. Satu login terikat ke satu ruang kerja — jalankan `scribe login` lagi untuk berpindah.
</Note>

## Sajikan agen lokal melalui MCP

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

Untuk klien yang dikonfigurasi dengan JSON (Claude Desktop, Cursor, dan lainnya):

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

Utamakan CLI daripada endpoint hosted ketika agen Anda berjalan secara lokal dan Anda ingin panggilan tool dijalankan sebagai sesi terminal yang sudah login, atau ketika klien Anda hanya mendukung stdio. Endpoint hosted (lihat [Hubungkan asisten Anda](/id/ai-agents/connect)) tetap menjadi pilihan yang tepat untuk asisten chat seperti Claude di web dan ChatGPT.

## Gunakan dari shell

Hasil berupa JSON di stdout; kesalahan berupa teks yang mudah dibaca di 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"
```

Konvensi yang berguna:

* `scribe tools` menampilkan setiap tool MCP dan perintah CLI-nya; `scribe call <tool_name> --json '{...}'` memanggil tool apa pun berdasarkan nama MCP-nya yang tepat.
* Field kompleks seperti pohon konten tanda tangan menerima JSON inline, `@file`, atau `-` untuk stdin. `--json` dapat menyediakan seluruh objek argumen, dan flag eksplisit menggantikannya.
* Boolean berupa `--flag` / `--no-flag`; membiarkan keduanya kosong akan menghilangkan field tersebut, sehingga pembaruan parsial tidak pernah menimpa nilai secara tidak sengaja.
* Kode keluar: `0` berhasil, `1` error API atau tool, `2` error penggunaan, `3` belum login.

## Perintah menurut area

| Grup                                                       | Perintah                                                                                        |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `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`                                                                               |
| Tingkat atas                                               | `workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback` |
| Sesi                                                       | `login` · `logout` · `whoami` · `mcp` · `tools` · `call`                                        |

Perilaku per-tool identik dengan tools MCP — lihat [Referensi tools](/id/ai-agents/tools).

## Bekerja melalui SSH

Untuk login diperlukan browser yang dapat menjangkau `127.0.0.1` pada mesin yang menjalankan CLI. Pada mesin remote, teruskan port callback dan cetak URL alih-alih membuka browser:

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

Kemudian buka URL yang tercetak di browser lokal Anda.

## Langkah berikutnya

<CardGroup cols={2}>
  <Card title="Referensi tools" icon="wrench" href="/id/ai-agents/tools">
    Setiap tool Scribe, dikelompokkan berdasarkan area
  </Card>

  <Card title="Skills" icon="book" href="/id/ai-agents/skills">
    Berikan asisten Anda alur kerja Scribe secara lengkap
  </Card>

  <Card title="Pemecahan masalah" icon="bug" href="/id/ai-agents/troubleshooting">
    Perbaiki masalah koneksi dan tool
  </Card>

  <Card title="Referensi API" icon="code" href="/api-reference/introduction">
    REST API di balik CLI dan server MCP
  </Card>
</CardGroup>