他の言語: English, Español, Português, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · 日本語のガイド一覧
開示: Carbon Forge は 100monkeys.ai で開発しているため、作り手による説明として読んでください。このガイドは公開ドキュメント、主に MCP token scopes(R#62460)、MCP tokens(R#61824)、カタログの Tokens ページ(R#62188)をもとに当社の AI エージェントが下書きし、当社が確認しました。この日本語版は英語の原文ガイドの翻訳です。プリセット名、引数、引用文はドキュメント自身のもので、引用は英語のまま載せ、訳を添えています。ドキュメントには発行の呼び出しの完全な例がないため、例ではなく引数の一覧を示します。ドキュメントが答えていない点は、最後の節に書いています。
すべてのトークンにある 2 つの制限
トークンはロールの上限(viewer、editor、admin)とツールスコープを持ちます。スコープは "the explicit set of MCP tools the bearer is allowed to call."(持ち主が呼び出してよい MCP ツールの明示的な集合)です。ロールの上限が権限の天井で、スコープはそれをさらに狭めます。ドキュメントの例では、admin トークンに SCM reader スコープを付けても、viewer トークンに同じスコープを付けたときと同じツールカタログが返ります。
ステップ 1. エージェントにさせることを決める
フォームを開く前に、エージェントの仕事を 1 行で書きます。取得して推論する、メモを取る、コードを読む、レーンで作る、リリースする。それぞれが下のプリセットに対応します。ドキュメントの規則は "Default to the narrowest preset that still covers what the client needs."(クライアントに要るものを満たす、最も狭いプリセットを既定にする)です。
ステップ 2. ロールの上限を決める
設定を開いて API tokens を選び、ワークスペースとロールの上限を選びます。SCM プリセットは組み合わせるロールを示しています。SCM reader は viewer と、SCM agent と SCM release は editor とです。
ステップ 3. 最も狭いプリセットを選ぶ
プリセットと、ドキュメントに書かれたツールの数です(どれも cortex.ground を含みます)。
- Read-only memory(
read_only_memory、14): ページとアトムの読み取り、検索、相互リンクの追跡。書き込みなし。 - Basic LLM memory(
basic_memory、30): ページ、アトム、タグの読み書きと検索。 - Knowledge-graph reader(
knowledge_graph_reader、31): すべてのコンテンツとグラフ。書き込みなし。 - SCM reader(
scm_reader、58): コードツリー、レーン、チェンジセット、カット、ファイルツリーに、ページと検索。書き込みなし。 - SCM agent(
scm_agent、104): SCM の読み取りに加え、ページ、アトム、レーン、ツリーの書き込み、レーンのランディング、カット、レンダリング。 - SCM release(
scm_release、67): SCM の読み取りに加え、レーンのランディングと承認、カット、アーカイブのプッシュ、サイトの公開。 - Full access(
full、177): ロールの上限の範囲ですべてのツール。
レーンで作るコーディングエージェントには SCM agent、承認するレビュー担当には SCM release、調査エージェントには reader 系を渡します。ドキュメントは Full access を "trusted with anything the role can do"(そのロールにできることなら何でも任せられる)クライアントのためにとっておいています。
ステップ 4. ツールを 1 つ足すなら Custom を使う
プリセットにツールが 1 つ足りないときは Custom を選び、グループ分けされたピッカーからツールを選びます。ドキュメントの例は "that should be able to create comments but not pages"(コメントは作れるがページは作れないようにすべき)公開用エージェントです。スコープはツール一覧、/api/mcp/manifest のマニフェスト、そしてすべての呼び出しに適用されます。スコープ外のツールは Unknown tool: <name> と答え、"exactly as a tool that does not exist"(存在しないツールとまったく同じ)なので、クライアントは自分のトークンに何が欠けているかを知ることができません。
ステップ 5. トークンを発行し、シークレットを保管する
トークンには持つエージェントや環境の名前を付け、シークレットをコピーします。"it is shown once, then only the prefix."(表示は一度だけで、その後はプレフィックスだけ)。トークンはそれぞれ自分の現在のワークスペースを持つので、2 つのトークンを持つ 2 つのエージェントが互いのポインターを動かすことはありません。
ステップ 6. 実行トークンはオーケストレーターにだけ許す
実行トークンは "a short-lived child of one of your tokens, minted for a single AEGIS run"(あなたのトークンの 1 つから、AEGIS の 1 回の実行のために発行される短命の子)で、AEGIS by 100monkeys.ai, in beta はエージェントを動かすオーケストレーターです。トークンが子を発行できるのは、持ち主がトークンのフォームで May mint execution tokens にチェックを入れたときだけです。既定ではオフで、どのプリセットもオンにせず、ドキュメントは "leave it off unless an orchestrator holds the token."(オーケストレーターがトークンを持つのでない限りオフのままに)と書いています。発行ツールは full プリセットにしかありません。
ステップ 7. 1 回の実行用に子トークンを発行する
親は次の引数で tokens.mint_execution を呼びます。
execution_id, instance_id, workspace_id, tree_path, lane_label, tools, role_cap, lifetime_seconds, workflowインスタンス 1 つ、ワークスペース 1 つ、ツリーのパス 1 つ、レーンのラベル 1 つ、親が持つツールから 1 から 166 個、親と同じか viewer のロール上限、そして親の有効期限を決して越えない最長 86,400 秒の寿命です。workflow は任意で、実行が受け持つランディングルールのゲートの名前です。答えは次のとおりです。
{ token_id, parent_token_id, execution_id, instance_id, workspace_id, tree_path, lane_label, workflow, role_cap, tools, expires_at, secret }範囲を広げようとすると 1 文で拒否され、何も発行されません。子の書き込みはすべて自分のレーンを指定し、自分のパスの下にとどまる必要があります。レーン forge/run-1 とパス apps/web に対するドキュメントの拒否メッセージです。
This execution token writes only to lane "forge/run-1", not to the trunk.
This execution token writes only under "apps/web", not to "apps/api/x.ts".子が 2 つ目の身元になることはありません。子が行う変更はすべて、あなたを行為者として、発行の対象となった実行とともに記録します。
ステップ 8. 取り消し、監査ログを読む
子は自分で、または親によって tokens.revoke_execution で取り消されます。取り消したサーバーではすぐに、ほかのすべてのサーバーでも 30 秒以内に認証できなくなります。親を取り消すか親のスコープを変えると、すべての子が取り消されます。ツールの呼び出しはすべてトークンの身元で監査ログに記録され、発行と取り消しのたびに親、子、実行を記した監査行が書かれます。
実行の承認を保護されたトランクで有効にするには、ガイドランディングルール: コードオーナーを記録の中に置き、AEGIS のワークフローをゲートにするを読んでください。
ドキュメントが答えていないこと
- 実例。カタログは発行の引数と答えを挙げていますが、呼び出しの例はありません。
- ツールの上限。子が受け取れるのは 1 から 166 個ですが、
fullプリセットは 177 個です。どのツールが子に渡せないかは挙げられていません。 - オーケストレーターが親トークンを受け取る方法。オーケストレーターが持つときだけ発行を許すよう書かれていますが、AEGIS にそのトークンをどう渡すかは書かれていません。
- プリセットごとの一覧の場所。数は示されていますが、プリセットごとのツール名はフォームのピッカーにしかありません。