メインコンテンツへスキップ

DoiT MCP サーバーの操作

このページでは、DoiT MCP サーバーの操作方法について、公開されているツールやプロンプト、推奨ワークフロー、使用例、トラブルシューティングを含めて説明します。

DoiT MCP サーバーは、ツールを DoiT developer API にマッピングします。ツール名と挙動は、オープンソースの @doitintl/doit-mcp-server パッケージに準拠しています。最新の一覧については、そのリポジトリを参照してください。

MCP プロンプト​

DoiT MCP サーバーは、MCP prompts specification で定義されているプロンプトを公開できます。プロンプトは、クライアントがプロンプトピッカーで一覧表示できる再利用可能なプレイブックです。一部のプロンプトは引数を受け取り、他のプロンプトは引数を受け取りません。

注意

次の例では、プレースホルダーの引数名（例：プロジェクト、クラウドアカウント、日付範囲）を使用しています。これらはクライアントによって異なる場合があります。レガシーの一部プロンプトは、プロンプト定義の標準化に伴い段階的に廃止されています。

例えば、特定の Google Cloud サービスの支出が 1 週間で急激に増加したとします。MCP クライアントには Review a cost spike for a cloud service. のようなプロンプトが表示されます。これを選択し、プロンプトで定義されている引数（サービス名、プロジェクト、開始日と終了日）を指定できます。サーバーは、モデルが DoiT MCP ツールを使用できるようにするプロンプトテキストを返します。例えば、get_anomaly または get_anomalies で期間を絞り込んでから、フォーカスした run_query を実行するか、get_report_results で保存済みレポートを取得し、主な要因とフォローアップの確認事項を要約するようガイドします。同じ考え方は、DoiT を通じてデータが利用できる場合、AWS やマルチクラウドのコストビューにも拡張されます。

クライアントは prompts/list でプロンプトを検出し、prompts/get で内容を取得します。ローカルの stdio 接続では、サーバーはプロンプト定義上の引数を含む標準的なプロンプトフローをサポートします。挙動はトランスポートやクライアントのバージョンによって異なる場合があります。クライアントでプロンプト処理の欠落や不正が報告される場合は、最新の @doitintl/doit-mcp-server を使用してください。

DoiT MCP サーバーツール​

DoiT MCP サーバーは、次のツールを提供します。

Alerts​

これらのツールを使用して、アカウントのコストアラートを作成・更新・確認します。

  • create_alert: 定義した閾値をクラウドコストが超えたときに通知する新しいアラートを作成。
  • get_alert: ID を指定して特定のアラートを返却。
  • list_alerts: アカウントがアクセスできるアラート一覧を返却。
  • update_alert: ID を指定して既存のアラートを更新。

アロケーション​

これらのツールを使用して、レポートおよびクエリ分析用のアロケーションルールを定義・管理します。

注釈​

これらのツールを使用して、レポートのコンテキスト用の注釈イベントを記録・管理します。

アノマリー​

これらのツールを使用して、検出されたコストのアノマリーを確認し、特定のアノマリーイベントを調査します。

  • get_anomalies: クラウドリソースで検出されたアノマリーを取得。
  • get_anomaly: ID を指定して特定のアノマリーの詳細を取得。

アセット​

これらのツールを使用して、顧客アセットを検出し、アセットレベルのメタデータを確認します。

  • get_asset: ID を指定して特定の顧客アセットの詳細を取得。
  • list_assets: Google Cloud の請求アカウント、Google Workspace サブスクリプション、および関連リソースなど、顧客アセットを一覧表示。

Ava​

このツールを使用して、Ava にアカウント固有の支出や最適化に関する質問を行います。

  • ask_ava_sync: アカウント、支出、または最適化について DoiT AVA に質問。複雑な質問の場合、回答に時間がかかることがあります。

予算​

これらのツールを使用して、支出目標を設定し、時間の経過に伴う予算の利用状況を追跡します。

  • create_budget: 実際のクラウド支出を予定支出と比較して追跡する新しい予算を作成。
  • get_budget: 指定した予算の詳細と現在の利用状況を返却。
  • list_budgets: ユーザーがアクセスできる予算一覧を返却。
  • update_budget: 既存の予算を更新。

Cloud Analytics​

これらのツールを使用して、アドホックなコスト・使用量クエリを実行し、保存されたレポートを管理し、利用可能なディメンションを探索します。

  • create_report: 特定の設定で新しい Cloud Analytics（クラウド分析）レポートを作成。
  • get_dimension: 種類と ID を指定して、特定の Cloud Analytics ディメンションを取得。
  • get_report_config: ID を指定して、特定の Cloud Analytics レポートの設定を取得。
  • get_report_results: ID を指定して、特定のレポートの結果を取得。
  • list_dimensions: アカウントがアクセスできる Cloud Analytics ディメンションを一覧表示。
  • list_reports: アカウントがアクセスできる Cloud Analytics レポートを一覧表示。
  • run_query: 設定を指定してレポートクエリを実行（結果は永続化しない）。クラウドコストの分析、コスト内訳の生成、支出トレンドの表示に使用。
  • update_report: 既存の Cloud Analytics レポートを更新。

