datadog

Datadog MCP サーバー

「値はいくつか」だけでなく、「なぜこうなっているのか」に答える Datadog MCP です。

5～7 回の連続した API 呼び出しを、1 つの構造化されたレスポンスにまとめる集約ツールを搭載しています。SLO の完全な CRUD。フリート自動化。あらゆる MCP の中で最も幅広い Datadog API カバレッジを備え、@us-all MCP standard に基づいて 163 個のツール を実装しています。

他にはない機能

• 集約ツール — analyze-monitor-state と slo-compliance-snapshot は、5～7 回の連続した API 呼び出しを、部分的な失敗を示す caveats 配列付きの 1 つの構造化されたレスポンスにまとめます。このパターンを備えた Datadog MCP は他にありません。
• SLO の完全な CRUD — SLO（およびその補正）の作成、更新、削除ができます。公式の Bits AI MCP やコミュニティの代替製品では、SLO は読み取り専用です。
• フリート自動化 — デプロイとスケジュールにまたがる 15 個のツールを備えています。このサーバーだけの機能です。
• ステータスページ — ステータスページのライフサイクル全体（コンポーネント、劣化、メンテナンス）に対応する 21 個のツールを備えています。このサーバーだけの機能です。
• トークン効率を考慮した設計 — extractFields による投影、16 カテゴリを切り替える DD_TOOLS／DD_DISABLE、メタツール search-tools により、163 個のツール全体で LLM のコンテキストを小さく保ちます。
• Apps SDK カード — ChatGPT クライアントでは、_meta["openai/outputTemplate"] を使って slo-compliance-snapshot をビジュアルカードとして表示します。Claude クライアントには、同じ JSON コンテンツが返されます（互換性を損なう変更はありません）。
• stdio + Streamable HTTP — デフォルトは stdio（Claude Desktop／Code）です。ChatGPT Apps SDK またはリモートクライアントを使う場合は、MCP_TRANSPORT=http を設定します（MCP_HTTP_TOKEN による Bearer 認証）。

試してみましょう — 5 つのプロンプト

サーバーを Claude Desktop または Claude Code に接続して、以下のいずれかを貼り付けてください。

1. SLO の健全性 — 「SLO の一覧と、今月残っているエラーバジェットを表示してください。準拠、リスクあり、違反のステータス別にグループ化してください。」
2. インシデントのトリアージ — 「checkout-service でアクティブなインシデントが発生しています。関連付けられたモニター、APM で最近発生したエラーの急増、過去 24 時間にこのサービスに影響したデプロイを取得してください。」
3. モニターのノイズ監査 — 「過去 7 日間に 10 回を超えてアラートを発し、MTTR が 5 分未満だったモニターを探してください。これらはおそらくフラッピングしています。」
4. RUM エラーの急増 — 「今日の 14:00 から 14:30 にかけて、チェックアウトファネルで RUM のエラー率が急上昇しました。主なエラーグループ、影響を受けたセッション、エラー発生前のユーザーアクションを表示してください。」
5. フリートのロールアウト — 「datadog-agent 7.55.0 のロールアウトを staging クラスターにスケジュールしてください。毎週末のみ実施し、次の土曜日に開始してください。」

公式 Datadog MCP ではなく、こちらを使う場合

Datadog 公式 MCP（Bits AI MCP、GA 2026-03-09）は置き換えではなく、相互補完するものです。

	公式 Datadog MCP	@us-all/datadog-mcp（本プロジェクト）
ツール数	16 以上のコアツールセット	API 全体をカバーする 163 個のツール
デプロイ	リモート（Datadog が管理）	stdio でセルフホスト（npx / Docker / npm）
認証	Datadog SSO	API + APP キー
サイト	公開 Datadog サイト	社内サイトやソブリンサイトを含む、あらゆるサイト。デフォルトは US5
SLO の書き込み	❌	✅ SLO の作成／更新／削除と修正
フリート自動化	❌	✅ 15 個のツール
ステータスページ	❌	✅ 21 個のツール
集計ツール	❌	✅ analyze-monitor-state、slo-compliance-snapshot
MCP プロンプト	❌	✅ 4 個（triage-incident、audit-monitor-noise、analyze-rum-error-spike、investigate-slow-trace）
MCP リソース	❌	✅ dd://service/{serviceName}、dd://team/{teamId}、dd://synthetics/{testId} など

素早く管理されたオンボーディングと SSO が必要な場合は、公式 Bits AI MCP を使用してください。API 全体のカバレッジ、SLO／フリート／ステータスページの書き込み機能、またはセルフホスト（社内サイト、隔離ネットワーク、開発／CI サンドボックス）が必要な場合は、こちらを使用してください。

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": ["-y", "@us-all/datadog-mcp"],
      "env": {
        "DD_API_KEY": "<your-api-key>",
        "DD_APP_KEY": "<your-app-key>",
        "DD_SITE": "datadoghq.com"
      }
    }
  }
}

Claude Code

