Configura el Servidor Datadog MCP

Documentos > Bits AI > Servidor MCP de Datadog > Configura el Servidor Datadog MCP

Aprende a configurar y poner en marcha el Servidor Datadog MCP, que te permite obtener información de telemetría y administrar las funcionalidades de la plataforma directamente desde clientes impulsados por IA. Selecciona tu cliente:

Conecta a Claude (incluyendo Claude Cowork) al Servidor Datadog MCP añadiéndolo como un custom connector con la URL remota de MCP.

Sigue la guía del centro de ayuda de Claude sobre conectores personalizados para añadir un nuevo conector personalizado.
Cuando se te pida una URL, ingresa el punto de conexión del Servidor Datadog MCP para tu sitio de Datadog (). Para las instrucciones correctas, utiliza el selector Datadog Site en el lado derecho de esta página de documentación para seleccionar tu sitio.
Para habilitar herramientas específicas de producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas de Observabilidad APM y LLM (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Completa el flujo de inicio de sesión de OAuth cuando se te pida.
Verifica que tienes los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Dirige tu agente de IA al punto de conexión del Servidor Datadog MCP para tu sitio de Datadog regional. Para las instrucciones correctas, utiliza el selector Datadog Site en el lado derecho de esta página de documentación para seleccionar tu sitio.

Punto de conexión seleccionado (): .

Ejecutar en terminal:

claude mcp add --transport http datadog-mcp

Alternativamente, agrega a ~/.claude.json:

{
   "mcpServers": {
     "datadog": {
       "type": "http",
       "url": ""
      }
    }
 }

Para habilitar herramientas específicas de producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Verifica que tienes los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Si la autenticación remota no está disponible, usa autenticación binaria local en su lugar.

Punto de conexión seleccionado (): .

Edita ~/.codex/config.toml (o tu archivo de configuración de Codex CLI) para agregar el Servidor Datadog MCP con transporte HTTP y la URL del punto de conexión para tu sitio. Por ejemplo:
```
[mcp_servers.datadog]
url = ""
```
Para habilitar herramientas específicas de producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Inicia sesión en el Servidor Datadog MCP:
```
codex mcp login datadog
```
Esto abre tu navegador para completar el flujo de OAuth. Codex almacena las credenciales resultantes para que no necesites iniciar sesión nuevamente hasta que el token expire.
Verifica que tienes los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Instala el Plugin de Datadog desde el Cursor Marketplace; el plugin incluye el Servidor Datadog MCP y otros recursos. Si instalaste previamente el Servidor Datadog MCP manualmente, elimínalo de la configuración del IDE para evitar conflictos.

Conecta a Devin al servidor MCP de Datadog habilitándolo desde el Marketplace MCP de Devin. Para las instrucciones correctas, utiliza el selector Datadog Site en el lado derecho de esta página de documentación para seleccionar tu sitio.

Dirige tu agente de IA al punto de conexión del Servidor Datadog MCP para tu sitio de Datadog regional. Para las instrucciones correctas, utiliza el selector Datadog Site en el lado derecho de esta página de documentación para seleccionar tu sitio.

Punto de conexión seleccionado (): .

Ejecutar en terminal:

gemini mcp add --transport http datadog

Alternativamente, agrega a ~/.gemini/settings.json:

{
   "mcpServers": {
     "datadog": {
       "httpUrl": ""
     }
   }
 }

Para habilitar herramientas específicas del producto, incluye el toolsets parámetro de consulta al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Verifica que tienes los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Si la autenticación remota no está disponible, usa autenticación binaria local en su lugar.

Punto de conexión seleccionado (): .

Agrega el Servidor Datadog MCP a Goose utilizando uno de los siguientes métodos:
- Instalación con un clic (recomendado): Utiliza el servidor MCP de Datadog install deeplink.
- Configuración manual: Sigue las instrucciones de Goose para agregar un servidor MCP, utilizando el punto de conexión listado en esta sección como la URL del servidor HTTP transmitible. Para editar la configuración directamente, modifica ~/.config/goose/config.yaml.
Para habilitar herramientas específicas del producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas de APM y LLM Observability:
```
?toolsets=apm,llmobs
```
To enable all generally available toolsets, use toolsets=all. This works best for clients that support tool filtering.
En el primer lanzamiento de la sesión, elige tu cuenta de Datadog cuando se te pida autenticar.
Verifica que tengas los permisos requeridos para los recursos de Datadog a los que deseas acceder.

JetBrains ofrece los plugins Junie y Asistente de IA para su gama de IDEs. GitHub ofrece el plugin Copilot. Alternativamente, muchos desarrolladores utilizan un CLI de agente, como Claude Code, Codex o Gemini CLI, junto con su IDE.

Apunta tu complemento al punto de conexión del servidor MCP para tu sitio regional de Datadog. Para las instrucciones correctas, utiliza el selector Datadog Site en el lado derecho de esta página de documentación para seleccionar tu sitio.

Punto final seleccionado (): .

Junie

Ve a Tools > Junie > MCP Settings y agrega el siguiente bloque:

{
   "mcpServers": {
     "datadog": {
       "type": "http",
       "url": ""
     }
   }
 }

Para habilitar herramientas específicas del producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas de APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Se te solicita iniciar sesión a través de OAuth. El indicador de estado en la configuración muestra una marca verde cuando la conexión es exitosa.
Verifica que tengas los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Asistente de IA de JetBrains

Ve a Tools > AI Assistant > Model Context Protocol (MCP) y agrega el siguiente bloque:

{
   "mcpServers": {
     "datadog": {
       "url": ""
       "headers": {
         "DD_API_KEY": "<YOUR_API_KEY>",
         "DD_APPLICATION_KEY": "<YOUR_APP_KEY>"
       }
     }
   }
 }

Para habilitar herramientas específicas del producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas de APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
El indicador de estado en la configuración muestra una marca verde cuando la conexión es exitosa.
Verifica que tengas los permisos requeridos para los recursos de Datadog a los que deseas acceder.

GitHub Copilot

Ve a Tools > GitHub Copilot > Model Context Protocol (MCP) y agrega el siguiente bloque:

{
   "servers": {
     "datadog": {
       "type": "http",
       "url": ""
     }
   }
 }

Para habilitar herramientas específicas del producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas de APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Haz clic en el elemento Start que aparece en el editor para iniciar el servidor. Se te solicita iniciar sesión a través de OAuth.
Verifica que tengas los permisos requeridos para los recursos de Datadog a los que deseas acceder.

CLIs de agente

Muchos desarrolladores utilizan un CLI de agente, como Claude Code, Codex o Gemini CLI, junto con su IDE de JetBrains. Consulta la configuración para esas herramientas CLI:

El complemento de Datadog para IDEs de JetBrains se integra con estos CLIs de agente. Para una experiencia ininterrumpida, instala el complemento al mismo tiempo que configuras el servidor MCP de Datadog.

Dirige tu agente de IA al punto de conexión del servidor MCP para tu sitio de Datadog regional. Para las instrucciones correctas, utiliza el selector Datadog Site en el lado derecho de esta página de documentación para seleccionar tu sitio.

Punto final seleccionado (): .

Agrega lo siguiente a tu archivo de configuración de Kiro MCP (~/.kiro/settings/mcp.json para configuración específica del usuario):
```
{
   "mcpServers": {
     "datadog": {
       "url": ""
     }
   }
 }
```
Para habilitar herramientas específicas del producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas de APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Verifica que tengas los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Conecta OpenCode al Servidor MCP de Datadog con el plugin oficial Datadog OpenCode Plugin (en versión preliminar). El plugin escribe y mantiene la entrada del Servidor MCP en tu opencode.json y expone las herramientas ddsetup, ddconfig y ddtoolsets que el agente utiliza para manejar la configuración, cambios en el sitio y selección de conjunto de herramientas.

Agrega el plugin a tu archivo de configuración opencode.json. Crea el archivo si no existe:
```
{
  "plugin": ["@datadog/opencode-plugin"]
}
```
If a plugin array already exists, add "@datadog/opencode-plugin" to it.
If you previously configured the Datadog MCP Server manually in opencode.json, remove or disable that entry to avoid conflicts with the plugin.
Reinicia OpenCode. El paquete se obtiene de npm al iniciar.
Pide al agente que ejecute ddsetup. El plugin guía a través de la selección del sitio.
Reinicia OpenCode nuevamente para activar el Servidor MCP y completa el flujo de inicio de sesión de OAuth cuando se te solicite.
Verifica que tengas los permisos requeridos para los recursos de Datadog a los que deseas acceder.
Para habilitar herramientas específicas del producto, pide al agente que ejecute ddtoolsets.

Después de la configuración, pide al agente que ejecute ddconfig para cambiar tu sitio de Datadog o solucionar la conexión.

Configuración manual

Para configurar el Servidor MCP sin el plugin, agrega lo siguiente a tu archivo de configuración opencode.json.

Punto final seleccionado (): .

{
  "mcp": {
    "datadog": {
      "type": "remote",
      "url": "",
      "enabled": true
    }
  }
}

Para habilitar herramientas específicas del producto, incluye el parámetro de consulta toolsets al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas de APM y LLM Observability:

?toolsets=apm,llmobs

Para habilitar todos los conjuntos de herramientas generalmente disponibles, usa toolsets=all. Esto funciona mejor para clientes que soportan filtrado de herramientas.

La extensión de Datadog para Cursor y VS Code incluye acceso integrado al servidor MCP de Datadog administrado. GitHub Copilot también puede acceder al servidor MCP de Datadog en VS Code (requiere una suscripción activa a GitHub Copilot).

Instala la extensión (omite --profile y el nombre de perfil para instalar en el perfil predeterminado de VS Code):
```
code --install-extension datadog.datadog-vscode --profile <PROFILE_NAME>
```
Alternativamente, instala la extensión de Datadog. Si ya tienes la extensión instalada, asegúrate de que sea la última versión.
Inicia sesión en tu cuenta de Datadog.
Reinicia el IDE.
Confirma que el servidor MCP de Datadog esté disponible y que las herramientas aparezcan: Abre el panel de chat, selecciona el modo agente y haz clic en el botón Configure Tools.
Si instalaste previamente el servidor MCP de Datadog manualmente, elimínalo de la configuración del IDE para evitar conflictos. Abre la paleta de comandos (Shift + Cmd/Ctrl + P) y ejecuta MCP: Open User Configuration.
Verifica que tienes los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Warp es un terminal agente con soporte MCP integrado. Dirige el agente Warp al punto de conexión del servidor MCP para tu sitio de Datadog regional. Para las instrucciones correctas, utiliza el selector Datadog Site en el lado derecho de esta página de documentación para seleccionar tu sitio.

Punto final seleccionado (): .

En la aplicación Warp, ve a Settings > MCP Servers y haz clic en + Add.
Pega la siguiente configuración:
```
{
   "Datadog": {
     "url": ""
   }
 }
```
To enable product-specific tools, include the toolsets query parameter at the end of the endpoint URL. For example, this URL enables only APM and LLM Observability tools (use toolsets=all to enable all generally available toolsets, best for clients that support tool filtering):
```
?toolsets=apm,llmobs
```
Haz clic en Start en el servidor de Datadog. Warp abre tu navegador para completar el flujo de inicio de sesión de OAuth. Las credenciales se almacenan de forma segura en tu dispositivo y se reutilizan para sesiones futuras.
Verifica que tengas los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Para la mayoría de los otros clientes soportados, utiliza estas instrucciones para la autenticación remota. Para Cline o cuando la autenticación remota es poco confiable o no está disponible, utiliza la autenticación binaria local.

Punto final seleccionado (): .

Agrega el Servidor MCP de Datadog al archivo de configuración de tu cliente utilizando el transporte HTTP y la URL del punto de conexión de tu sitio. Por ejemplo:
```
{
   "mcpServers": {
     "datadog": {
       "type": "http",
       "url": ""
     }
   }
 }
```
Para habilitar herramientas específicas del producto, incluye el toolsets parámetro de consulta al final de la URL del punto de conexión. Por ejemplo, esta URL habilita solo herramientas APM y LLM Observability (usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles, ideal para clientes que admiten filtrado de herramientas):
```
?toolsets=apm,llmobs
```
Verifica que tienes los permisos requeridos para los recursos de Datadog a los que deseas acceder.

Conjuntos de herramientas

El Servidor MCP de Datadog soporta conjuntos de herramientas, que te permiten usar solo las herramientas MCP que necesitas, ahorrando valioso espacio en la ventana de contexto. Para usar un conjunto de herramientas, incluye el toolsets parámetro de consulta en la URL del punto de conexión al conectarte al servidor MCP (autenticación remota solamente). Usa toolsets=all para habilitar todos los conjuntos de herramientas generalmente disponibles a la vez.

Por ejemplo, basado en tu sitio de Datadog seleccionado ():

Recupera solo las herramientas básicas (este es el valor predeterminado si no se especifica toolsets):
Recupera solo herramientas relacionadas con Synthetic Testing:
```
?toolsets=synthetics
```
Recupera herramientas básicas, de Synthetic Testing y de Entrega de Software:
```
?toolsets=core,synthetics,software-delivery
```
Recupera todas las herramientas generalmente disponibles:
```
?toolsets=all
```

Habilitar todos los conjuntos de herramientas aumenta el número de definiciones de herramientas enviadas a tu cliente de IA, lo que consume espacio en la ventana de contexto. toolsets=all funciona mejor con clientes que soportan filtrado de herramientas, como Claude Code.

Conjuntos de herramientas disponibles

Estos conjuntos de herramientas son generalmente disponibles. Consulta Datadog MCP Server Tools para una referencia completa de las herramientas disponibles organizadas por conjunto de herramientas, con ejemplos de indicaciones.

core: El conjunto de herramientas predeterminado para registros, métricas, trazas, tableros, monitores, incidentes, hosts, servicios, eventos y notebooks.
alerting: Herramientas para validar y crear monitores, buscar grupos de monitores, recuperar plantillas de monitores, analizar la cobertura de monitores y buscar SLOs.
cases: Herramientas para Gestión de Casos, que incluyen crear, buscar y actualizar casos; gestionar proyectos; y vincular problemas de Jira.
dashboards: Herramientas para recuperar, crear, actualizar y eliminar tableros, además de referencia y validación de esquemas de widgets.
dbm: Herramientas para interactuar con Database Monitoring.
ddsql: Herramientas para consultar datos de Datadog utilizando DDSQL, un dialecto SQL con soporte para recursos de infraestructura, registros, métricas, RUM, tramos y otras fuentes de datos de Datadog.
error-tracking: Herramientas para interactuar con Datadog Error Tracking
feature-flags: Herramientas para gestionar banderas de características, que incluyen crear, listar y actualizar banderas y sus entornos.
kubernetes: Herramientas para buscar y describir recursos de Kubernetes y recuperar manifiestos en todos los clústeres.
llmobs: Herramientas para buscar y analizar tramos y experimentos de LLM Observability.
networks: Herramientas para análisis de Cloud Network Monitoring y Network Device Monitoring.
onboarding: Herramientas de incorporación agencial para la configuración e incorporación guiada de Datadog.
product-analytics: Herramientas para interactuar con consultas de Product Analytics.
reference-tables: Herramientas para gestionar Reference Tables, que incluyen listar tablas, leer filas, agregar filas y crear tablas desde almacenamiento en la nube.
security: Herramientas para escaneo de seguridad de código y búsqueda de señales de seguridad y hallazgos de seguridad.
software-delivery: Herramientas para interactuar con la entrega de software (CI Visibility y Test Optimization).
synthetics: Herramientas para interactuar con pruebas Synthetic de Datadog.
workflows: Herramientas para Workflow Automation, que incluyen listar, inspeccionar, ejecutar y configurar flujos de trabajo para uso de agentes.

Vista previa de conjuntos de herramientas

Estos conjuntos de herramientas están en vista previa. Regístrate para un conjunto de herramientas completando el formulario de vista previa del producto o contacta a soporte de Datadog para solicitar acceso.

apm: (Regístrate) Herramientas para un análisis en profundidad de trazas APM, búsqueda de tramos, obtención de información de Watchdog e investigación de rendimiento.

Clientes soportados

Cliente	Desarrollador	Notas
Cursor	Cursor	Se recomienda la extensión de Datadog Cursor & VS Code.
Claude Code	Anthropic
Claude	Anthropic	Usa la configuración del conector personalizado. Incluye Claude Cowork.
Codex CLI	OpenAI
Gemini CLI	Google
Warp	Warp
VS Code	Microsoft	Se recomienda la extensión de Datadog Cursor & VS Code.
JetBrains IDEs	JetBrains	Se recomienda el plugin de Datadog.
Kiro, Kiro CLI	Amazon Web Services
Goose	Agentic AI Foundation
OpenCode	SST	Se recomienda el plugin de OpenCode de Datadog.
Cline	Varios	Consulta la Other pestaña superior. Utiliza autenticación binaria local para Cline si la autenticación remota no es confiable.

El Servidor MCP de Datadog se encuentra en desarrollo activo, y podrían estar disponibles clientes adicionales.

Permisos requeridos

Las herramientas del Servidor MCP requieren los siguientes permisos de rol de usuario de Datadog:

Permiso	Requerido para
`mcp_read`	Herramientas que leen datos de Datadog (por ejemplo, consultando monitores, buscando registros, recuperando tableros)
`mcp_write`	Herramientas que crean o modifican recursos en Datadog (por ejemplo, creando monitores, silenciando servidores)

Además de mcp_read o mcp_write, los usuarios necesitan los permisos estándar de Datadog para el recurso subyacente. Por ejemplo, usar una herramienta MCP que lee monitores requiere tanto mcp_read como el permiso de Lectura de Monitores. Consulta Permisos de Rol de Datadog para la lista completa de permisos a nivel de recurso.

Los usuarios con el Rol Estándar de Datadog tienen ambos permisos del Servidor MCP por defecto. Si tu organización utiliza roles personalizados, agrega los permisos manualmente:

Ve a Configuración de la Organización > Roles como administrador, y haz clic en el rol que deseas actualizar.
Haz clic en Edit Role (ícono de lápiz).
Bajo la lista de permisos, selecciona las casillas MCP Read y MCP Write.
Selecciona cualquier otro permiso a nivel de recurso que necesites para el rol.
Haz clic Save.

Los administradores de la organización pueden gestionar el acceso global de MCP y las capacidades de escritura desde Configuración de la Organización.

Autenticación

El Servidor MCP utiliza OAuth 2.0 para autenticación. Si no puedes pasar por el flujo de OAuth (por ejemplo, en un servidor), puedes proporcionar una clave de API de Datadog y una clave de aplicación a través de los encabezados HTTP DD_API_KEY y DD_APPLICATION_KEY.

Por ejemplo, según el sitio de Datadog seleccionado ():

{
  "mcpServers": {
    "datadog": {
      "type": "http",
      "url": "",
      "headers": {
          "DD_API_KEY": "<YOUR_API_KEY>",
          "DD_APPLICATION_KEY": "<YOUR_APPLICATION_KEY>"
      }
    }
  }
}

Por seguridad, utiliza una clave de API con contexto y una clave de aplicación de una cuenta de servicio que tenga solo los permisos requeridos.

Autenticación binaria local

Se recomienda la autenticación local para Cline y cuando la autenticación remota no es confiable o no está disponible. Después de la instalación, normalmente no necesitas actualizar el binario local para beneficiarte de las actualizaciones del Servidor MCP, ya que las herramientas son remotas.

Configura el binario local del Servidor MCP de Datadog

Instala el binario del Servidor MCP de Datadog (macOS y Linux):
```
curl -sSL https://coterm.datadoghq.com/mcp-cli/install.sh | bash
```
Esto instala el binario en ~/.local/bin/datadog_mcp_cli.
Para Windows, descarga la versión de Windows.
Ejecuta datadog_mcp_cli login manualmente para seguir el flujo de inicio de sesión de OAuth y elegir un sitio de Datadog.
Configura tu cliente de IA para usar el transporte stdio con datadog_mcp_cli como comando. Por ejemplo, en macOS (reemplaza <USERNAME> con tu nombre de usuario):
```
{
  "mcpServers": {
    "datadog": {
      "type": "stdio",
      "command": "/Users/<USERNAME>/.local/bin/datadog_mcp_cli",
      "args": [],
      "env": {}
    }
  }
}
```
Para otros sistemas operativos, reemplaza la ruta command con la ubicación del binario descargado:
- Linux: /home/<USERNAME>/.local/bin/datadog_mcp_cli
- Windows: <USERNAME>\bin\datadog_mcp_cli.exe
Para Claude Code, puedes ejecutar en su lugar:
```
claude mcp add datadog --scope user -- ~/.local/bin/datadog_mcp_cli
```
Reinicia completamente tu cliente de IA para aplicar la configuración y cargar el Servidor MCP.

Prueba el acceso al Servidor MCP

Instala el inspector de MCP, una herramienta para desarrolladores para probar y depurar el Servidor MCP.
```
npx @modelcontextprotocol/inspector
```
En la interfaz web del inspector, para Transport Type, selecciona Streamable HTTP.
Para URL, ingresa el punto de conexión del Servidor MCP para tu sitio regional de Datadog.
Por ejemplo, para :
Haz clic en Connect, luego ve a Tools > List Tools.
Verifica si las herramientas disponibles aparecen.