メインコンテンツへスキップ
Scribe CLI(@scribemail/cli)は、Scribeのツール群をまるごと手元のマシンで利用できるようにします。次の2つの側面があります:
  • ローカル 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 から行えます。

インストールとサインイン

1

Install from npm

Node.js 20 以降が必要です。
2

Sign in with your browser

ブラウザーが開き、Scribe アカウントでサインインします。API キーの作成や貼り付けは不要です。認証情報は ~/.config/scribe/credentials.json に所有者のみのパーミッションで保存され、自動的に更新されます。
3

Check the session

サインイン中のユーザー、ワークスペース、トークンの状態を表示します。
サインインするメンバーはワークスペースの オーナーまたは管理者 である必要があり、ワークスペースのプランに API アクセスが含まれている必要があります。1 回のログインは 1 つのワークスペースに紐づきます。切り替えるには scribe login を再実行してください。

ローカルエージェントを MCP で提供

JSON で設定するクライアント(Claude Desktop、Cursor など)の場合:
エージェントをローカルで実行し、ツール呼び出しを既にサインイン済みのターミナルセッションとして実行したい場合、またはクライアントが stdio のみに対応している場合は、ホスト型エンドポイントよりも CLI を優先してください。Web 版 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