アカウントなしで Carbon Forge の公開ワークスペースを読む

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

開示: Carbon Forge は 100monkeys.ai で開発しているため、作り手による説明として読んでください。このガイドは公開ドキュメント、主に Reading a public cortex without an account(R#64944)と MCP tokens(R#61824)をもとに当社の AI エージェントが下書きし、当社が確認しました。この日本語版は英語の原文ガイドの翻訳です。コマンド、呼び出しの例、引用文はドキュメント自身のもので、引用は英語のまま載せ、訳を添えています。このガイドのためには何も実行していません。ドキュメントが答えていない点は、最後の節に書いています。

なぜアカウントなしで読むのか

Carbon Forge の公開ワークスペースは、人はブラウザで、エージェントは MCP で、同じサーバーを通して読みます。匿名の窓口があれば、誰かが登録したりキーを作ったりする前から、エージェントは Carbon Forge のドキュメントそのもののような公開ナレッジベースを使えます。ドキュメントは規則を 1 行で述べています。トークンのないクライアントは "can read what a browser visitor can read."(ブラウザの訪問者が読めるものを読める)。

ステップ 1. エンドポイントを見つける

公開インスタンスはそれぞれ Streamable HTTP で MCP を提供します。carbonforge.dev のエンドポイントは https://carbonforge.dev/api/mcp です。匿名の読み取りは公開スイッチがオンのインスタンスにだけあり、オフのインスタンスは "asks you to sign in, exactly as it always has."(これまでどおりサインインを求める)。

ステップ 2. Authorization ヘッダーなしで接続する

エンドポイントをクライアントに追加し、Authorization ヘッダーは送りません。Claude Code 向けのドキュメントのコマンドです。

claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcp

Streamable HTTP を話すクライアントなら同じ URL を使えます。空のヘッダーや古いヘッダーではなく、ヘッダーそのものを送らないでください。"A wrong, expired or revoked token is refused outright rather than quietly treated as anonymous, so a client can never be reading less than it thinks it is."(間違った、期限切れの、または取り消されたトークンは、黙って匿名扱いされるのではなくその場で拒否されるので、クライアントが思っているより少なく読んでいることは決してない)。

ステップ 3. まずグラウンディングする

initialize のハンドシェイクは、インスタンスのグラウンディング文書、公開ワークスペース、呼び出せるツールを返します。"No session id is issued; you do not need one."(セッション ID は発行されず、必要もない)。向きを確かめるには cortex.ground を呼びます。これは使えるツールの 1 つで、一覧に出るワークスペースが次のステップで指定できるものです。

ステップ 4. 呼び出しごとにワークスペースを指定する

トークンは現在のワークスペースへのポインターを持ちます。トークンがなければポインターもないので、ワークスペースの中で動く呼び出しはすべて workspace をスラッグか UUID で渡します。ドキュメントの例はドキュメントのホームページを読みます。

{ "name": "pages.read", "arguments": { "workspace": "docs", "pathOrId": "home" } }

workspace を省くと、呼び出しは指定するよう伝えます。別の公開インスタンスを読むには、そのスラッグで instance を加えます。

ステップ 5. 読み、検索し、リンクをたどる

ドキュメントは読み取り専用ツールを 22 個と数えています。公開ワークスペースの一覧と解決、ページとアトムの一覧と読み取り、ハイブリッド検索と完全一致の部分文字列検索、ディスカバリーカタログの閲覧と検索、相互リンクと意味的に近いものの追跡、コメントスレッドとメディアのメタデータの読み取り、コード向けの files.list と trees.get などです。そのうち 2 つはほかと動きが違います。2 つの検索ツールは "search across every public instance whatever you pass"(何を渡してもすべての公開インスタンスを横断して検索する)、結果の封筒にもそう書かれます。1 つのワークスペースの中にとどまるには、検索ではなく読み取りと一覧を使ってください。

ステップ 6. ページの履歴を読む

リビジョン履歴と差分も匿名で読めます。したがって公開ページを引用するエージェントは、読んだリビジョンを示し、その後に何が変わったかを後で確かめられます。アカウントは要りません。サインインした編集者が見るのと同じ記録で、公開コンテンツに限られます。

ステップ 7. 制限に達したらペースを落とす

匿名のリクエストは IP アドレスごとに制限されています。制限に達すると、答えは Retry-After ヘッダー付きの 429 で、何秒待つべきかを伝え、ペースを落とすよう求め、登録を案内するメッセージが付きます。すぐに再試行せず、クライアントで Retry-After に従ってください。

ステップ 8. トークンが必要なときを知る

"Everything else answers as though it did not exist."(それ以外はすべて、存在しないかのように答える)。非公開のページ、非公開のワークスペース、存在しないページは、ブラウザと同じくどれも "not found" と答えるので、匿名のクライアントは見せられていないものを知ることができません。トークンが必要なのは "to write, to read private content, or to lift the anonymous limit"(書く、非公開のコンテンツを読む、匿名の制限を外す)ときで、トークンには別の独自の制限があります。どのアカウントにも無料の非公開ワークスペースが 1 つ含まれ、公開ワークスペースは無料です(料金を参照)。MCP tokens のページは、ワークスペース、ロールの上限、ツールスコープ、名前、一度だけ表示されるシークレットというトークンのフォームをたどっています。

スコープを絞ったトークンを Claude Code に渡し、自分のワークスペースにメモリを書くには、ガイドClaude Code を MCP で Carbon Forge に接続するを読んでください。

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

• 制限そのもの。リクエストが IP アドレスごとに制限されることと 429 は書かれていますが、数値も時間枠もありません。
• 22 個のツールの名前の一覧。ページはグループごとに説明し、名前を挙げているのは cortex.ground、files.list、trees.get だけです。
• Claude Code 以外のクライアントの設定方法。示されているのは Claude Code のコマンドだけです。
• 匿名の読み取りでレーン、カット、チェンジセットが見えるかどうか。ページはコードツリーとファイルを挙げていますが、レーン、カット、チェンジセットには触れていません。