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

MCP サーバーを操作する

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

MCP サーバーはツールを DoiT developer API にマッピングします。ツール名と動作は、オープンソースの @doitintl/doit-mcp-server パッケージに準拠します。接続後は、MCP クライアントを使用して、サーバーが現在公開しているツールを一覧表示してください。利用可能なツールは、サーバーのバージョンや権限によって変わる場合があります。

MCP プロンプト​

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

注意

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

たとえば、特定の Google Cloud サービスの支出が 1 週間で急増したとします。MCP クライアントには、クラウドサービスのコストスパイクを確認する のようなプロンプトが表示されます。それを選択し、プロンプトで定義されている引数（サービス名、プロジェクト、開始日と終了日）を指定できます。サーバーは、モデルが MCP ツールを使用できるように案内するプロンプトテキストを返します。例えば、get_anomaly や get_anomalies で期間を絞り込んだうえで、フォーカスした run_query を実行するか、get_report_results で保存済みレポートを取得し、想定される要因と追跡調査を要約するようモデルを誘導します。同じ考え方は、DoiT から利用できるデータに応じて、AWS やマルチクラウドのコストビューにも拡張できます。

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

一般的なワークフロー​

以下のパターンにより、AI assistant が最小限かつ信頼性の高いツールの組み合わせを使用できるようになります。

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

  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. 他のデータソースと組み合わせる前に、そのアノマリーのクラウド・アカウントまたはプロジェクト・時間範囲・サービスを使用します。

利用例​

注意

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

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

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

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

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

  3. 返信プロンプトで、より詳細な情報を依頼します。例：「3 番目 — Cloud Run アノマリー — 2025 年 6 月 18 日について調査してください。原因は何か。どれくらいの頻度で発生しているか。再発防止の方法は何か。」Claude はそのアノマリーについて詳細な調査を行います。

認可とセキュリティ​

  • Streamable HTTP： ブラウザベースの DoiT サインインおよび同意フロー、または ヘッドレスクライアント 向けにベアラーヘッダーとして送信される personal API token を使用します。ローカル stdio： DOIT_API_KEY による personal API token で認証し、OAuth は使用しません。詳細は Connection methods を参照してください。クライアント別の手順は Client examples を参照してください。

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

  • 運用上の衛生管理：組織内でロールやアクセス権が変更された場合は、統合を再接続または再テストしてください。stdio の場合、必要に応じて API トークンを再作成またはスコープし直してください。

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

症状確認事項
コネクタまたは認証ウィンドウが開かないStreamable HTTP の場合：ブラウザのポップアップブロッカー、企業プロキシ、OAuth や埋め込みフローをブロックしている拡張機能を確認してください。サイトを許可したうえで再試行してください。ローカル stdio はブラウザを開かないため、代わりに DOIT_API_KEY が設定されていることを確認してください。
Authorization with the MCP server failed と ofid_ 参照が表示されるofid_ 参照は（Claude や ChatGPT などの）AI クライアントの識別子であり、DoiT のエラーコードではありません。
  1. 組織のプランに DoiT API アクセスが含まれていることを確認します。
  2. サインアウトしてから再度サインインし、接続を再試行します。
  3. 使用したいツールに必要な権限がユーザー（または API トークン）に付与されていることを確認します。API reference を参照してください。
認証に失敗する（HTTP）サインインが完了していないか、セッションが期限切れです。ブラウザのサインインフローを再試行してください。API トークンヘッダーで接続している場合は、トークンが有効であり、組織内のユーザーに属していることを確認してください。DoiT スタッフアカウントのトークンは受け付けられません。
認証に失敗する（stdio）DOIT_API_KEY が存在しない、無効、期限切れ、または @doitintl/doit-mcp-server を起動するプロセスから参照できません。クライアント構成で環境変数の値を確認し、必要に応じて personal API token を再作成してください。
期待されるリソースに対してアクセス拒否またはデータが空になるサインインしているユーザーまたは API トークンに、その API 操作に必要な DoiT コンソールの権限がありません。API reference と token scope を確認してください。
接続はできているが、AI クライアントに多くのツールが表示されない一部の Web ベース MCP コネクタは、ツールのサブセットのみを公開します。非推奨の legacy SSE エンドポイントを使用していないことを確認してください。クライアントに対応する別の connection method を試すか、全ツール一覧を読み込めるクライアントを使用してください。
予期しないツールエラーが発生する使用しているツールに対応する API reference を確認してください。パラメータやクォータは、直接の API 呼び出しと同様に適用されます。
Claude Cowork でインラインウィジェットがレンダリングされないインラインウィジェット（Cloud Analytics のチャートなど）のレンダリングには、ホストされたリモート MCP サーバー接続が必要です。ローカルの stdio 接続はウィジェットメタデータをサポートしません。リモートサーバー経由で接続していることを確認してください。ウィジェットのレンダリングが利用できない場合でも、ツールの結果はテキストとして正しく返されます。
に最終更新