Writbase - MCP Task Management for AI Agent Fleets

WritBase

AI エージェント群のための MCP ネイティブなタスク管理

AI エージェントと人間の監督者のためのコントロールプレーンです。スコープ付き権限、エージェント間の委任、完全な来歴を備えた永続的なタスクレジストリに、すべて MCP 経由でアクセスできます。

WritBase を選ぶ理由

AI エージェントには、セッション間で消えてしまう一時的なインメモリ状態ではなく、共有できる永続的なタスクレジストリが必要です。WritBase は、エージェント群に次の機能を提供します。

• 信頼できる唯一の情報源 — タスクはファイルやチャットスレッドに散在せず、Postgres に保存されます
• スコープ付き権限 — 各エージェントには、必要なアクセス権だけが付与されます
• 完全な来歴 — 変更のたびに、誰が、何を、いつ、なぜ行ったかが記録されます
• エージェント間の委任 — 深度制限と循環検出により、エージェント同士でタスクを割り当てられます
• MCP ネイティブ — エージェントは Model Context Protocol 経由で接続でき、カスタム連携は不要です

はじめに

オプション A：CLI でセットアップ（推奨）

リポジトリのクローンは不要です。npx を実行するだけです。

npx writbase init        # Interactive setup — configures Supabase credentials
npx writbase migrate     # Apply database schema
npx writbase key create  # Create your first agent key

これで完了です。MCP エンドポイントが次の場所で利用可能になります。

https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp

前提条件：Node 18 以降、Supabase CLI、Supabase プロジェクト（無料プランで利用できます）

Edge Function をデプロイします：npx supabase functions deploy mcp-server --no-verify-jwt

すべてのコマンドについては、CLI README をご覧ください。

オプション B：手動セットアップ

git clone https://github.com/Writbase/writbase.git
cd writbase && npm install

# Create a free project at supabase.com/dashboard, then:
npx supabase link --project-ref <your-project-ref>
npx supabase db push
npx supabase functions deploy mcp-server --no-verify-jwt

2. プロジェクトとエージェントキーを作成する

CLI（npx writbase key create）、ダッシュボード、またはマネージャーエージェントを使います。

1. プロジェクトを作成する — 例：my-app。任意で部門（backend、frontend、devops）を追加できます
2. エージェントキーを作成する — 名前を付け、worker ロールを選択し、キー（wb_<key_id>_<secret> — 表示は一度だけ）を保存します
3. 権限を付与する — writbase key permit my-agent --grant --project my-app --can-read --can-create --can-update を実行します（またはダッシュボードから設定します）

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

claude mcp add writbase \
  --transport http \
  --url https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp \
  --header "Authorization: Bearer wb_<key_id>_<secret>"

{
  "mcpServers": {
    "writbase": {
      "type": "streamableHttp",
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp",
      "headers": { "Authorization": "Bearer wb_<key_id>_<secret>" }
    }
  }
}

{
  "servers": {
    "writbase": {
      "type": "http",
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp",
      "headers": { "Authorization": "Bearer wb_<key_id>_<secret>" }
    }
  }
}

4. 使用する

エージェントに次のように依頼します。

"Check my WritBase permissions"          → calls info
"Create a task in my-app: Fix login bug" → calls add_task
"Mark it as in_progress"                 → calls update_task (with version for concurrency)
"Show all high priority tasks"           → calls get_tasks with priority filter

5. 拡張する

各エージェントには、必要な権限だけを付与した専用キーを割り当てます。

詳しい手順：スタートガイド — 権限、部門、トラブルシューティング

MCP ツール

Worker Tools（すべてのエージェント）

Manager Tools（マネージャーエージェントのみ）

特長

• マルチテナントワークスペース — サインアップ時に分離されたワークスペースが自動的にプロビジョニングされます
• 動的 MCP スキーマ — ツールの表示とパラメーターの列挙値は、エージェントの役割と権限に応じて変化します
• 6 種類の権限 — can_read、can_create、can_update、can_assign、can_comment、can_archive
• プロジェクトと部門のスコープ設定 — 権限は（プロジェクト、部門）の組み合わせごとに付与されます
• 楽観的同時実行制御 — バージョンベースの競合検出により、上書きが黙って発生するのを防ぎます
• カーソルページネーション — 大量のタスクを効率的にたどれます
• レート制限 — エージェントキーごとにリクエストを制限します
• リクエストログ — すべての MCP 呼び出しをレイテンシ、ステータス、エージェントコンテキストとともに記録します

アーキテクチャ

┌─────────────┐     ┌──────────────────┐     ┌──────────────┐
│  MCP Client │────▶│  Edge Function   │────▶│   Postgres   │
│  (Agent)    │◀────│  (Hono + MCP SDK)│◀────│  (Supabase)  │
└─────────────┘     └──────────────────┘     └──────────────┘
                           │
                    ┌──────┴──────┐
                    │  Next.js 16 │
                    │  Dashboard  │
                    └─────────────┘

• バックエンド：Supabase（Postgres ＋ Deno ランタイムを使用した Edge Functions）
• トランスポート：ストリーミング可能な HTTP（MCP SDK）
• フロントエンド：Next.js 16（App Router）＋ Tailwind CSS
• 認証：Supabase Auth（人間）＋ SHA-256 エージェントキー（エージェント）

デプロイオプション

詳しいセットアップ手順については、docs/deployment.md をご覧ください。

ドキュメント

• はじめに — デプロイ、エージェントキーの作成、MCP クライアントの接続、タスクの管理
• CLI リファレンス — npx writbase init、migrate、key、status
• デプロイガイド — Supabase Cloud、Vercel、セルフホストのセットアップ
• 基本概念 — 権限、プロベナンス、エラーコード、委任
• MCP 設定リファレンス — Claude Code、Cursor、VS Code、Windsurf 用のクライアント設定

コントリビューション

開発環境のセットアップ、テスト、PR のガイドラインについては、CONTRIBUTING.md をご覧ください。

セキュリティ

脆弱性の報告については、SECURITY.md をご覧ください。

ライセンス

Apache 2.0 — LICENSE をご覧ください。