Datadog MCP サーバー

Datadog API と対話するためのモデルコンテキストプロトコル (MCP) サーバー。

特徴

監視: 監視データと構成にアクセスします
ダッシュボード: ダッシュボードの定義を取得して表示する
メトリクス: 利用可能なメトリクスとそのメタデータを照会する
イベント: 時間枠内でイベントを検索して取得する
ログ: 高度なフィルタリングと並べ替えオプションを使用してログを検索します
インシデント: インシデント管理データにアクセスする
API統合: Datadogのv1およびv2 APIとの直接統合
包括的なエラー処理: APIおよび認証の問題に関する明確なエラーメッセージ
サービス固有のエンドポイント: ログとメトリックのさまざまなエンドポイントのサポート

Related MCP server: Currents

前提条件

Node.js (バージョン 16 以上)
Datadog アカウント:
- APIキー - 組織設定 > APIキーにあります
- アプリケーションキー - 組織設定 > アプリケーションキーにあります

インストール

npm経由（推奨）

npm install -g datadog-mcp-server

ソースから

このリポジトリをクローンする
依存関係をインストールします:
```
npm install
```
プロジェクトをビルドします。
```
npm run build
```

構成

環境変数またはコマンドライン引数を使用して、Datadog MCP サーバーを構成できます。

環境変数

Datadog の認証情報を使用して.envファイルを作成します。

DD_API_KEY=your_api_key_here
DD_APP_KEY=your_app_key_here
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com
DD_METRICS_SITE=datadoghq.com

注: DD_LOGS_SITEとDD_METRICS_SITEはオプションであり、指定されていない場合はデフォルトでDD_SITEの値になります。

コマンドライン引数

グローバルサイト設定による基本的な使用方法:

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.eu

サービス固有のエンドポイントを使用した高度な使用法:

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.com --logsSite=logs.datadoghq.com --metricsSite=metrics.datadoghq.com

注: サイト引数にはhttps://必要ありません。自動的に追加されます。

地域エンドポイント

Datadog のリージョンごとにエンドポイントが異なります。

米国（デフォルト）： datadoghq.com
EU: datadoghq.eu
US3（GovCloud）： ddog-gov.com
US5: us5.datadoghq.com
AP1: ap1.datadoghq.com

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<YOUR_API_KEY>",
        "--appKey",
        "<YOUR_APP_KEY>",
        "--site",
        "<YOUR_DD_SITE>(e.g us5.datadoghq.com)"
      ]
    }
  }
}

ログとメトリックに別々のエンドポイントを持つより高度な構成の場合:

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<YOUR_API_KEY>",
        "--appKey",
        "<YOUR_APP_KEY>",
        "--site",
        "<YOUR_DD_SITE>",
        "--logsSite",
        "<YOUR_LOGS_SITE>",
        "--metricsSite",
        "<YOUR_METRICS_SITE>"
      ]
    }
  }
}

Claude Desktop 構成ファイルの場所:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

MCP Inspector での使用

MCP Inspector ツールで使用するには:

npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key

利用可能なツール

サーバーは次の MCP ツールを提供します。

get-monitors : オプションのフィルタリングを使用してモニターを取得します
get-monitor : IDで特定のモニターの詳細を取得する
get-dashboards : すべてのダッシュボードを一覧表示する
get-dashboard : IDで特定のダッシュボードを取得する
get-metrics : 利用可能なメトリックの一覧を取得する
get-metric-metadata : 特定のメトリックのメタデータを取得する
get-events : 時間範囲内のイベントを取得する
get-incidents : オプションのフィルタリングを使用してインシデントを一覧表示する
search-logs : 高度なクエリフィルタリングによるログの検索
集計ログ: ログデータの分析と集計を実行する

例

例: モニターを取得する

{
  "method": "tools/call",
  "params": {
    "name": "get-monitors",
    "arguments": {
      "groupStates": ["alert", "warn"],
      "limit": 5
    }
  }
}

例:ダッシュボードを取得する

{
  "method": "tools/call",
  "params": {
    "name": "get-dashboard",
    "arguments": {
      "dashboardId": "abc-def-123"
    }
  }
}

例: 検索ログ

{
  "method": "tools/call",
  "params": {
    "name": "search-logs",
    "arguments": {
      "filter": {
        "query": "service:web-app status:error",
        "from": "now-15m",
        "to": "now"
      },
      "sort": "-timestamp",
      "limit": 20
    }
  }
}

例: 集計ログ

{
  "method": "tools/call",
  "params": {
    "name": "aggregate-logs",
    "arguments": {
      "filter": {
        "query": "service:web-app",
        "from": "now-1h",
        "to": "now"
      },
      "compute": [
        {
          "aggregation": "count"
        }
      ],
      "groupBy": [
        {
          "facet": "status",
          "limit": 10,
          "sort": {
            "aggregation": "count",
            "order": "desc"
          }
        }
      ]
    }
  }
}

例: インシデントの取得

{
  "method": "tools/call",
  "params": {
    "name": "get-incidents",
    "arguments": {
      "includeArchived": false,
      "query": "state:active",
      "pageSize": 10
    }
  }
}

トラブルシューティング

403 Forbidden エラーが発生した場合は、次の点を確認してください。

APIキーとアプリケーションキーは正しいです
キーには要求されたリソースにアクセスするために必要な権限があります
あなたのアカウントは要求されたデータにアクセスできます
地域に適したエンドポイントを使用していること（例：EU のお客様の場合はdatadoghq.eu ）

デバッグ

問題が発生した場合は、Claude Desktop の MCP ログを確認してください。

# On macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# On Windows
Get-Content -Path "$env:APPDATA\Claude\Logs\mcp*.log" -Tail 20 -Wait

よくある問題:

403 Forbidden: Datadog API キーの認証問題
APIキーまたはアプリキーの形式が無効です: 完全なキー文字列を使用していることを確認してください
サイト構成エラー: 正しい Datadog ドメインを使用していることを確認してください
エンドポイントの不一致: ログとメトリックに別々のドメインを使用している場合は、サービス固有のエンドポイントが正しく設定されていることを確認します。

ライセンス

マサチューセッツ工科大学

datadog mcp