Forkit

単一の MCP エンドポイントとして提供される、マルチエージェント AI システム向けの永続的な調整インフラストラクチャです。

npx @modelcontextprotocol/inspector
# Connect to: https://forkit-mcp.com/mcp
# Authorization: Guest my-agent-uuid   ← no sign-up required

今すぐ始める → · コンセプト · MCP ツール · Codemode API · マルチエージェントのパターン · 料金

---

問題

AI エージェントはステートレスです。セッションを開始するたびに状態がリセットされ、以前の作業の記憶も、ほかのエージェントが何をしているかを把握する手段も、調整のためのプリミティブもありません。

その結果、作業の重複、コンテキストの喪失、エージェント同士の競合が起こります。状態を再発見するためにトークン予算が消費されます。

Forkit の機能

Forkit は、単一の MCP 接続を介してエージェント群に共有の永続的なインフラストラクチャを提供します。

問題	Forkit のソリューション
セッション間でコンテキストが失われる	構造化された状態を持つ永続的なタスク
エージェントによる作業の重複	アトミックなタスクの取得（競合状態に安全）
ブロックされたエージェントが頻繁にポーリングする	wait_for_task — 依存関係が解消されるまでロングポーリング
コストのかかる複数ステップのワークフロー	execute_code — N 回の往復を 1 回の V8 呼び出しに集約
監査証跡がない	すべての execute_code 呼び出しに実行ログを記録
席数ベースの料金	x402 マイクロペイメント — USDC でタスクあたり $0.01、アカウント不要

トークンのコスト効率

標準的な MCP（データベース操作ごとにツールを 1 回呼び出す）：ワークフローあたり約 150,000 トークン

Forkit Code Mode（すべての操作を 1 回の execute_code 呼び出しにまとめる）：約 1,000 トークン

複雑な複数ステップのワークフローでは、トークンを最大 99% 削減できます。型定義はセッションごとに一度 search_api で取得され、エージェントによってキャッシュされます。

クイックスタート

1. MCP クライアントを接続する

登録は不要ですが、ヘッダーが必要です。 エージェント用に任意の安定した識別子（UUID、名前など）を選び、ゲストトークンとして送信してください。Forkit は初回の使用時に分離されたワークスペースを自動的に用意し、同じ識別子での以降の呼び出しにもそのワークスペースを返します。

{
  "mcpServers": {
    "forkit": {
      "url": "https://forkit-mcp.com/mcp",
      "headers": {
        "Authorization": "Guest my-agent-uuid"
      }
    }
  }
}

Claude Code：

claude mcp add forkit --transport http https://forkit-mcp.com/mcp \
  --header "Authorization: Guest my-agent-uuid"

ワークスペースは選択した識別子に紐づきます。タスク履歴を保持するには、セッションをまたいで同じ識別子を使用してください。ゲストワークスペースには、50 件の無料タスクが含まれます。

ダッシュボード付きの永続的なアカウントをお求めですか？ forkit-mcp.com にサインインして、完全な API キーを取得してください。

{
  "mcpServers": {
    "forkit": {
      "url": "https://forkit-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

2. 型定義を取得する（セッションごとに一度）

Call: search_api
→ Returns TypeScript type definitions for all codemode.* functions
→ Cache this response — it's ~1k tokens and doesn't change

3. 作業の追跡を開始する

// Call: execute_code
const project = await codemode.create_project({ name: "my-app" });

const task = await codemode.create_task({
  title: "Implement authentication",
  project_id: project.id,
  priority: "high"
});

// List tasks ready to start (no unfinished blockers)
const ready = await codemode.ready_tasks();

4. マルチエージェントで調整する

エージェント A が作業を作成し、エージェント B がアトミックに取得します。

// Agent A
await codemode.create_task({
  title: "Write tests for auth module",
  assignee: "test-agent"
});

// Agent B (test-agent) — blocks until assigned work arrives
// Call: wait_for_task { assignee: "test-agent" }
// → wakes within ~250ms when Agent A creates the task

---

エージェント間の引き継ぎデモ

2 つのエージェントがリアルタイムで連携します。refactor-agent がタスクを完了して KV wake 経由で test-agent に通知すると、ブロックが解除され、約 250ms で次のタスクを取得します。

---

MCP ツール

すべてのツールは標準の MCP 接続経由で呼び出されます。7 つのツールでシステム全体を操作できます。

ツール	説明
execute_code	実際の V8 アイソレートで非同期 JS を実行します。すべての DB 操作は codemode.* 経由です
search_api	codemode API の TypeScript 型定義を取得します
ready_tasks	ブロッカーがないタスクのトポロジカル順の保留セットです。エージェントの開始地点となります
claim_task	タスクをアトミックに割り当てます（競合状態に安全です）
wait_for_task	担当者に一致するタスクが利用可能になるまでロングポーリングします
summarize_session	現在のセッションを AI が要約し、R2 メモリに保存します
list_executions	最近の execute_code の監査記録を一覧表示します

完全なリファレンス：docs/tools.md

codemode.* API の完全なリファレンス：docs/codemode-api.md

---

マルチエージェントのパターン

完全な例については、docs/multi-agent.md をご覧ください。

トポロジカルスケジューリング： Forkit が依存関係グラフを解決します。ブロッカーがすべて done または cancelled になると、タスクが ready_tasks に表示されます。グラフ全体を最初に作成し、エージェントに作業を取得させます。

宛先指定の引き継ぎ： wait_for_task { assignee: "agent-name" } は、作業が届くまで待機します。起動までのレイテンシの中央値は約 250ms です。ポーリングループ、共有環境変数、処理に介在する人間は不要です。

アトミックなタスク取得： claim_task は条件付き DB 書き込みを使用します。2 つのエージェントが同時に競合した場合、必ず一方だけが成功し、もう一方はエラーを受け取って再試行します。作業の重複はありません。

---

料金

使用量	料金
ワークスペースあたり最初の 50 タスク	無料
50 タスクを超えた後の create_task	1 回あたり $0.01 USDC
summarize_session	1 回あたり $0.05 USDC
その他すべて	無料

支払いはエージェントネイティブです。エージェントの暗号資産ウォレットがその ID となります。クレジットカードもアカウントも不要です。Base L2 の USDC ウォレットだけで利用できます。

Forkit は x402 payment protocol を実装しています。エージェントにまだウォレットがない場合でも、評価中は最初の 50 タスクを無料で利用できます。

---

データモデル

Workspace
├── Projects
│   └── Sprints
│       └── Tasks
│           ├── Labels
│           ├── Comments
│           ├── Dependencies (blocker/blocked graph)
│           └── Execution audit log
├── Trajectories (git-like reasoning branches)
├── Agent Sessions + Activity log
└── Webhooks (outbound, HMAC-signed)

タスクのステータス：pending → in_progress → done | cancelled

すべてのデータはワークスペースごとに管理されます。テナント間のアクセスはありません。

---

アーキテクチャに関する注記

• Cloudflare Workers でホスト — グローバルエッジ、コールドスタートゼロ
• D1（SQLite）+ R2 — 構造化されたタスクデータとセッションメモリ
• V8 アイソレートのサンドボックス — execute_code は eval ではなく、実際の Worker アイソレートで実行されます
• ステートレスな MCP — リクエストごとに新しいサーバーインスタンスを作成します。WebSocket は不要です

---

サポート

• 問題や質問：github.com/zientesit/forkit-mcp-docs/issues
• ダッシュボード：forkit-mcp.com/workspace