Zaru の実行ごとに必要な接続だけを渡す

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

開示: Zaru は 100monkeys AI, Inc. が開発しているため、このガイドは作り手による説明として読んでください。2026年10月29日に読んだ Zaru ドキュメントの Profiles のページと、このサイトの文言をもとに当社の AI エージェントが下書きし、当社が確認しました。この日本語版は英語の原文ガイドの翻訳です。以下に引用する規則とメッセージはすべてそのページのもので、英語のまま載せ、訳を添えています。仕組みが書かれていないところは、推測で説明せず、書かれていないと書いています。

Zaru があなたのメールボックス、カレンダー、GitHub のトークンを持つようになると、ある会話、実行、スケジュールがそのうちどれに触れてよいかが問題になります。プロファイルはそれに 1 つの選択で答えます。名前を付けた接続の組と、それらが使ってよいツールです。プロファイルも選んだ接続もない実行は、どれにも届きません。このガイドではプロファイルを作り、ツールを絞り、チャット、スケジュール、MCP クライアントで使います。

プロファイルとは

ドキュメントによると、プロファイルは "your own named set of connections (a mailbox, a calendar account, a Carbon Forge (formerly Nuclear Notes) token, a GitHub token and so on, any number of any kind) with a list of the tools they may use, and optional defaults."(名前を付けた自分の接続の組。メールボックス、カレンダーのアカウント、Carbon Forge(旧 Nuclear Notes)のトークン、GitHub のトークンなど、種類も数も問わない。それらが使ってよいツールの一覧と、任意の既定値を持つ)です。役に立つ理由となる規則は、Profiles ページそのものの一覧の上に書かれています。"A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none."(実行、スケジュール、API キーは、プロファイルが挙げる接続にだけ届く。プロファイルがなければどれにも届かない)。

ステップ 1. アカウントを作り、使うものを接続する

Get Zaru free を押します。登録に必要なのは名前とメールアドレスだけです。サイトの説明どおり、Vault からメールとカレンダーを接続します。プロファイルに入れられるのはすでに持っている接続だけなので、先に接続してください。

ステップ 2. Vault の Profiles を開く

一覧は /vault/profiles にあり、各プロファイルの接続とツールの数が表示されます。New profile を押します。あとで編集するときも同じフォームです。

ステップ 3. 仕事の名前を付け、接続を選ぶ

名前は 1 から 64 文字で、自分のプロファイルの中で一意です。アカウントではなく仕事の名前を付けてください。ドキュメント自身の例は "Fundraising" です。次に、その仕事に必要な接続にチェックを入れます。フォームは種類ごとにまとめて表示します。あとで取り消したり削除したりした接続は removed として一覧に残り、プロファイルには "A connection in this profile was removed."(このプロファイルの接続が削除されました)と表示されます。

ステップ 4. ツールを絞る

各項目は mail.reply のような正確なツール名か、carbon-forge.* のように <family>.* と書くファミリーです。空の一覧は "All tools these connections allow"(これらの接続が許すすべてのツール)を意味します。ドキュメントの例のプロファイルが許すものは次のとおりです。

"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]

フォームは承認を待つツールに "Needs your approval"(承認が必要)と印を付けます。プロファイルは絞ることしかできません。プランが許していない項目は "A profile can only narrow the tools your plan allows; <pattern> is not one of them."(プロファイルはプランが許すツールを絞ることしかできません。<pattern> はそれに含まれません)で拒否されます。

ステップ 5. プロファイルが変えないものを知る

プロファイルが管理するのは、接続のファミリーのツールです。mail.*、calendar.*、それ以外は github.* のようなプロバイダーのファミリーです。fs.*、cmd.run、web.* のようなツールはプロファイルの管理外で、セキュリティコンテキストだけが決めます。また、許されたツールでも承認ゲートは通ります。mail.send、mail.reply、mail.forward、mail.delete、mail.archive は、プロファイルの内容にかかわらずあなたの返事を待ちます。つまり mail.reply があって mail.send がないプロファイルでは、実行はスレッドに返信でき(返信ごとにあなたを待ちます)、新しいメッセージはすぐに拒否されます。

ステップ 6. 既定値を加える

3 つの任意項目で入力が省けます。既定の repository(git リポジトリの紐づけの 1 つ)、"when a Carbon Forge call names none"(Carbon Forge の呼び出しがワークスペースを指定しないとき)に使う既定の Carbon Forge ワークスペース、そしてこのプロファイルでの会話向けの instructions(最大 4,000 文字)です。Zaru にはプロファイルの名前、ワークスペース、あなたの指示が伝えられます。

ステップ 7. 会話で選ぶ

チャット入力欄の上にある会話パネルを開きます。その Context セクションには None、次に Profiles、次に種類ごとの接続が並びます。プロファイルを選ぶと選んでいた接続は外れ、入力欄の上の行に "Profile: <name>" と表示されます。プロファイルは会話とともに保存されるので、後の発言とそこから始まる実行もそれを使います。実行が持つのはプロファイルか選んだ接続のどちらかで、両方ではありません。"Choose one profile, or choose connections without a profile; not both."(プロファイルを 1 つ選ぶか、プロファイルなしで接続を選ぶか。両方は不可)。

ステップ 8. スケジュールと API キーに使う

スケジュールのフォームはプロファイルか選んだ接続のどちらかを保存し、両方は保存しません。プロファイルのリポジトリとワークスペースがフォームに入ります。Settings → API Keys では、キーごとの行でプロファイルを選びます。先頭は None です。プロファイルのないキーは、あなたの接続のどれにも届きません。

ステップ 9. MCP クライアントから選ぶ

クライアントは接続のすべてのリクエストでプロファイルを送ります。予約キー @profile だけを入れた 1 つのヘッダーです。

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

この ID はドキュメントの例です。自分のプロファイルの ID を使ってください。@profile をほかのキーと並べると 400 が返ります。

ステップ 10. 拒否を読む

管理対象の呼び出しは、その時点のプロファイルと照らし合わせて確かめられます。プロファイルにないツールは TOOL_NOT_IN_PROFILE で拒否されます。"This tool is not in the profile chosen for this run."(このツールは、この実行に選ばれたプロファイルに含まれていません)。Zaru Web にはプロファイルへのリンク付きカードが表示されるので、ツールを加えるか、外したままにするかを選べます。ほかの実行が始めた実行は、元の実行が選んだ接続より先には届きません。プロファイル付きの実行で選んだ "Always allow"(常に許可)はそのプロファイルにだけ効き、プロファイルを削除すると取り消されます。

ドキュメントに書かれていないこと

MCP ヘッダーに使うプロファイル ID の見つけ方。REST の応答には含まれますが、Zaru Web に表示されるかどうかは書かれていません。
個々の MCP クライアントの設定でプロファイルを選ぶ方法。ヘッダーの形は示されていますが、クライアントの設定は示されていません。
プロファイルを編集すると実行中の処理が変わるかどうか。呼び出しは "as it stands at that moment"(その時点の内容で)確かめられますが、接続は開始時に実行のものになります。
このサイトはプロファイルに触れていません。情報源はドキュメントだけです。