ツール、プロファイル、承認をまとめる Zaru の一つのエンドポイント

他の言語: English, Español, Português, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · 日本語のガイド一覧

開示: Zaru は 100monkeys AI, Inc. が開発しているため、このガイドは作り手による説明として読んでください。2026年10月29日に読んだ Zaru ドキュメント(Connect Zaru to Any MCP Client, MCP Tools, Profiles, API Keys, The Vault, Calendar, Refusals and Errors)をもとに当社の AI エージェントが下書きし、当社が確認しました。この日本語版は英語の原文ガイドの翻訳です。以下のコマンド、ヘッダー、メッセージはすべてそれらのページからの写しで、引用は英語のまま載せ、訳を添えています。仕組みが書かれていないところは、推測で説明せず、書かれていないと述べます。

メールボックス、カレンダー、GitHub token、Carbon Forge token を Zaru に置けば、Claude Code は一つのアドレスからそのすべてに届きます。token は Zaru に残り、どれにキーが触れてよいかはプロファイルが決め、何かを送ったり変えたりする呼び出しは Zaru Web であなたの答えを待ちます。このガイドは zaru init から最初の保留された呼び出しまでを順にたどります。

ステップ 1. ツールが使うものを接続する

Get Zaru free から登録します。必要なのは名前とメールアドレスだけです。Vault の Connections ページでは、Google のメールボックス、Google Calendar、IMAP と SMTP によるメールボックス、CalDAV によるカレンダーを接続できます。GitHub token や Carbon Forge の MCP token は New Credential で保存します。値についてドキュメントははっきりしています: "No agent, operator, API key or other person is given the value."(エージェントにも、オペレーターにも、API キーにも、ほかの誰にも値は渡されません。)

ステップ 2. プロファイルを作る

キーは、何に届いてよいかをあなたが決めるまで何にも届きません。API Keys のページは一覧の上でこう述べています: "A key reaches only the connections in the profile you choose for it; with no profile it reaches none."(キーが届くのは、そのキーに選んだプロファイルの接続だけです。プロファイルがなければどれにも届きません。)エディターに持たせる接続とツールでプロファイルを作ってください。フォームの手順は Zaru の実行ごとに必要な接続だけを渡すにあります。

ステップ 3. API キーを作り、そのプロファイルを選ぶ

Settings → API Keys を開き、New API Key を押して名前を付け、スコープのプリセットを選び、キーのプロファイルを選び(既定は None)、有効期限を選んで Create を押します。"The key value is shown once."(キーの値は一度だけ表示されます。)

ステップ 4. Claude Code にエンドポイントを追加する

どのクライアントも一つのアドレス https://mcp.myzaru.com/mcp/v1 に StreamableHTTP で接続し、キーを Bearer token として渡します。Claude Code についてドキュメントが示すのは次のとおりです:

claude mcp add zaru \
  --transport http \
  https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY"

同じページに Claude Desktop、Cursor、Windsurf、VS Code(GitHub Copilot)、Gemini CLI、そして StreamableHTTP を話すあらゆるクライアントの設定があります。

ステップ 5. zaru init と入力する

セッションの中で、アシスタントにこう伝えます:

zaru init

アシスタントは zaru.init ツールを呼び出し、Zaru のペルソナを採用します。zaru init agentic なら指定したモードで始まります。これは MCP サーバーのツールです。Zaru CLI のガイドにあるコマンドラインプログラムの zaru init とは無関係で、そちらは Zaru Web に接続しません。

ステップ 6. 必要なら接続ごとにプロファイルを選ぶ

キーのプロファイルはすべてのリクエストに適用されます。代わりに、クライアントは予約キー @profile だけを入れた x-zaru-contexts ヘッダーを送ることもできます:

x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}

この id はドキュメントのサンプルです。キーで接続している場合、リクエストの @profile がそのリクエストに限ってキー自身のプロファイルの代わりになり、提示されるツールもそのプロファイルのものになります。ほかの形はすべて 400 が返ります。

ヘッダーの置き場所は Connect Zaru to Any MCP Client のページにあります: "Every client above sends one header, Authorization, from its configuration. The same place takes a second header, x-zaru-contexts, which chooses for every request of that connection which of your connections its tools use."(上のどのクライアントも、設定から Authorization というヘッダーを一つ送ります。同じ場所に二つ目のヘッダー x-zaru-contexts を書けます。これは、その接続のすべてのリクエストについて、ツールがあなたのどの接続を使うかを選びます。)Claude Code では二つ目の --header を付けます:

