DoiT MCP サーバーを使用する

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

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

MCP プロンプト

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

注意

次の例では、プレースホルダーの引数名（例：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 サーバーツール

ツールは領域ごとにグループ化されています。それぞれの名前は、リクエストおよびレスポンスの詳細を示す API リファレンスにリンクされています。

クラウド インシデントとアノマリー

• get_cloud_incidents: 各種プラットフォームからクラウド インシデントを取得します。
• get_cloud_incident: ID を指定して特定のクラウド インシデントの詳細を取得します。
• get_anomalies: クラウドリソースで検出されたアノマリーを取得します。
• get_anomaly: ID を指定して特定のアノマリーの詳細を取得します。

資産、CloudFlow、および Cloud Diagrams

• list_assets: Google Cloud 請求先アカウント、Google Workspace サブスクリプションなどの顧客資産や関連リソースを一覧表示します。
• get_asset: ID を指定して特定の顧客資産の詳細を取得します。
• trigger_cloud_flow: フロー ID を指定して CloudFlow をトリガーし、任意で JSON ペイロードを渡します。
• find_cloud_diagrams: 指定したリソース ID に対する Cloud Diagrams の URL を返します。

Cloud Analytics レポートとディメンション

• list_reports: アカウントがアクセスできる Cloud Analytics レポートを一覧表示します。
• run_query: 指定した設定でレポートクエリを実行します（永続化はしません）。
• get_report_results: ID を指定して特定レポートの結果を取得します。
• get_report_config: ID を指定して特定の Cloud Analytics レポートの設定を取得します。
• create_report: 新しい Cloud Analytics レポートを作成します。
• update_report: 既存の Cloud Analytics レポートを更新します。
• validate_user: 現在の API ユーザーを検証し、ドメインとメールアドレス情報を返します。
• list_dimensions: アカウントがアクセスできる Cloud Analytics ディメンションを一覧表示します。
• get_dimension: 種類と ID を指定して特定の Cloud Analytics ディメンションを取得します。

サポートリクエスト

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

インボイスとアロケーション

• list_invoices: 組織の現在および過去のインボイスを一覧表示します。
• get_invoice: インボイス番号を指定してインボイスの詳細を取得します。
• list_allocations: レポートまたはクエリ設定で利用可能なアロケーションを一覧表示します。
• get_allocation: ID を指定して特定のアロケーションを取得します。
• create_allocation: 新しいアロケーションを作成します。
• update_allocation: 既存のアロケーションを更新します。

アラート、予算、アノテーション、およびコミットメント

• list_alerts: アカウントがアクセスできるアラートを一覧表示します。
• get_alert: ID を指定して特定のアラートを取得します。
• create_alert: コスト閾値に対するアラートを作成します。
• update_alert: 既存のアラートを更新します。
• list_budgets: アクセス可能な予算を一覧表示します。
• get_budget: 予算の詳細と利用状況を取得します。
• create_budget: 予算を作成します。
• update_budget: 既存の予算を更新します。
• list_annotations: アカウントがアクセスできるアノテーションを一覧表示します。
• get_annotation: ID を指定して特定のアノテーションを取得します。
• create_annotation: 任意でレポートやラベルとの関連付けを行うアノテーションを作成します。
• update_annotation: 既存のアノテーションを更新します。
• list_commitments: コミットメント（リザーブドキャパシティや支出コミットメント）を一覧表示します。
• get_commitment: 期間や達成状況を含むコミットメントの詳細を取得します。

Ava

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

組織、ユーザー、およびロール

• list_organizations: 認証済みユーザーが利用できる組織を一覧表示します。
• list_users: 組織内のユーザーを一覧表示します。
• update_user: ユーザープロファイルのフィールドおよびロールを更新します。
• invite_user: 任意でロールと組織を指定し、メールでユーザーを招待します。
• list_roles: プリセットおよびカスタムを含む IAM ロールを一覧表示します。

プロダクト

• list_platforms: 利用可能なプラットフォームを一覧表示します。
• list_products: プラットフォームごとに利用可能なプロダクトを一覧表示し、任意でプラットフォーム名でフィルタリングします。

DataHub

• list_datahub_datasets: 顧客向けの DataHub データセットを一覧表示します。
• get_datahub_dataset: 名前を指定してデータセットの詳細を取得します。
• create_datahub_dataset: DataHub データセットを作成します。
• update_datahub_dataset: データセットの説明を更新します。
• send_datahub_events: 取り込み用イベントを送信します（API リファレンスに定義された制限が適用されます）。

ラベル

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

一般的なワークフロー

これらのパターンは、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 anomaly — 2025 年 6 月 18 日を調査して。原因は何か、どれくらいの頻度で発生しているか、再発防止の方法は何か」といった質問をします。Claude がそのアノマリーについて詳細な調査を実行します。

認可とセキュリティ

• リモートコネクタ（例：ブラウザー上の Claude または ChatGPT）：クライアントに認可ステップが表示されます。そこで DoiT API key を入力します。Connect ChatGPT および Connect Claude を参照してください。

• ローカル STDIO クライアント（例：Cursor または Gemini CLI）：クライアント設定で DOIT_API_KEY を設定します。このキーは MCP サーバープロセスを通じて、あなたのマシンから DoiT API に送信されます。

• アクセス制御：MCP 呼び出しはあなたの API アイデンティティを使用し、DoiT コンソールの権限に従います。接続するには、Required permissions で説明されているロールが必要です。データおよび変更を伴うツールについても、きめ細かな API および製品のルールが適用されます。

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

トラブルシューティング

症状	確認事項
コネクタまたは認証ウィンドウが開かない	ブラウザーのポップアップブロッカー、企業プロキシ、OAuth や埋め込みフローをブロックする拡張機能を確認してください。サイトを許可したうえで再試行してください。
認証に失敗する	API キーが間違っている、または失効しています。
期待したリソースのデータが空、またはアクセス拒否になる	ユーザーに、そのデータに必要な Billing Profiles Admin またはその他のコンソール権限がありません。
接続はできているが、AI クライアントで多くのツールが表示されない	一部の Web ベース MCP コネクタでは、カタログが大きい場合にツールのサブセットのみが公開されます。より多くのツールを利用するには、@doitintl/doit-mcp-server を使用したローカル STDIO セットアップ（Connections を参照）を利用することを推奨します。
予期しないツールエラーが発生する	使用しているツールについて API reference を確認してください。パラメーターおよびクォータは、直接の API 呼び出しと同様に適用されます。