claude mcp add datadog -s user \
  -e DD_API_KEY=<your-api-key> -e DD_APP_KEY=<your-app-key> -e DD_SITE=datadoghq.com \
  -- npx -y @us-all/datadog-mcp

Docker

docker run -e DD_API_KEY=... -e DD_APP_KEY=... -e DD_SITE=datadoghq.com \
  ghcr.io/us-all/datadog-mcp-server:latest

ソースからビルド

git clone https://github.com/us-all/datadog-mcp-server.git
cd datadog-mcp-server && pnpm install && pnpm build
node dist/index.js

設定

変数	必須	デフォルト	説明
DD_API_KEY	✅	—	Datadog API キー
DD_APP_KEY	✅	—	Datadog Application キー
DD_SITE	❌	us5.datadoghq.com	Datadog サイト（下の表を参照）
DD_ALLOW_WRITE	❌	false	true に設定すると変更（作成／更新／削除）が有効になります
DD_TOOLS	❌	—	カテゴリのカンマ区切り許可リスト。指定したカテゴリのみ読み込まれます。トークンを最も節約できます。
DD_DISABLE	❌	—	カテゴリのカンマ区切り拒否リスト。DD_TOOLS が設定されている場合は無視されます。
MCP_TRANSPORT	❌	stdio	Streamable HTTP トランスポートを有効にするには http を指定します
MCP_HTTP_TOKEN	条件付き	—	ベアラートークン。MCP_TRANSPORT=http の場合に必須です
MCP_HTTP_PORT	❌	3000	HTTP リッスンポート
MCP_HTTP_HOST	❌	127.0.0.1	HTTP バインドホスト（localhost では DNS リバインディング保護が自動的に有効になります）
MCP_HTTP_SKIP_AUTH	❌	false	ベアラー認証をスキップします。認証を処理するリバースプロキシの背後に配置する場合などに使用します

カテゴリ（16 個）：metrics、monitors、dashboards、logs、apm、rum、incidents、security、synthetics、ci、infra、fleet、status-pages、oncall、teams、account。

MCP_TRANSPORT=http の場合：POST /mcp（ベアラー認証付き JSON-RPC）と GET /health（公開 liveness）。

サイト：

サイト	値	リージョン
US1	datadoghq.com	米国（バージニア州）
US3	us3.datadoghq.com	米国（バージニア州）
US5	us5.datadoghq.com	米国（オレゴン州）
EU1	datadoghq.eu	EU（フランクフルト）
AP1	ap1.datadoghq.com	アジア太平洋（東京）

トークン効率

単純な設定では、会話を始める前に約 25K トークン分のツールスキーマが読み込まれます。次の 3 つの方法で削減できます。

シナリオ	ツール数	スキーマトークン	デフォルト比
デフォルト（全カテゴリ）	163	25,200	—
一般的な設定（DD_TOOLS=metrics,monitors,logs,apm,dashboards）	55	9,300	−63%
限定設定（DD_TOOLS=metrics,monitors）	24	3,800	−85%

1. カテゴリの切り替え — DD_TOOLS=metrics,monitors,logs,apm（最大の効果があります）。
2. extractFields によるレスポンスの射影 — get-dashboard { dashboardId: "abc", extractFields: "id,title,widgets.*.definition.type" }。
3. search-tools メタツール — 常に有効です。すべてのスキーマを事前に読み込む代わりに、実行時に LLM がツールを見つけられるようにします。

読み取り専用モード

AI エージェントによる意図しない変更を防ぐため、デフォルトではすべての書き込みがブロックされます。以下を使用するには DD_ALLOW_WRITE=true が必要です。

create-monitor、update-monitor、delete-monitor、mute-monitor、create-dashboard、update-dashboard、delete-dashboard、send-logs、post-event、trigger-synthetics、create-synthetics-test、update-synthetics-test、delete-synthetics-test、create-downtime、cancel-downtime、create-case、update-case-status、send-dora-deployment、send-dora-incident、create-slo、update-slo、delete-sloに加え、フリート／ステータスページ／セキュリティ関連のすべての書き込み操作。

MCP プロンプト（4）

モデルが直接呼び出せるワークフローテンプレートです。

• triage-incident — インシデント ID を指定すると、関連するモニター、直近のエラー急増、最近のデプロイをたどります。
• audit-monitor-noise — アラート頻度 × MTTR に基づいて、状態が頻繁に変わるモニターを検出します。
• analyze-rum-error-spike — 2 つの期間の RUM エラー率を比較し、主なエラーグループに原因を特定します。
• investigate-slow-trace — 遅いトレース ID を指定すると、スパンツリーをたどり、ボトルネックとなっているスパンを明らかにします。

MCP リソース

URI で指定する読み取り専用エンティティ：dd://monitor/{id}、dd://dashboard/{id}、dd://slo/{id}、dd://incident/{id}、dd://service/{serviceName}、dd://team/{teamId}（チーム＋メンバー）、dd://synthetics/{testId}、dd://host/{name}。

ツールリファレンス