claude mcp add zaru \
  --transport http \
  https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header 'x-zaru-contexts: {"@profile":"<profile id>"}'

JSON で設定するクライアント(Claude Desktop、Windsurf、VS Code)では、headers の下の二つ目の項目になります。"The profile's id is the last part of the address of its page in Zaru Web, ask.myzaru.com/vault/profiles/<profile id>."(プロファイルの id は、Zaru Web にあるそのプロファイルのページのアドレスの最後の部分です。)ドキュメントが答えていないことが一つあります: "Whether a given client sends a header it was configured with on every request is the client's behaviour, not documented here."(設定したヘッダーをクライアントが毎回のリクエストで送るかどうかはクライアントの動作であり、ここでは文書化されていません。)

ステップ 7. 接続を使う呼び出しをする

クライアントには、プロファイルの接続ファミリーのツールが一覧されます。メールボックスならメールのツール、カレンダーならカレンダーのツール、GitHub や Carbon Forge ならリモートサーバーのツールです。メールボックスもアカウントも指定しないメールやカレンダーの呼び出しは、一つしかなければそれを、そうでなければ最も新しいものを使い、答えの mailbox_name または account_name にその名前が入ります。カレンダーのツールについてドキュメントはこう述べています: "Your Google token or your password never reaches an agent or the model."(Google の token もパスワードも、エージェントやモデルには決して届きません。)

MCP Tools のページはそれを挙げています: "The remote servers a person can connect today are GitHub and Carbon Forge (formerly Nuclear Notes)."(今日つなげるリモートサーバーは GitHub と Carbon Forge(旧 Nuclear Notes)です。)カスタム SEAL ゲートウェイ: 近日公開。

ステップ 8. 拒否を読む

AEGIS by 100monkeys.ai(ベータ版)が呼び出しを拒否すると、クライアントは isError: true を持つ通常のツール結果を受け取り、その中に error.code、error.message、request_id が入っています。到達範囲に関する拒否は二つです:

CREDENTIAL_BINDING_REQUIRED: 何かが動く前に返ります。プロファイルのないキーでは: "This key reaches none of your connections. Choose a profile for it on the API keys page in Zaru Web, or name one in the request."(このキーはあなたの接続のどれにも届きません。Zaru Web の API キーのページでプロファイルを選ぶか、リクエストで指定してください。)一度も接続していないファミリーなら、答えは Connections ページを示します。
TOOL_NOT_IN_PROFILE: "This tool is not in the profile chosen for this conversation."(このツールは、この会話に選ばれたプロファイルに含まれていません。)

どちらも error.needs を持ち、ファミリーと、それを解決する Zaru Web のページを示します。実行の場合、Zaru Web のカードには "This run has no profile that names your <family>."(この実行には、あなたの <family> を指定したプロファイルがありません。)と Open Profiles が出ます。ポリシーによる拒否は決定的なので、同じ呼び出しを繰り返さず、呼び出しを変えてください。

ステップ 9. 保留された呼び出しに Zaru Web で答える

"Every tool that asks for approval waits at the person's approval gate, as a call from the chat does."(承認を求めるツールはすべて、チャットからの呼び出しと同じように、その人の承認ゲートで待ちます。)呼び出しは {"status": "approval_pending", "approval_id", "summary", "message"} を返し、そのメッセージは "This waits for your answer in Zaru Web, under Approvals."(これは Zaru Web の Approvals で、あなたの答えを待っています。)です。Approvals ページで答えてください。aegis.approval.status を使えば、クライアントからあなたの答えを読めます。

MCP Tools のページは、myzaru.com で既定で待つ呼び出しを挙げています。ツールカタログが印を付けるのは mail.send, mail.reply, mail.forward, mail.delete, mail.archive、そしてカレンダーの四つの書き込み calendar.create, calendar.update, calendar.delete, calendar.respond です。デプロイの設定が印を付けるのは GitHub の四つの書き込み github.merge_pull_request, github.push_files, github.create_or_update_file, github.delete_file、それに aegis.git.push と aegis.system.info です。"No Carbon Forge tool waits: neither the catalogue nor the configuration marks one, so a Carbon Forge call the key's profile admits runs at once."(Carbon Forge のツールは待ちません。カタログも設定も印を付けていないので、キーのプロファイルが認める Carbon Forge の呼び出しはすぐに実行されます。)プロファイルのフォームは、待つツールそれぞれに "Needs your approval"(承認が必要)の印を付けます。恒常的な "Always allow"(常に許可)を選ぶと、そのツールの呼び出しは確認なしに答えられます。つまり待つのは既定の動作であって、約束ではありません。