Datadog MCP Server

Datadog MCP Server

Сервер Datadog MCP — это легковесная серверная реализация, которая предоставляет API мониторинга, панелей инструментов, метрик, логов и управления инцидентами Datadog в виде стандартизированных инструментов MCP. Это позволяет приложениям и агентам на основе LLM безопасно взаимодействовать с ресурсами Datadog и выполнять динамические операции через Протокол Контекста Модели.

Author: GeLi2001


Просмотреть протокол

Что такое сервер Datadog MCP?

Сервер Datadog MCP — это специализированный сервер Протокола Контекста Модели (MCP), который служит мостом между AI-агентами или приложениями на основе LLM и API Datadog. Он предоставляет набор инструментов MCP, связанных с возможностями мониторинга, метрик, панелей инструментов, событий, логов и управления инцидентами Datadog. Это позволяет стандартизированным, безопасным и динамическим взаимодействиям с данными Datadog, поддерживая упрощенные рабочие процессы, автоматическое решение проблем и улучшенные задачи наблюдаемости из системы AI.

Как настроить

Чтобы настроить сервер Datadog MCP, вам необходимо:

  • Node.js (версия 16+)
  • Ключи API и приложения Datadog

1. Настройте учетные данные с использованием переменных окружения:

Создайте файл .env:

DD_API_KEY=ваш_api_ключ_здесь
DD_APP_KEY=ваш_app_ключ_здесь
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com   # необязательно
DD_METRICS_SITE=datadoghq.com   # необязательно

ИЛИ

2. Укажите учетные данные в виде аргументов командной строки:

datadog-mcp-server --apiKey=ваш_api_ключ --appKey=ваш_app_ключ --site=datadoghq.com
  • Для мульти-региональных или сервисно-специфичных доменов используйте --logsSite и --metricsSite по мере необходимости.
  • Если вы подключаетесь с Claude Desktop, запишите конфигурацию в claude_desktop_config.json (расположение различается в зависимости от ОС). Используйте либо глобальный сайт, либо укажите logsSite/metricsSite для более детальной настройки.

Как использовать

  1. Установка

    npm install -g datadog-mcp-server

    Или запустите напрямую через npx.

  2. Запустите сервер

    datadog-mcp-server --apiKey=ВАШ_API_КЛЮЧ --appKey=ВАШ_APP_КЛЮЧ --site=ВАШ_DD_SITE

    Или полагайтесь на ваши переменные окружения (.env).

  3. Интегрируйте с вашим AI-агентом, клиентом MCP или инструментом, таким как Claude Desktop или MCP Inspector.

    • Настройте файл конфигурации Claude Desktop для запуска этого сервера (см. выше).
    • Или запустите инспектор для ручного изучения: 
      npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=ваш_api_ключ --appKey=ваш_app_ключ

  4. Получите доступ к инструментам

    • Используйте протокол MCP, например, конечную точку /tools/list, чтобы узнать доступные функции.
    • Вызывайте действия через конечную точку /tools/call, передавая аргументы (см. примеры).

Ключевые особенности

  • Полная поддержка API мониторинга, панелей инструментов, метрик, событий, логов и инцидентов Datadog через инструменты MCP
  • Безопасная настройка учетных данных и обработка данных по лучшим практикам
  • Гибкая настройка конечных точек для глобальных и региональных сайтов Datadog
  • Исполняемые инструменты MCP для получения мониторов, панелей инструментов, событий и логов, а также для продвинутого поиска и агрегации логов
  • Комплексная обработка ошибок и четкие сообщения для проблем с API или аутентификацией
  • Готовая интеграция с AI-ассистентами, Claude Desktop или пользовательскими клиентами MCP
  • Легковесный, легко разворачиваемый на локальных машинах или серверах

Сценарии использования

  • AI-агенты или сопилоты получают данные мониторинга и панели инструментов прямо из Datadog
  • Автоматизированные ассистенты по управлению инцидентами извлекают контекст и представляют инциденты или связанные логи по запросу
  • Оповещения и логи могут быть извлечены, отфильтрованы и агрегированы через запросы на естественном языке в рабочих процессах на основе LLM
  • Эксплорация метрик по запросу и извлечение панелей инструментов для устранения проблем или отчетности
  • Немедленный запрос и визуализация недавних ошибок приложения, состояний или аномалий через совместимые с MCP UI

Часто задаваемые вопросы

Q1: Я получаю ошибку 403 Forbidden при запуске сервера.

  • Убедитесь, что оба ключа API и ключ приложения действительны, принадлежат правильной учетной записи Datadog, имеют необходимые разрешения и правильно заданы как переменные окружения или аргументы командной строки. Также проверьте, совпадает ли конечная точка (--site) с вашим регионом Datadog.

Q2: Как подключить сервер к Claude Desktop или аналогичному агенту?

  • Настройте claude_desktop_config.json с записью сервера Datadog MCP, указав команду и аргументы с вашими учетными данными и регионом Datadog. Убедитесь, что ваши ключи и конечные точки правильные.

Q3: Могу ли я использовать разные конечные точки для логов и метрик Datadog?

  • Да. Укажите аргументы командной строки --logsSite и --metricsSite или переменные окружения (DD_LOGS_SITE, DD_METRICS_SITE). Это особенно полезно для организаций с выделенными конечными точками для каждого сервиса.

Q4: Безопасно ли запускать этот сервер на моем локальном компьютере?

  • Да, сервер Datadog MCP предназначен для безопасного локального развертывания. Ключи считываются из переменных окружения или аргументов и не сохраняются в других местах. Всегда защищайте свои учетные данные.

Q5: Что делать, если мои запросы не возвращают результатов или кажутся некорректными?

  • Проверьте синтаксис и фильтры для ваших запросов (например, диапазоны времени, статусы, названия сервисов). Убедитесь, что у ваших ключей есть доступ к соответствующим данным, и установленные конечные точки соответствуют региону ваших данных.