ProjectBrain MCP について
ProjectBrain MCPは、ProjectBrainでプロジェクト情報を管理するチーム向けの、計画・実行用MCPサーバーです。タスク、決定事項、事実、マイルストーン、コメント、チームメッセージのツールをStreamable HTTPで提供し、実行とデータアクセスにはベアラートークン認証を使います。
主な機能
- 01タスクとマイルストーンの管理
- 02決定事項と事実のツール
- 03コメントとチームメッセージ
- 04Streamable HTTPエンドポイント
- 05ベアラートークン認証
活用シーン
- 01プロジェクトのタスクとマイルストーン管理
- 02プロジェクトの決定事項や事実の記録
- 03コメントやチームメッセージの共有
MCP 対応
Streamable HTTPエンドポイントを通じて、MCPクライアントにProjectBrainのツールを提供します。探索リクエストは認証不要ですが、ツール実行とデータアクセスにはベアラートークンが必要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
エンドポイント
https://mcp.projectbrain.toolsインストールコマンドをコピー
Claude CodeTerminal
claude mcp add --transport http projectbrain https://mcp.projectbrain.toolsCursor.cursor/mcp.json
{"mcpServers":{"projectbrain":{"type":"http","url":"https://mcp.projectbrain.tools"}}}Cursor で開くVS Code.vscode/mcp.json
{"servers":{"projectbrain":{"type":"http","url":"https://mcp.projectbrain.tools"}}}VS Code で開くClaude Desktopclaude_desktop_config.json
{"mcpServers":{"projectbrain":{"type":"http","url":"https://mcp.projectbrain.tools"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"projectbrain":{"serverUrl":"https://mcp.projectbrain.tools"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
すべてのエンドポイント
Streamable HTTP
https://mcp.projectbrain.tools認証が必要ツール
6| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| action | string | いいえ | コンテキスト操作：session、summary、changes、search、または shortlist。 |
| project_id | any | いいえ | session／summary／changes／search 操作で使用するプロジェクト UUID。 |
| since | any | いいえ | changes 操作で結果の範囲を限定する ISO-8601 タイムスタンプ。 |
| q | any | いいえ | search／shortlist 操作で使用する検索クエリ。 |
| limit | integer | いいえ | リスト形式のコンテキスト操作で返す最大件数。 |
| full_tool_mode | boolean | いいえ | true の場合、shortlist は上位候補のみではなく、操作カタログ全体を含みます。 |
| task_id | any | いいえ | コンテキストに応じた知識検索に使用する任意のタスク UUID。 |
| intent | any | いいえ | セマンティックな知識検索に使用する任意のユーザー意図。 |
| knowledge_limit | integer | いいえ | intent が指定された場合に返すナレッジ項目の最大数。 |
| response_mode | string | いいえ | 出力形式：human、json、または both（対応している場合）。 |
詳細
ProjectBrain MCP
ProjectBrain MCP は、プロジェクトの計画と実行のワークフロー向けの Model Context Protocol（MCP）サーバーです。 Streamable HTTP エンドポイントを通じて、タスク、決定事項、事実、マイルストーン、コメント、チームメッセージング用のツールを提供します。
提供する機能
https://mcp.projectbrain.toolsの HTTPS 経由で MCP ツールを提供しますinitialize、notifications/initialized、ping、tools/list、resources/list、resources/templates/list、prompts/listに対する未認証の MCP 検出リクエストを許可します- すべてのツール実行とデータアクセスで、Bearer トークン（JWT または API キー）を認証します
- MCP OAuth メタデータのエンドポイントを提供します
- ProjectBrain API に対してツールのアクションを実行します
サービスのエンドポイント
GET /healthGET /.well-known/oauth-protected-resourceGET /.well-known/oauth-authorization-serverPOST /
設定
以下の環境変数を設定します。
SERVER_URL（デフォルト：http://localhost:8000）
ProjectBrain API のベース URL です。MCP_SERVER_URL（デフォルト：SERVER_URLと同じ）
OAuth リソースメタデータで使用する公開ベース URL です。JWT_SECRET_KEY
JWT Bearer トークンの検証に使用するシークレットです。JWT_ALGORITHM（デフォルト：HS256）CORS_ORIGINS（デフォルト：["http://localhost:5173"]）
JSON 配列またはカンマ区切りリストを指定できます。MCP_REQUEST_TIMEOUT_SECONDS（デフォルト：30）MCP_UNAUTH_DISCOVERY_METHOD_SCAN_BYTES（デフォルト：8192）
軽量ミドルウェアの解析で JSON-RPC のmethodを検出するためにスキャンする、未認証リクエストの最大バイト数です。SENTRY_DSN
MCP サービスのエラー／パフォーマンスレポートに使用する Sentry DSN です。SENTRY_TRACES_SAMPLE_RATE（デフォルト：0.2）
sentry_sdk.initに渡すトレースのサンプルレートです。SENTRY_SEND_DEFAULT_PII（デフォルト：false）
MCPIntegrationでより詳細な MCP リクエスト／レスポンスのコンテキストを含めるには、trueに設定します（有効にする前に、データ収集への影響を確認してください）。SENTRY_ENVIRONMENT（任意）
Sentry の環境タグです（例：production、staging）。
ローカル開発
リポジトリのルートから実行します。
- バックエンドの依存関係をインストールします。
cd api && uv sync --locked
- MCP サーバーを起動します。
PYTHONPATH=mcp api/.venv/bin/uvicorn api_adapter:app --app-dir mcp --host 0.0.0.0 --port 8001
ディレクトリ構成
api_adapter.py— FastAPI アプリのエントリーポイントと認証ミドルウェアserver.py— MCP ツールの定義と HTTP クライアントアダプターruntime.py— ランタイム設定とリクエストごとの認証コンテキスト
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。