> ## 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: twoje podpisy w terminalu i lokalne agenty

> Zainstaluj Scribe CLI, zaloguj się raz i zarządzaj podpisami z poziomu terminala — lub udostępnij wszystkie narzędzia Scribe lokalnemu agentowi AI przez MCP.

Scribe CLI (`@scribemail/cli`) udostępnia pełną powierzchnię narzędzi Scribe na twojej maszynie. Ma dwa oblicza:

* **Lokalny serwer MCP** — `scribe mcp` udostępnia dokładnie te same narzędzia co hostowany serwer MCP każdemu agentowi, który potrafi uruchomić polecenie (Claude Code, Claude Desktop, Cursor oraz dowolny klient MCP stdio), działając w twoim imieniu po jednorazowym zalogowaniu w przeglądarce.
* **Zwykła linia poleceń** — każde narzędzie jest też podpoleceniem (`scribe signatures list`, `scribe campaigns schedule`), z wyjściem JSON przygotowanym pod skrypty i powłoki.

Oba są generowane z tego samego kodu co hostowany serwer pod `mcp.scribe-mail.com`, więc narzędzia, nazwy i zachowanie nigdy się nie rozjeżdżają.

## Instalacja i logowanie

<Steps>
  <Step title="Zainstaluj z npm">
    Wymaga Node.js 20 lub nowszego.

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

  <Step title="Zaloguj się w przeglądarce">
    ```bash theme={null}
    scribe login
    ```

    Otworzy się przeglądarka i zalogujesz się kontem Scribe — bez tworzenia ani wklejania klucza API. Poświadczenia są zapisywane w `~/.config/scribe/credentials.json` z uprawnieniami wyłącznie dla właściciela i odświeżają się automatycznie.
  </Step>

  <Step title="Sprawdź sesję">
    ```bash theme={null}
    scribe whoami
    ```

    Pokazuje zalogowanego użytkownika, Workspace oraz stan tokenu.
  </Step>
</Steps>

<Note>
  Zalogowany członek musi być **właścicielem lub administratorem** Workspace, a plan Workspace musi obejmować dostęp do API. Jedno logowanie jest powiązane z jednym Workspace — uruchom ponownie `scribe login`, aby przełączyć.
</Note>

## Udostępnianie lokalnemu agentowi przez MCP

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

Dla klientów skonfigurowanych z JSON (Claude Desktop, Cursor i inne):

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

Wybieraj CLI zamiast hostowanego endpointu, gdy agent działa lokalnie i chcesz, aby wywołania narzędzi odbywały się w kontekście już zalogowanej sesji terminala, lub gdy twój klient obsługuje wyłącznie stdio. Hostowany endpoint (zob. [Podłącz swojego asystenta](/pl/ai-agents/connect)) pozostaje właściwym wyborem dla asystentów czatowych, takich jak Claude w wersji webowej czy ChatGPT.

## Użycie z powłoki

Wyniki to JSON na stdout; błędy to czytelny tekst na 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"
```

Przydatne konwencje:

* `scribe tools` wypisuje każde narzędzie MCP i jego polecenie CLI; `scribe call <tool_name> --json '{...}'` wywołuje dowolne narzędzie po jego dokładnej nazwie MCP.
* Złożone pola, takie jak drzewa treści podpisu, przyjmują wbudowany JSON, `@file` lub `-` dla stdin. `--json` może dostarczyć cały obiekt argumentów, a jawne flagi go nadpisują.
* Wartości logiczne to `--flag` / `--no-flag`; pominięcie obu opuszcza pole, więc częściowe aktualizacje nigdy przypadkiem nie nadpisują wartości.
* Kody wyjścia: `0` sukces, `1` błąd API lub narzędzia, `2` błąd użycia, `3` niezalogowany.

## Polecenia według obszaru

| Grupa                                                      | Polecenia                                                                                       |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `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`                                                                               |
| Najwyższy poziom                                           | `workspace` · `billing documents` · `content-schema` · `docs search` · `docs read` · `feedback` |
| Sesja                                                      | `login` · `logout` · `whoami` · `mcp` · `tools` · `call`                                        |

Zachowanie poszczególnych narzędzi jest identyczne jak w narzędziach MCP — zobacz [dokumentację narzędzi](/pl/ai-agents/tools).

## Praca przez SSH

Logowanie wymaga przeglądarki, która ma dostęp do `127.0.0.1` na maszynie, na której działa CLI. Na maszynie zdalnej przekieruj port zwrotny i wypisz adres URL zamiast otwierać przeglądarkę:

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

Następnie otwórz wypisany adres URL w lokalnej przeglądarce.

## Kolejne kroki

<CardGroup cols={2}>
  <Card title="Dokumentacja narzędzi" icon="wrench" href="/pl/ai-agents/tools">
    Wszystkie narzędzia Scribe, pogrupowane tematycznie
  </Card>

  <Card title="Umiejętności" icon="book" href="/pl/ai-agents/skills">
    Udostępnij asystentowi pełny przepływ pracy w Scribe
  </Card>

  <Card title="Rozwiązywanie problemów" icon="bug" href="/pl/ai-agents/troubleshooting">
    Rozwiąż problemy z połączeniem i narzędziami
  </Card>

  <Card title="Dokumentacja API" icon="code" href="/api-reference/introduction">
    REST API stojące za CLI i serwerem MCP
  </Card>
</CardGroup>