Cursor、Codex、任意の MCP クライアントを 1 つの Carbon Forge ワークスペースに接続する

他の言語: English, Español, Português · 日本語のガイド一覧

開示: Carbon Forge は 100monkeys.ai で開発しているため、作り手による説明として読んでください。このガイドは当社の AI エージェントが下書きし、当社がレビューしました。この日本語版は英語の原文ガイドの翻訳です。Carbon Forge の手順は公開ドキュメント(英語)を引用し、訳を添えています。各クライアントの設定はそのクライアント自身のドキュメントからコピーし、リンクを横に置いています。最後の節では、ドキュメントが答えていないことを挙げます。

作るもの

1 つのワークスペース、複数のクライアント、それぞれに 1 つのトークン。Carbon Forge のサーバーは Streamable HTTP を話し、"binds every call to a workspace via a bearer token"(すべての呼び出しを bearer トークンでワークスペースに結びつける)、そして "tools honor the cap exactly as a human session does: there is no agent-only privilege"(ツールは人のセッションとまったく同じように上限を守る。エージェントだけの特権はない。MCP overview)。HTTP ヘッダーを送れるクライアントなら何でも接続できます。Claude Code には専用のガイドがあります: Claude Code を MCP で Carbon Forge に接続する。

ステップ 1. クライアントごとにトークンを作る

carbonforge.dev/login でサインインし、設定を開いて API tokens を選び、ワークスペース、ロールの上限、ツールスコープを選んで、"name the token after the agent or environment that will hold it"(トークンには、それを持つエージェントや環境の名前を付ける。MCP tokens)。クライアントごとにトークンを分ければ、"every tool call ... under the token identity"(すべてのツール呼び出しをトークンの識別で)記録する監査ログが、どのツールが何をしたかを教えてくれ、1 つだけを失効させることもできます。

スコープは仕事に合わせて選びます(MCP token scopes)。メモを取るアシスタントには Basic LLM memory、読むだけなら Read-only memory か SCM reader、レーン上でコードを書くなら SCM agent。ドキュメントの助言: "Default to the narrowest preset that still covers what the client needs."(クライアントに必要なことをまだ満たす、最も狭いプリセットを既定にする。)

ステップ 2. 各トークンを環境変数に置く

シークレットは "is shown once, then only the prefix"(一度だけ表示され、その後はプレフィックスだけになる)。以下の 2 つのクライアントは環境変数から読めるので、コミットに紛れ込む設定ファイルに置かずに済みます。

export CARBON_FORGE_TOKEN=‹token for this client›

ステップ 3. Cursor を設定する

Cursor は MCP サーバーを mcp.json から読みます。全プロジェクト用は ~/.cursor/mcp.json、1 つのプロジェクト用は .cursor/mcp.json です。リモートサーバーは url と headers を取り、Cursor はその両方で ${env:NAME} を展開します(Cursor の MCP ドキュメント)。

{
  "mcpServers": {
    "carbon-forge": {
      "url": "https://carbonforge.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:CARBON_FORGE_TOKEN}"
      }
    }
  }
}

ステップ 4. Codex を設定する

Codex は MCP サーバーを ~/.codex/config.toml、または信頼済みプロジェクト内の .codex/config.toml に保存します。Streamable HTTP サーバーは url を取り、bearer_token_env_var は "environment variable name for a bearer token to send in Authorization"(Authorization で送る bearer トークンの環境変数名。Codex の MCP ドキュメント)を指定します。

[mcp_servers.carbon_forge]
url = "https://carbonforge.dev/api/mcp"
bearer_token_env_var = "CARBON_FORGE_TOKEN"

ステップ 5. その他の MCP クライアントを設定する

Claude Desktop について、Carbon Forge のドキュメントはこう書いています。"add an MCP server entry pointing at the instance URL with the token in the Authorization header"(インスタンスの URL を指し、Authorization ヘッダーにトークンを入れた MCP サーバーのエントリを追加する)。IDE プラグインについては "point the plugin at the same MCP endpoint; Streamable HTTP works over plain HTTPS"(プラグインを同じ MCP エンドポイントに向ける。Streamable HTTP は通常の HTTPS で動く)。クライアントのファイル形式が何であれ、入力する値は次の 3 つです。

Endpoint:  https://carbonforge.dev/api/mcp
Transport: Streamable HTTP
Header:    Authorization: Bearer ‹token for this client›

ステップ 6. cortex.ground で各クライアントを確認する

各クライアントに cortex.ground を呼ばせてください。これは "the calling identity, what the bearer can do, what is reachable"(呼び出し元の識別、トークン保持者にできること、到達できるもの。cortex.ground)を返します。答えを比べてください。どのクライアントも同じワークスペースと、そのスコープが許す権限を示すはずです。トークンが間違っているクライアントは拒否されます。ドキュメントによれば、不正なトークンは "refused outright rather than quietly treated as anonymous"(黙って匿名として扱われるのではなく、はっきり拒否される)。

ステップ 7. 毎回の呼び出しでワークスペースを指定する

各トークンは自分の現在のワークスペースを覚えているので、"every agent has its own active workspace and they do not collide"(各エージェントが自分のアクティブなワークスペースを持ち、衝突しない。MCP token scopes)。これは、2 つのクライアントが知らないうちに別々のワークスペースを指しうるということでもあります。各エージェントには、毎回の呼び出しで workspace を渡すよう指示してください。ツールはこれを受け付け、ポインターは動きません。

ステップ 8. 書き込むエージェントにはそれぞれのレーンを

共有メモはページです。クライアント同士がぶつかるのは共有コードです。Carbon Forge では、エージェントはクローンせずにレーンを開きます。"A lane costs nothing to open and holds no copy, so one per task, or one per agent, is the expected use"(レーンは開くのにコストがかからず、コピーも持たない。だからタスクごとに 1 つ、あるいはエージェントごとに 1 つが想定された使い方だ。Working in lanes)。Carbon Forge は自分でテキストをマージしません。もう適用できないパッチは名前付きの競合として戻り、ランディングは 1 つのチェンジセットで、全部か無しかです。Cursor のエージェントと Codex は、間で黙ってマージされることなく同じトランクで作業できます。

ドキュメントが答えていないこと

• クライアント別の設定はありません。Carbon Forge のドキュメントは Claude Desktop と IDE プラグインにそれぞれ 1 文ずつ触れるだけで、Cursor や Codex 用のファイルは示していません。上の設定例は Cursor と Codex のドキュメントからのものです。
• 独自ホストや独自ドメインのインスタンスのエンドポイントは書かれていません。ドキュメントが挙げるのは https://carbonforge.dev/api/mcp です。
• How MCP works は /mcp への curl 呼び出しを示していますが、匿名アクセスのページは /api/mcp を使っています。
• トークンが自動で失効するかは書かれていません。失効させる方法は書かれています。
• MCP クライアントの OAuth サインインには触れていません。ドキュメントにある方法は bearer トークンです。

関連ガイド

• Claude Code を MCP で Carbon Forge に接続する
• オーケストレーターに承認ステップを持たせる方法(100monkeys.ai)
• メールとカレンダーを承認付きで任せられる Zaru アシスタントを設定する(myzaru.com)