16 カテゴリにわたる 163 個のツールがあります。実行時にツールを見つけるには search-tools メタツールを使用してください。全リストは以下に折りたたまれています。

ドメイン	ツール数
ステータスページ	21
RUM（イベント＋アプリ＋メトリクス＋保持）	27
メトリクス、ホスト、SLO、ダウンタイム、コンテナ、プロセス	19
フリート自動化	15
Synthetics、ログ／スパンのメトリクス、SLO 補正	16
モニター、ダッシュボード、ノートブック、イベント	16
インシデント、ケース、エラートラッキング、監査	13
オンコール、チーム、ユーザー、サービス、ボット	11
セキュリティシグナル＋ルール＋抑制	9
APM、CI 可視性、DORA、ネットワークデバイス	9
＋集計	analyze-monitor-state、slo-compliance-snapshot
＋メタ	search-tools

全ツール一覧（クリックして展開）

メトリクス（5）

query-metrics、get-metrics、get-metric-metadata、list-active-metrics、list-metric-tags

モニター（7）

get-monitors、get-monitor、create-monitor、update-monitor、delete-monitor、mute-monitor、validate-monitor、analyze-monitor-state (集計)

ダッシュボード（5）

get-dashboards、get-dashboard、create-dashboard、update-dashboard、delete-dashboard

ログ（3）

search-logs、aggregate-logs、send-logs

イベント（2）

get-events、post-event

インシデント（6）

get-incidents、get-incident、search-incidents、create-incident、update-incident、delete-incident

APM（1）

search-spans

RUM（17）

search-rum-events、aggregate-rum、list-rum-applications、get-rum-application、create-rum-application、update-rum-application、delete-rum-application、list-rum-metrics、get-rum-metric、create-rum-metric、update-rum-metric、delete-rum-metric、list-rum-retention-filters、get-rum-retention-filter、create-rum-retention-filter、update-rum-retention-filter、delete-rum-retention-filter

SLO（6）

list-slos、get-slo、get-slo-history、create-slo、update-slo、delete-slo、slo-compliance-snapshot (集計)、および SLO 補正ツール 5 個

Synthetics（6）

list-synthetics、get-synthetics-result、trigger-synthetics、create-synthetics-test、update-synthetics-test、delete-synthetics-test

ホスト／コンテナ／プロセス（4）

list-hosts、get-host-totals、list-containers、list-processes

ダウンタイム（3）

list-downtimes、create-downtime、cancel-downtime

### セキュリティ（9） `search-security-signals`、`get-security-signal`、`list-security-rules`、`get-security-rule`、`delete-security-rule`、`list-security-suppressions`、`get-security-suppression`、`create-security-suppression`、`delete-security-suppression`

CI の可視性（4）

search-ci-pipelines、aggregate-ci-pipelines、search-ci-tests、aggregate-ci-tests

ケース（4）

list-cases、get-case、create-case、update-case-status

エラートラッキング（2）

list-error-tracking-issues、get-error-tracking-issue

DORA（2）

send-dora-deployment、send-dora-incident

ネットワークデバイス（2）

list-network-devices、get-network-device

ノートブック（2）

list-notebooks、get-notebook

オンコール（2）

get-team-oncall、get-oncall-schedule

サービスとソフトウェアカタログ（2）

list-services、get-service-definition

チーム（6）

list-teams、get-team、create-team、update-team、delete-team、get-team-members

アカウントとユーザー（2）

get-usage-summary、list-users

ログ／スパン／APM 保持メトリクス（15）

logs-metrics、spans-metrics、apm-retention-filters それぞれに5つ（list/get/create/update/delete）

ステータスページ（21）

ページ、コンポーネント、劣化、メンテナンスの全ライフサイクルに対応します。src/tools/status-pages.ts を参照してください。

フリート自動化（15）

エージェント、デプロイ、スケジュールに対応します。src/tools/fleet.ts を参照してください。

監査（1）

search-audit-logs

メタ（1）

search-tools — キーワードでほかのツールを検索します。DD_TOOLS の設定にかかわらず、常に有効です。

アーキテクチャ

Claude → MCP stdio → index.ts → tools/*.ts → @datadog/datadog-api-client → Datadog API

@us-all/mcp-toolkit を基盤に構築されています。

• extractFields — トークン効率に優れたレスポンスの射影
• aggregate(fetchers, caveats) — 集約ツール向けのファンアウトヘルパー
• createWrapToolHandler — ドメイン固有の機密情報のマスキング（DD_API_KEY/DD_APP_KEY）と、Datadog ApiException のエラー抽出
• search-tools メタツール

技術スタック

Node.js 22+ • TypeScript strict ESM • pnpm • @modelcontextprotocol/sdk • @datadog/datadog-api-client（公式）• zod • dotenv • vitest + dd-trace。

コントリビューション

CONTRIBUTING.md を参照してください。新しい共有パターンは @us-all/mcp-toolkit に追加してください。これは7つのサーバーからなるスイートの信頼できる唯一の情報源です。

ライセンス

MIT