Cloud diagrams​

このツールを使用して、特定のリソースに対する Cloud Diagrams ビューをすばやく開きます。

クラウド インシデント​

これらのツールを使用して、既知のクラウドプロバイダーのインシデントを監視し、インシデントの詳細を確認します。

  • get_cloud_incident: ID を指定して特定のクラウド インシデントの詳細を取得。
  • get_cloud_incidents: 各種プラットフォームからクラウド インシデントを取得。

CloudFlow​

このツールを使用して、MCP クライアントから直接 CloudFlow の実行を開始します。

  • trigger_cloud_flow: フロー ID と任意の JSON ペイロードを指定して CloudFlow をトリガー。

コミットメント​

これらのツールを使用して、コミットメント契約とその現在のパフォーマンスを確認します。

  • get_commitment: ID を指定して特定のコミットメントの詳細を返却。
  • list_commitments: コミットメント（リザーブドキャパシティまたは支出契約）の一覧を返却。

コスト分析ヘルパー​

これらは、一般的なコスト分析タスクを簡素化するための補助ツールです。MCP サーバーが提供するショートカットであり、API エンドポイントには紐づきません。

  • compare_spend: 2 つの期間の支出を比較。
  • cost_breakdown: 指定期間について、サービス・プロジェクト・その他のディメンション別のコスト内訳を取得。
  • cost_trend: 支出パターンを特定するために、時間の経過に伴うコストトレンドを表示。
  • get_cloud_overview: クラウド支出と主要メトリクスのハイレベルな概要を取得。

DataHub​

これらのツールを使用して、DataHub データセットを管理し、インジェストイベントを送信します。

インボイス​

これらのツールを使用して、インボイスを一覧表示し、詳細な請求レコードを深掘りします。

  • get_invoice: インボイス番号で指定したインボイスの詳細全体を取得。
  • list_invoices: 組織の現在および過去のすべてのインボイスを一覧表示。

ラベル​

これらのツールを使用して、ラベルを作成し、リソース全体のラベル割り当てを管理します。

  • assign_objects_to_label: オブジェクトをラベルに割り当てまたは割り当て解除します。
  • create_label: 名前と色を指定してラベルを作成します。
  • get_label: ID でラベルの詳細を取得します。
  • get_label_assignments: ラベルに割り当てられているオブジェクトを一覧表示します。
  • list_labels: アクセス可能なラベルを一覧表示します。
  • update_label: ラベルの名前または色を更新します。

最適化インサイト​

これらのツールを使用して、最適化の機会と、各インサイトに関連付けられたリソースを見つけます。これらのツールは MCP サーバーによって提供されるショートカットであり、API エンドポイントにはリンクしていません。

  • get_insight_resources: 特定の最適化インサイトに関連付けられたリソースを取得します。
  • list_optimization_recommendations: クラウドリソースに対する最適化の推奨事項を一覧表示します。

プロダクト​

これらのツールを使用して、アカウントコンテキストで利用可能なプラットフォームとプロダクトを参照します。

  • list_platforms: 利用可能なプラットフォームを一覧表示します。
  • list_products: 各プラットフォームで利用可能なプロダクトを、必要に応じてプラットフォーム名でフィルタリングして一覧表示します。

セッションツール​

これらのツールを使用して、セッションコンテキストを制御し、影響の大きい操作を確認します。これらのツールは MCP サーバーによって提供されるショートカットであり、API エンドポイントにはリンクしていません。

  • change_customer: アカウントが複数のカスタマーにアクセスできる場合、MCP コンテキストを別のカスタマーに切り替えます。
  • confirm_action: 機密性が高い、または破壊的な可能性がある操作を実行する前に、明示的な確認を要求します。

サポートリクエスト​

これらのツールを使用して、サポートチケットを確認し、チケットのスレッドを管理します。

  • create_ticket_comment: 既存のサポートリクエストにコメントを追加します。
  • get_ticket: ID で特定のサポートリクエストの詳細を取得します。
  • list_ticket_comments: サポートリクエスト上のコメントを一覧表示します。
  • list_tickets: サポート API を使用してサポートリクエストを一覧表示します。

ユーザーとロール​

これらのツールを使用して、組織のユーザー、招待、およびロールの割り当てを管理します。

  • invite_user: 新しいユーザーを組織に招待します。
  • list_organizations: 組織の一覧を返します。
  • list_roles: すべての IAM ロールの一覧を返します。
  • list_users: 組織内のすべてのユーザーの一覧を返します。
  • update_user: ユーザー情報を更新します。
  • validate_user: 現在の API ユーザーを検証し、ドメインとメールアドレス情報を返します。

一般的なワークフロー​

これらのパターンは、AI アシスタントが最小限かつ信頼できるツールシーケンスを使用できるようにするためのものです。

レポートと保存済みレポート​

  1. セッションの対象アカウントまたはテナントを確認する必要がある場合は、必要に応じて validate_user を呼び出します。
  2. ユーザーがダッシュボードまたは定期レポートの名前を指定した場合、list_reports を呼び出して保存済みレポートを探します。
  3. レポート ID が分かったら get_report_results を呼び出します。

