Waroom MCP サーバー
Claude から Waroom の機能にアクセスするための MCP サーバーです。
1. 概要
Waroom MCP サーバーは、Waroom v0 API と連携するための Model Context Protocol (MCP) サーバーです。このサーバーを使用することで、Claude から直接 Waroom のインシデント管理、ポストモーテム、サービス管理などの機能にアクセスできます。
2. 主要機能
インシデント管理
- インシデントの作成・取得・詳細表示
- インシデント重要度・ステータスの更新
- インシデントメトリクス(TTD/TTA/TTI/TTF/TTR)の管理
- インシデントラベルの付与・更新
ポストモーテム
- ポストモーテムの一覧取得・作成
- ポストモーテムテンプレートの取得
サービス管理
- サービス一覧の取得
- サービスのアーキテクチャコンテキスト取得
- サービスラベルの管理(作成・更新・削除)
3. セットアップ方法
前提条件
- Waroom API キーが必要です
- Claude Code または Claude Desktop での利用が可能です
Claude Code での設定
claude mcp add waroom-mcp --env WAROOM_API_KEY=your-api-key -- npx @topotal/waroom-mcp
注意: nodenv や nvm を使用している場合は、
npxのフルパスを指定してください。
Claude Desktop での設定
設定ファイルの場所:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
設定内容:
{
"mcpServers": {
"waroom-mcp": {
"command": "npx",
"args": ["@topotal/waroom-mcp"],
"env": {
"WAROOM_API_KEY": "your-api-key"
}
}
}
}
設定後、Claude Desktop を再起動してください。
4. 利用可能なツール
インシデント関連ツール
| ツール名 | 機能 |
|---|---|
waroom_create_incident | インシデントの作成 |
waroom_get_incidents | インシデント一覧取得 |
waroom_get_incident_details | インシデント詳細取得 |
waroom_update_incident_severity | 重要度の更新 |
waroom_update_incident_status | ステータスの更新 |
waroom_create_incident_metrics | メトリクス作成 |
waroom_update_incident_labels | ラベルの更新 |
ポストモーテム関連ツール
| ツール名 | 機能 |
|---|---|
waroom_get_postmortems | ポストモーテム一覧取得 |
waroom_create_postmortem | ポストモーテムの作成 |
waroom_get_postmortem_template | テンプレート取得 |
サービス関連ツール
| ツール名 | 機能 |
|---|---|
waroom_get_services | サービス一覧取得 |
waroom_get_service_architecture_context | アーキテクチャコンテキスト取得 |
ラベル管理ツール
| ツール名 | 機能 |
|---|---|
waroom_get_service_labels | サービスラベル一覧取得 |
waroom_create_service_label | サービスラベルの作成 |
waroom_update_service_label | サービスラベルの更新 |
waroom_delete_service_label | サービスラベルの削除 |
5. スラッシュコマンド(Claude Code)
/mcp__waroom_mcp__create
インシデント対応を開始し、作業内容を自動追跡するコマンドです。
- サービスの自動検索
- インシデントの自動作成
- 作業内容の自動追跡
/mcp__waroom_mcp__respond
既存のインシデントに対応するためのコマンドです。
- UUID/URL からインシデント詳細を取得
- ステータスの自動更新
- 作業内容の自動追跡
create と respond の違い: create はサービス選択→インシデント作成→対応、respond は既存インシデント取得→対応(作成なし)です。
6. 注意事項
実験的プロジェクト: これは実験的なプロジェクトであり、安定性やパフォーマンスは保証されていません。