Datadog MCP Server

¿Qué es el servidor Datadog MCP?

El servidor Datadog MCP es un servidor dedicado del Protocolo de Contexto de Modelo (MCP) que actúa como un puente entre agentes impulsados por inteligencia artificial o aplicaciones basadas en LLM y la API de Datadog. Al exponer un conjunto de herramientas MCP vinculadas a las capacidades de supervisión, métricas, paneles, eventos, registros y gestión de incidentes de Datadog, este servidor permite una interacción estandarizada, segura y dinámica con los datos de Datadog, apoyando flujos de trabajo optimizados, solución de problemas automatizada y tareas de observabilidad mejoradas desde dentro de sistemas de inteligencia artificial.

Cómo configurar

Para configurar el servidor Datadog MCP, necesitas:

Node.js (versión 16+)
Claves de API y de aplicación de Datadog

1. Configurar credenciales usando variables de entorno:

Crea un archivo .env:

DD_API_KEY=tu_clave_de_api_aqui
DD_APP_KEY=tu_clave_de_aplicacion_aqui
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com   # opcional
DD_METRICS_SITE=datadoghq.com   # opcional

2. Proporcionar credenciales como argumentos de línea de comando:

datadog-mcp-server --apiKey=tu_clave_de_api --appKey=tu_clave_de_aplicacion --site=datadoghq.com

Para dominios específicos de múltiples regiones o servicios, usa --logsSite y --metricsSite según sea necesario.
Si te conectas con Claude Desktop, escribe la configuración en claude_desktop_config.json (la ubicación varía según el sistema operativo). Usa el sitio global o especifica logsSite/metricsSite para una configuración más granular.

Cómo usar

Instalación
```
npm install -g datadog-mcp-server
```
O ejecuta directamente a través de npx.

Iniciar el servidor

datadog-mcp-server --apiKey=TU_CLAVE_DE_API --appKey=TU_CLAVE_DE_APLICACION --site=TU_SITIO_DD

O confía en tus variables de entorno (.env).

Integra con tu agente de IA, cliente MCP, o una herramienta como Claude Desktop o MCP Inspector.
- Configura el archivo de configuración de Claude Desktop para lanzar este servidor (ver arriba).
- O ejecuta un inspector para exploración manual:
```
npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=tu_clave_de_api --appKey=tu_clave_de_aplicacion
```
Accede a las herramientas
- Usa el protocolo MCP, como el endpoint /tools/list, para descubrir funciones disponibles.
- Invoca acciones a través del endpoint /tools/call, pasando argumentos (ver ejemplos).

Características clave

Cobertura completa de las API de supervisión, paneles, métricas, eventos, registros e incidentes de Datadog a través de herramientas MCP
Configuración segura de credenciales y manejo de datos conforme a las mejores prácticas
Configuración de endpoints flexible para sitios de Datadog específicos de región o globales
Herramientas MCP ejecutables para obtener monitores, paneles, eventos y registros, así como búsqueda avanzada y agregación de registros
Manejo de errores integral y mensajes claros para problemas de API o autenticación
Integración instantánea con asistentes de IA, Claude Desktop o clientes MCP personalizados
Ligero, fácilmente desplegable en máquinas locales o servidores.

Casos de uso

Los agentes de IA o copilotos muestran datos de supervisión y paneles directamente desde Datadog
Asistentes automatizados de gestión de incidentes recuperan contexto y muestran incidentes o registros relacionados bajo demanda
Alertas y registros pueden ser obtenidos, filtrados y agregados a través de solicitudes en lenguaje natural en flujos de trabajo impulsados por LLM
Exploración de métricas bajo demanda y recuperación de paneles para solución de problemas o informes
Consulta y visualización inmediata de errores recientes de aplicaciones, estados o anomalías a través de interfaces compatibles con MCP

Preguntas frecuentes

Q1: Obtengo un error 403 Forbidden al ejecutar el servidor.

Asegúrate de que tanto la clave de API como la clave de aplicación son válidas, pertenecen a la cuenta correcta de Datadog, tienen los permisos requeridos y están bien configuradas como variables de entorno o argumentos de línea de comando. Además, verifica que el endpoint (--site) coincida con tu región de Datadog.

Q2: ¿Cómo conecto el servidor a Claude Desktop o un agente similar?

Configura el claude_desktop_config.json con la entrada del servidor MCP de Datadog, especificando el comando y argumentos con tus credenciales y región de Datadog. Asegúrate de que tus claves y endpoints son correctos.

Q3: ¿Puedo usar diferentes endpoints para los registros y métricas de Datadog?

Sí. Especifica los argumentos de línea de comando --logsSite y --metricsSite o variables de entorno (DD_LOGS_SITE, DD_METRICS_SITE). Esto es especialmente útil para organizaciones con endpoints dedicados por servicio.

Q4: ¿Es seguro ejecutar este servidor en mi máquina local?

Sí, el servidor Datadog MCP está diseñado para ser seguro y desplegable localmente. Las claves se leen de variables de entorno o argumentos y no se persisten en otros lugares. Siempre protege tus credenciales.

Q5: ¿Qué debo hacer si mis consultas no devuelven resultados o parecen incorrectas?

Verifica la sintaxis y filtros de tus consultas (por ejemplo, rangos de tiempo, estados, nombres de servicio). Asegúrate de que tus claves tienen acceso a los datos relevantes, y que los endpoints establecidos coinciden con la región de tus datos.

Nombre del Protocolo	Descripción
get-monitors	Obtiene una lista de monitores, opcionalmente filtrados por estados o etiquetas, y soporta limitación de resultados para una visión general enfocada del estado del monitor.
get-monitor	Recupera información detallada para un monitor específico dado su ID de monitor de Datadog, incluyendo configuración y estado actual.
get-dashboards	Lista todos los paneles accesibles en tu cuenta de Datadog para una amplia exploración o enumeración.
get-dashboard	Devuelve la definición completa y los detalles de un panel específico por su ID de panel, apoyando profundas exploraciones e integraciones.
get-metrics	Enumera las métricas disponibles, incluyendo nombres y metadatos básicos para métricas en Datadog.
get-metric-metadata	Recupera metadatos completos para una métrica de Datadog dada, incluyendo descripción, tipo y opciones de consulta compatibles.
get-events	Busca eventos de Datadog dentro de un rango de tiempo especificado, con filtros opcionales para tipo de evento o atributos.
get-incidents	Obtiene una lista de incidentes actuales o pasados en la gestión de incidentes de Datadog, permitiendo consultas y filtrado por estado u otros criterios.
search-logs	Realiza búsquedas de registros con filtros avanzados de consulta, ordenamiento y limitación de resultados; ideal para flujos de depuración o auditoría.
aggregate-logs	Ejecuta consultas de análisis y agregación sobre registros, permitiendo conteos agrupados, computación avanzada y desgloses por campos (facetados).