Docs
ドキュメント一覧
リファレンス

Waroom MCP サーバー

Claude から 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 のフルパスを指定してください。

環境変数

環境変数必須説明
WAROOM_API_KEY✅Waroom の API キー
WAROOM_BASE_URL-API のベース URL。未設定の場合は https://api.app.waroom.com/api/v0 が使用されます

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_update_service_architecture_contextアーキテクチャコンテキスト更新(無ければ新規作成)

ランブック関連ツール

ツール名機能
waroom_get_runbooksランブック一覧取得
waroom_get_runbookランブック詳細取得(namespace 指定)
waroom_update_runbookランブック更新(内容・namespace の変更)

ラベル管理ツール

ツール名機能
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. リソース

waroom://about

Waroom MCP の詳細な使い方ガイドを提供する MCP リソースです。インシデント対応の自動化、ポストモーテム管理、実際の使用シーン、トラブルシューティングなど、包括的な情報を日本語 Markdown で閲覧できます。

Claude Code または Claude Desktop で以下のように参照します。

@waroom:waroom://about

7. 注意事項

実験的プロジェクト: これは実験的なプロジェクトであり、安定性やパフォーマンスは保証されていません。

8. 関連リンク

解決しない場合は

まずは よくあるご質問 をご確認ください。それでも解決しない場合は、以下からお問い合わせください。

ご利用中のお客さま

[email protected]

導入をご検討中のお客さま

お問い合わせフォーム