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

DoiT MCP サーバーを操作する

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

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

MCP プロンプト​

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

注意

次の例では、プレースホルダーの引数名（例：project、cloud account、date range）を使用しています。これらはクライアントによって異なる場合があります。プロンプト定義の標準化に伴い、一部の従来のプロンプトは段階的に廃止されています。

たとえば、特定の 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 で指定した既存のアラートを更新します。

Allocations​

これらのツールを使用して、レポートやクエリアナリティクス用のアロケーションルールを定義・管理します。

  • create_allocation：新しいアロケーションを作成します。
  • get_allocation：ID で指定したアロケーションを取得します。
  • list_allocations：レポートまたは run_query の設定に使用するアロケーション一覧を取得します。
  • update_allocation：既存のアロケーションを更新します。

Annotations​

これらのツールを使用して、レポートのコンテキストとなるアノテーションイベントを記録・維持します。

Anomalies​

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

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

Assets​

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

  • get_asset：ID で指定した特定の顧客アセットの詳細を取得します。
  • list_assets：Google Cloud billing accounts、Google Workspace のサブスクリプション、および関連リソースなどの顧客アセットを一覧表示します。

Ava​

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

  • ask_ava_sync：アカウント、支出、または最適化に関する質問を DoiT AVA に送信します。複雑な質問は回答に時間がかかる場合があります。

Budgets​

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

  • 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 ビューをすばやく開きます。

  • find_cloud_diagrams：指定したリソース ID に対する Cloud Diagrams の URL を返します。

Cloud incidents​

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

  • get_cloud_incident：ID で指定した特定のクラウド インシデントの詳細を取得します。
  • get_cloud_incidents：さまざまなプラットフォームからクラウド インシデントを取得します。

CloudFlow​

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

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

Commitments​

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

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

Cost analysis helpers​

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

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

DataHub​

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

Invoices​

これらのツールを使用して、請求書を一覧表示し、詳細な請求レコードをドリルダウンします。

  • 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 サーバーに関連するコンテキスト情報を含めてリクエストを記述するようにしてください。よくあるクエリの例としては、「コストが高い AWS サービス上位 3 つは何ですか」「直近のコストのアノマリーは何ですか」「Monthly Cost Overview レポートの結果を表示」「すべての請求書を一覧表示」などがあります。

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

  1. 例えば「直近のアノマリー 3 件は何ですか？」と質問します。

  2. 一覧が返ってきたら、返信プロンプトで Research を選択します。

  3. 返信プロンプトで、より詳細な情報を依頼します。例えば「3 番目 ― Cloud run のアノマリー ― 2025 年 6 月 18 日について調査してください。原因は何ですか？どの程度の頻度で発生していますか？再発防止策は何ですか？」といった質問をします。Claude がそのアノマリーについて詳細な調査を行います。

認可とセキュリティ​

  • リモートコネクタ（例: ブラウザ内の Claude または ChatGPT）: クライアントが OAuth フローを開始します。ブラウザで DoiT のサインインページが開くので、サインインし、使用する顧客アカウントを選択して接続を承認します。Connect ChatGPT および Connect Claude を参照してください。

  • ローカルの stdio クライアント（例: Cursor または Gemini CLI）: 資格情報なしで、クライアント設定に DoiT MCP サーバーを追加します。クライアントがサーバーを起動すると、同じブラウザによるサインインおよびアカウント選択フローがローカルマシン上で実行されます。

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

  • 運用上の衛生管理: 組織内でロールやアクセス権が変更された場合は、再接続するか統合を再テストしてください。

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

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