DoiT MCP Server

DoiT MCP サーバー

DoiT MCP サーバーは、DoiT API へのアクセスを提供します。このサーバーを使うと、Claude などの LLM が DoiT プラットフォームのデータにアクセスして、トラブルシューティングや分析を行えます。

認証

認証方法は、接続方法によって異なります。

方法	URL／コマンド	認証
リモート（Streamable HTTP）	https://mcp.doit.com/mcp	OAuth — クライアントに DoiT のサインインと同意のページが表示されます。ヘッドレスクライアントは代わりに、顧客の個人用 API トークンを Authorization: Bearer として送信できます。
ローカル（stdio）	npx -y @doitintl/doit-mcp-server@latest	DOIT_API_KEY による個人用 API トークン。

従来の SSE エンドポイント（https://mcp.doit.com/sse）は非推奨のため、新しいセットアップでは使用しないでください。

DoiT プランに API アクセスが含まれている必要があります。ツールの権限はDoiT APIと同じです。

ツールの結果は、レスポンスの整形後に、構造化コンテンツとメタデータを含めて、シリアライズされた UTF-16 コード単位で 140,000 個までに制限されます。上限を超える読み取りでは、対処方法を示すエラーが返されます。完了した書き込みでは簡潔な成功レシートが返されます。出力を取得するためだけに、書き込みを繰り返さないでください。エラーはエラーのまま返されます。これはレスポンスサイズに関するポリシーであり、トークン制限でも、上流からのダウンロードサイズの上限でもありません。

ディスパッチされた各呼び出しは、ペイロードを含まない JSON の mcp_tool_response イベントを stdio の stderr に出力します。一部のクライアントでは、これらのログが表示されます。ホストは onResponseMetrics を指定して、イベントの送信先を変更できます。レスポンスサイズのパーセンタイルには original.serializedChars を、上限超過率には exceededLimit を使用してください。returned はガード適用後の結果を示します。メトリクスには、UTF-8 のバイト数、所要時間、ツール／クライアント、処理結果も含まれますが、ツールの引数やレスポンス本文は含まれません。

以下の Claude Desktop の手順は一例であり、サポートされているクライアントはこれだけではありません。Cursor、VS Code、Amazon Q、Claude Code などについては、接続ガイドをご覧ください。

リモート（Streamable HTTP）

Claude Desktop の例：カスタムコネクター（+ → Add connector → Add custom connector）を追加し、リモート MCP サーバーの URL に https://mcp.doit.com/mcp を設定します。プロンプトが表示されたら、DoiT にサインインしてください。

ヘッドレスクライアント（API トークン）

ブラウザーを開けないエージェント（たとえば、クラスター上の HolmesGPT、CI ジョブ、cron ワーカー）は、顧客の個人用 API トークンをベアラーヘッダーとして送信することで、同じエンドポイントに認証できます。ツールは、そのトークンの権限で実行され、stdio の場合と同じです。DoiT の従業員用トークンはリモートエンドポイントでは受け付けられません。従業員は OAuth またはローカルサーバーを使用してください。

HolmesGPT の例：

mcp_servers:
  doit:
    description: "DoiT Cloud Intelligence"
    config:
      url: "https://mcp.doit.com/mcp"
      mode: streamable-http
      headers:
        Authorization: "Bearer {{ env.DOIT_API_KEY }}"
      health_check_tool: "validate_user"

トークンはシークレットストアに保管し、定期的にローテーションしてください。設計上の説明はdocs/remote-api-key-bearer-auth.mdをご覧ください。

ローカル（stdio）

互換性のあるクライアントでは、MCP 経由のスキルをサポートしています。デフォルトでは、スキルはバンドルされていません。

Node.js v20 以降と、DOIT_API_KEY として設定する個人用 API トークンが必要です。DoiT コンソールの個人用 API トークンページからトークンを作成してください。

Claude Desktop の例 — claude_desktop_config.json（または Settings）に以下を追加し、Claude を再起動します。

{
  "mcpServers": {
    "doit_mcp_server": {
      "command": "npx",
      "args": ["-y", "@doitintl/doit-mcp-server@latest"],
      "env": {
        "DOIT_API_KEY": "your_doit_api_key"
      }
    }
  }
}

• DOIT_API_KEY：DoiT API トークン（必須）
• CUSTOMER_CONTEXT：顧客コンテキスト識別子（任意）

サポートされている MCP プロトコルのバージョン

stdio サーバーは、設定なしで両方の世代の MCP プロトコルを使用するクライアントに対応しています。

• 2024-10-07 から 2025-11-25 まで。initialize ハンドシェイクを通じて対応します。
• 2026-07-28。server/discover を通じて対応します。

各接続で最初に送信されるメッセージにより、使用する世代が決まります。詳しくは、docs/protocol-compatibility.md と、互換性を検証するテストをご覧ください。

ローカルリポジトリへのクローン

ソースコードからこの MCP サーバーを直接クローンして実行する場合は、次の手順に従ってください。

1. リポジトリをクローンする

git clone https://github.com/doitintl/doit-mcp-server
cd doit-mcp-server

2. 依存関係をインストールする

yarn install

3. プロジェクトをビルドする

yarn build

4. サーバーを実行する

DOIT_API_KEY=your_doit_api_key node dist/index.js

コアパッケージ API

独自の MCP トランスポートを提供するアプリケーションでは、公開されているトランスポートに依存しない実装を再利用できます。

npm install @doitintl/doit-mcp-server@latest

import {
    COVERED_ENDPOINTS,
    executeToolHandler,
    generateTools,
    generatedToolsOpenApiSpec,
    HAND_WRITTEN_TOOLS,
} from "@doitintl/doit-mcp-server/core";

/core エントリには、ツールとプロンプトの定義、生成ツール用のユーティリティ、リクエスト処理、共有設定 API が含まれます。stdio トランスポートの初期化や、Cloudflare Worker、OAuth、Durable Objects、ウィジェットの実装は含まれません。

使用例

DoiT MCP サーバーを使用して尋ねられる一般的な質問をいくつか紹介します。

コスト分析と節約

• 「Flexsave の節約額はいくらですか？」 — クラウドアカウント全体の Flexsave によるコスト最適化の節約額を分析します。
• 「コストが上位 3 位の AWS サービスは何ですか？」 — Cloud Analytics クエリを実行して、支出額が最も多い AWS サービスを特定します。

レポートと分析

• 「利用可能なレポートをすべて一覧表示してください」 — アクセスできる Cloud Analytics レポートをすべて表示します。
• 「『月次コスト概要』レポートの結果を表示してください」 — 指定したレポートの結果を取得して表示します。

異常検知

• 「最近の GCP の異常を教えてください」 — Google Cloud Platform アカウントで検出された、最近のコストまたは使用量の異常を表示します。
• 「異常 ABC123 の詳細を表示してください」 — 特定の異常に関する詳細情報を表示します。

請求書

• 「請求書をすべて一覧表示してください」 — 組織の現在および過去の請求書をすべて表示します。
• 「請求書 INV-2024-001 の詳細を表示してください」 — 明細項目や支払い状況など、特定の請求書の詳細をすべて表示します。

これらの例は、基本的な使用パターンを示しています。必要に応じて、これらの質問を組み合わせたり変更したりできます。MCP サーバーは自然言語の質問を解釈し、適切なツールを使用して要求された情報を取得します。

環境変数

ローカルの stdio サーバーで使用します。リモートの /mcp 接続では OAuth 認証を使用します。

• DOIT_API_KEY：DoiT の 個人 API トークン（stdio では必須）
• CUSTOMER_CONTEXT：顧客コンテキスト識別子（任意）