既存の保存済みレポートで質問に回答できる場合は、run_query よりもこの経路を優先してください。

アドホック分析クエリ​

  1. グループ化またはフィルターフィールドが不明確な場合は、list_dimensions を呼び出します。
  2. 絞り込まれたクエリを構築してから、run_query を呼び出します。
  3. 最初の結果が広すぎる場合は、クエリを調整して再実行します。

コストのアノマリー​

  1. 直近または上位のアノマリーには get_anomalies を使用し、ユーザーがすでに ID を持っている場合は get_anomaly を使用します。
  2. 他のデータソースと組み合わせる前に、アノマリーからクラウド、アカウントまたはプロジェクト、時間範囲、サービスを使用します。

使用例​

注意

DoiT MCP サーバーが提供する出力と推奨事項は動的に生成され、クエリに応じて変化する場合があります。実装前に、組織のセキュリティベストプラクティス、コスト効率目標、およびコンプライアンス要件に合致していることを確認するために、すべての出力・推奨事項を十分に確認してください。

AI ツールは、他の MCP サーバーと統合されている場合があります。意図した結果を得るためには、DoiT MCP サーバー向けに関連するコンテキスト情報を含めてリクエストを作成する必要があります。一般的なクエリの例としては、「コストが高い順に上位 3 つの AWS サービスは何ですか」「最近のコストのアノマリーは何ですか」「Monthly Cost Overview レポートの結果を表示して」「すべての請求書を一覧表示して」などがあります。

さらに、DoiT Cloud Intelligence データに関する質問やリクエストを行う際には、ディープリサーチを利用できます。これにより、請求書、コストのアノマリー、リソースなどについて MCP サーバーがより詳細なインサイトを提供できます。Claude でこれを行うには、次のようにします。

  1. 例えば次のように尋ねます：「直近のアノマリーを 3 つ教えて」

  2. 一覧が表示されたら、返信プロンプトで Research を選択します。

  3. 返信プロンプトで、より詳細な情報を求めます。例えば：「3 番 — Cloud run のアノマリー — 2025 年 6 月 18 日について調査して。原因は何か。どのくらいの頻度で発生しているか。再発防止策は？」Claude がそのアノマリーについて詳細な調査を行います。

認可とセキュリティ​

  • リモートコネクタ（ブラウザ内の Claude や ChatGPT など）の場合: クライアントに認可ステップが表示されます。そこで DoiT API キー を入力します。Connect ChatGPT および Connect Claude を参照してください。

  • ローカルの stdio クライアント（Cursor や Gemini CLI など）の場合: クライアント設定で DOIT_API_KEY を構成します。キーは MCP サーバープロセスを介して、あなたのマシンから DoiT API に送信されます。

  • アクセス制御: MCP 呼び出しはあなたの API アイデンティティを使用し、DoiT コンソールのパーミッションに従います。接続するには Required permissions で説明されているアクセス権が必要です。API キー以外に、各ツールはその基盤となる操作について DoiT developer API の認可モデルに従います。操作レベルの要件については API reference を参照してください。

  • 運用上の衛生管理: API キーを共有したり、ソースコード管理にコミットしたりしないでください。漏洩した可能性がある場合はキーをローテーションしてください。組織内でロールやアクセス権が変更された場合は、再接続または統合の再テストを行ってください。

トラブルシューティング​

症状確認事項
コネクタまたは認証ウィンドウが開かないブラウザのポップアップブロッカー、企業プロキシ、OAuth や組み込みフローをブロックする拡張機能。サイトを許可したうえで再試行してください。
ofid_ 参照を伴う Authorization with the MCP server failedofid_ 参照は（Claude や ChatGPT などの）AI クライアントからの識別子であり、DoiT のエラーコードではありません。
  1. DoiT API キー が有効で有効期限切れでないことを確認してください。削除して再作成してみてください。
  2. 組織のプランに DoiT API アクセスが含まれていることを確認してください。
  3. ユーザーアカウントに Billing Profiles Admin パーミッションが付与されていることを確認してください。
認証が失敗するAPI キーが誤っているか、取り消されています。
期待するリソースに対してアクセス拒否またはデータが空になる対象データに対する Billing Profiles Admin などの必要なコンソールパーミッションがユーザーにありません。
接続はできるが、多くのツールが AI クライアントに表示されない一部の Web ベース MCP コネクタは、ツールのサブセットのみを公開します。最も広範なツール一覧を利用するには、@doitintl/doit-mcp-server を使用したローカル stdio セットアップ（Connections を参照）を推奨します。
予期しないツールエラー使用しているツールについて API reference を確認してください。パラメータやクオータは直接の API 呼び出しと同様に適用されます。
Claude Cowork でインラインウィジェットがレンダリングされないインラインウィジェットのレンダリング（Cloud Analytics チャートなど）にはリモート MCP サーバー接続（SSE）が必要です。ローカルの stdio 接続はウィジェットメタデータをサポートしません。リモートサーバー経由で接続していることを確認してください。ウィジェットがレンダリングされない場合でも、ツール結果はテキストとして正しく返されます。
に最終更新