前提条件
- CloudThinker に参照させたいプロジェクトへのアクセスがある Rollbar アカウント。
- 各プロジェクトのプロジェクトアクセストークン(調査には読み取りスコープで十分)。
- アイテム状態の更新をエージェントに行わせたい場合のみ、書き込みスコープのトークン(承認ゲート)。
Rollbar のトークンはプロジェクトごとにスコープされます。CloudThinker は 1 つの接続で複数のプロジェクトをサポートします。含めたいプロジェクトごとに 1 つのトークンを入力してください。
セットアップ
プロジェクトアクセストークンを作成する
Rollbar でプロジェクトを開き、read スコープのプロジェクトアクセストークンを作成(またはコピー)します。アイテムを更新させたい場合は write スコープのトークンも追加してください。トークンと設定の詳細については Rollbar の MCP Server Setup を参照してください。
接続の詳細
| フィールド | 説明 | 例 |
|---|---|---|
| ROLLBAR_CONFIG_JSON | 各 Rollbar プロジェクトをアクセストークンにマッピングする projects 配列。各エントリに name と token が含まれる | 以下参照 |
トークンフィールドは
token(access_token ではない)で、projects は配列です。フォーマットは Rollbar の MCP マルチプロジェクト設定に準拠しています。必要な権限
読み取り操作(プロジェクト一覧、アイテム、上位エラー、デプロイ、バージョン、リプレイ)はread スコープのプロジェクトアクセストークンで機能します。アイテム更新にはwrite スコープのトークン および CloudThinker での明示的な承認が必要です。エージェントの機能
接続後、エージェントは設定されたプロジェクト全体でエラーの調査と対応を行えます。読み取り機能
| カテゴリ | エージェントができること |
|---|---|
| プロジェクト | 設定済みの Rollbar プロジェクトを一覧表示し、単一プロジェクトに自動スコープする |
| エラーアイテム | 現在のアクティブアイテムを一覧表示し、アイテムの詳細と発生シグナルを調査する |
| 上位エラー | 最も影響の大きいエラーと現在の本番エラーの状態を表示する |
| デプロイ | プロジェクトごとの最近のデプロイをレビューする |
| リリースとバージョン | バージョンコンテキストを取得し、リリースとエラーアクティビティを相関付ける |
| セッションリプレイ | 記録済みリプレイを持つアイテムのリプレイコンテキストを取得する |
書き込み機能
| カテゴリ | エージェントができること |
|---|---|
| アイテム更新 | アイテムの状態を変更する(例: 解決、ミュート)— 承認が必要 |
接続の確認
プロンプト例
トラブルシューティング
認証が失敗するかクエリが空で返る
認証が失敗するかクエリが空で返る
貼り付けたプロジェクト設定が無効な JSON か、リクエストされたプロジェクト名が含まれていないか、プロジェクトが期限切れのトークンにマッピングされています。アイテムやデプロイが「データなし」として扱う前に、まず設定済みプロジェクトを一覧表示してください。
エージェントがどのプロジェクトを使用するか確認してくる
エージェントがどのプロジェクトを使用するか確認してくる
複数のプロジェクトが設定されている場合に発生します。エージェントがクエリをスコープできるよう、プロンプトにプロジェクト名を指定してください(例: 「my-app の場合」)。
アイテムにリプレイが存在しない
アイテムにリプレイが存在しない
セッションリプレイコンテキストは記録済みリプレイを持つアイテムにのみ存在します。リプレイのないアイテムはリプレイデータを返しません。これは予期された動作であり、エラーではありません。
アイテム更新がブロックされる
アイテム更新がブロックされる
更新は承認ゲートであり、write スコープのトークンが必要です。そのプロジェクトのトークンに書き込みスコープがあることを確認し、プロンプトが表示されたらアクションを承認してください。
セキュリティ
- 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
- デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
- 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
- オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
- 最小権限のトークン — 調査には読み取りスコープのプロジェクトトークンを使用し、エージェントがアイテム状態を更新する必要があるプロジェクトにのみ書き込みスコープを追加してください。
- ローテーション — プロジェクトアクセストークンを定期的にローテーションし、CloudThinker で更新してください。
関連情報
Datadog 接続
ログ、メトリクス、インシデント調査
承認
承認ゲートアクションの仕組み