ProductBrain

ProductBrain MCP サーバー

MCP クライアント — Claude Desktop、Cursor、Claude Code — から ProductBrain のプランを操作できます。検索、読み取り、変更、メソドロジーのワークフロー、ライブビューのためのツールを提供します。

設計 — 意図的に薄いシム

このサーバーは、ProductBrain のバージョン管理された v1 REST API を介する薄いトランスポートです。各ツールは、既存の /api/v1 エンドポイントを1回呼び出します。REST の契約が正式な基準となります。

• MCP 仕様が変わっても安定しています。依存する契約はプロトコルではなく、凍結された v1 API です。
• いつでも生の HTTP に切り替えたり、独自の LLM を利用したりできます。MCP は1つの窓口であり、唯一の窓口ではありません。
• レスポンスには、API が返すものと同じインバンドの _meta によるガイダンスが含まれるため、エージェントは自ら修正できます。

インストール

// Claude Desktop — claude_desktop_config.json
{
  "mcpServers": {
    "productbrain": {
      "command": "npx",
      "args": ["-y", "@productbrain-com/mcp"],
      "env": {
        "PRODUCTBRAIN_API_KEY": "pb_your_key",
        "PRODUCTBRAIN_PROJECT_ID": "your-project-id"
      }
    }
  }
}

# Claude Code
claude mcp add productbrain \
  -e PRODUCTBRAIN_API_KEY=pb_your_key \
  -e PRODUCTBRAIN_PROJECT_ID=your-project-id \
  -- npx -y @productbrain-com/mcp

Cursor などのクライアントでは、同じ command／args／env を指定した mcpServers エントリーを追加します。

設定（環境変数）

変数	必須	デフォルト
PRODUCTBRAIN_API_KEY	はい	—（アプリの API Key モーダルで取得した pb_ キー）
PRODUCTBRAIN_PROJECT_ID	いいえ	—（ツールは projectId 引数も受け付けます）
PRODUCTBRAIN_API_URL	いいえ	https://productbrain.com/api/v1

ツール

エージェント向けの /api/v1 エンドポイントには、それぞれツールがあります。1つのツールが1つのエンドポイントに対応し、同じ _meta のガイダンスがそのまま返されます。

プラン

ツール	対応先	用途
search	GET /search	セマンティック検索 — あらゆる検索で最初に使用
list_nodes	GET /nodes	一括読み取り、オプションでタイプ／イテレーションを絞り込み
get_tree	GET /tree	ノードのコンテキスト（祖先／兄弟／子／サブツリー）
mutate	POST /mutate	ノードとフェーズの作成／更新／削除。リトライを安全に行うには idempotencyKey を渡します
list_iterations	GET /iterations	フェーズ。アクティブなフェーズには current:true を指定
run_workflow	POST /workflow	ストーリーマッピング手法（add / task-curate / phase-assign）
export_okf	GET /export-okf	プランをポータブルな OKF ファイルバンドルとして出力
get_changelog	GET /changelog	プランの履歴：すべての追加／更新／削除／復元と、実行元のアプリまたは名前付きエージェント

ビュー

ツール	対応先	用途
set_view / read_view	POST /view-command, GET /view-state	ライブキャンバスを操作／読み取り

プロジェクト

ツール	対応先	用途
list_projects	GET /projects	所有またはメンバーとして参加しているプロジェクト。残りを含めるには includeArchived を指定
create_project	POST /mutate {addProject}	ブレインを初期化 — システムの「Later」フェーズを作成します。addProject は mutate が Idempotency-Key を読み取る前に実行されるため、明示的な id を渡してください。リトライには安全ではありません
rename_project	POST /mutate {renameProject}	表示名を変更。id は変更できません
archive_project	PATCH /projects	削除せずに非表示／再表示（元に戻せます）

Webhook

ツール	対応先	用途
list_webhooks	GET /webhooks	lastStatus 付きの登録済みフック — 失敗している受信先を確認
create_webhook	POST /webhooks	登録。署名シークレットは一度だけ返されます
update_webhook	PATCH /webhooks	URL／イベントを変更するか、rotateSecret:true を指定してシークレットをローテーション。削除して再作成するよりこちらを推奨
delete_webhook	DELETE /webhooks	登録を削除

共有リンク

ツール	対応先	用途
create_share_link	POST /share	公開読み取り専用リンクを発行。TTL には expiresInDays を指定
list_share_links	GET /share	発行されたすべてのトークンを active フラグ付きで監査
revoke_share_link	DELETE /share	漏えいしたリンクや古いリンクを無効化

メンバーと予算

ツール	対応先	用途
list_members	GET /members	プロジェクトの人間メンバーとエージェントシート
add_agent_seat	POST /members	エージェントシートを発行。pb_ キーは一度だけ返されます（Team ティア）
invite_contributor	POST /members	指定したプロジェクトに限定した、パスワード不要のゲスト招待（Team ティア）
revoke_member	DELETE /members	シートを削除。エージェントのキーは最後のメンバーシップとともに無効になります
tier_status	GET /tier-status	ティア、API アクセス、クレジット残高、上限 — 大規模な実行の前に確認
submit_feedback	POST /feedback	PB チームに改善点を伝える：機能リクエスト、使いづらさ、バグ、メモ

API リファレンス全文：https://productbrain.com/docs/llm-guide.md.

ソース、ライセンス、レジストリ

• ソース：https://github.com/moxzas/productbrain-mcp（MIT）。Issue とプルリクエストを歓迎します。
• npm：@productbrain-com/mcp。各リリースは、同じバージョン番号のリポジトリタグから公開されます。
• MCP レジストリ名：io.github.moxzas/productbrain（このリポジトリの server.json はレジストリマニフェストです）。
• サーバーは User-Agent: productbrain-mcp/<version> を送信するため、独自のログで MCP のトラフィックと生の REST 呼び出しを区別できます。

動作の確認

リポジトリには、実際のデプロイ環境に対して実行するヘッドレススクリプトが2つあります（src/spike-proof.ts、src/parity-proof.ts。npm パッケージには含まれません）。ご自身のアカウントで使い捨てのプロジェクトを使用してください。

PRODUCTBRAIN_API_KEY=pb_your_key \
PRODUCTBRAIN_PROJECT_ID=your-sandbox-project \
npm run spike     # transport + auth + one read + one write

PRODUCTBRAIN_API_KEY=pb_your_key \
npm run parity    # every non-plan tool once, on a throwaway project

parity は独自に使い捨てのプロジェクトを作成し、実行後にクリーンアップします（最後にアーカイブします。プロジェクトを削除するエンドポイントはありません）。

Team ティアのツール（add_agent_seat、invite_contributor）を Builder キーで呼び出すと、403 team_tier_required が返されます。これは合格として扱えますが、知っておくべき注意点が1つあります。シムが正しいルートに到達し、エラーとその _meta のヒントをそのまま渡したことは確認できますが、リクエストボディは検証されません。ティアのゲートはボディを読み取る前に実行されるためです。この2つを適切に確認するには、Team ティアのキーで parity を実行してください。