Saltar al contenido principal
ClickStack incluye un servidor Model Context Protocol (MCP) integrado que permite a los asistentes de IA interactuar con sus datos de observabilidad. Una vez conectado, un asistente de IA puede consultar logs, trazas y métricas; gestionar dashboards y alertas; explorar fuentes de datos; y trabajar con búsquedas guardadas, todo mediante lenguaje natural. Esto le permite usar herramientas como Claude Code, Cursor o cualquier cliente compatible con MCP para investigar incidentes, crear dashboards y gestionar su configuración de observabilidad sin salir de su entorno de desarrollo.

​
Disponibilidad

El servidor MCP está disponible en los siguientes tipos de implementación de ClickStack:
ImplementaciónEstado
Open Source ClickStackDisponible
BYOC (Bring Your Own Cloud)Disponible
Managed ClickStackPróximamente
HyperDX v1 (hyperdx.io)No compatible
Managed ClickStackLa compatibilidad del servidor MCP con Managed ClickStack se encuentra en desarrollo activo y estará disponible próximamente. Las instrucciones de esta página se aplican a las implementaciones de Open Source y BYOC.

​
Requisitos previos

Antes de conectar un cliente MCP, necesitas:
  • Una instancia de ClickStack en ejecución (consulta Implementación para ver las opciones de configuración)
  • Una Personal API Access Key — encontrarás la tuya en HyperDX, en Team Settings → API Keys → Personal API Access Key
La Personal API Access Key es distinta de la API key de ingesta que se encuentra en Team Settings y se usa para autenticar los datos de telemetría enviados al collector de OpenTelemetry.

​
Punto de conexión

El servidor MCP está disponible en la ruta /api/mcp de la URL del frontend de ClickStack: Por ejemplo, con una implementación local predeterminada: Reemplace localhost:8080 por el host y el puerto de su instancia si ha personalizado los valores predeterminados.
Los ejemplos de esta página usan la URL de la aplicación frontend (puerto 8080 de forma predeterminada). También puede acceder directamente al servidor MCP a través del backend en <BACKEND_URL>/mcp, pero no todas las implementaciones exponen el backend, por lo que esta documentación usa la ruta del frontend.
El servidor MCP usa el transporte Streamable HTTP con autenticación mediante token Bearer.

​
Conectar un cliente MCP

Los ejemplos siguientes muestran cómo configurar clientes MCP populares. Reemplace <YOUR_CLICKSTACK_URL> por la URL de su instancia (por ejemplo, http://localhost:8080) y <YOUR_API_KEY> por su Personal API Access Key.

​
Claude Code

claude mcp add --transport http hyperdx <YOUR_CLICKSTACK_URL>/api/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

​
Cursor

Añade lo siguiente a .cursor/mcp.json de tu proyecto o a la configuración global de Cursor: 
{
  "mcpServers": {
    "hyperdx": {
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

​
OpenCode

Añade lo siguiente a la configuración de opencode.json: 
{
  "mcp": {
    "hyperdx": {
      "type": "http",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

​
Otros clientes

Cualquier cliente MCP compatible con el transporte Streamable HTTP puede conectarse. Configúralo así:
  • URL: <YOUR_CLICKSTACK_URL>/api/mcp
  • Encabezado: Authorization: Bearer <YOUR_API_KEY>

​
¿Qué puedes hacer con MCP?

Una vez conectado, tu asistente de IA tiene acceso a un conjunto de herramientas que cubren las áreas principales de ClickStack. Entre ellas se incluyen:
  • Consulta de datos — Busca y agrega logs, traces y métricas mediante el constructor de consultas de ClickStack, la sintaxis de búsqueda o SQL puro.
  • Fuentes de datos — Enumera las fuentes de datos disponibles, las conexiones a bases de datos, los esquemas de columnas y las claves de atributos.
  • Dashboards — Crea, actualiza, elimina e inspecciona dashboards junto con sus tiles.
  • Alertas — Crea, actualiza e inspecciona alertas junto con su historial de evaluación.
  • Búsquedas guardadas — Crea, actualiza e inspecciona definiciones reutilizables de búsquedas guardadas.
  • Webhooks — Enumera los destinos de webhook disponibles para las notificaciones de alertas.
  • Equipos — Enumera los equipos a los que pertenece el usuario actual e identifica el equipo activo.
El conjunto concreto de herramientas puede ampliarse con el tiempo. Tu cliente MCP detectará automáticamente las herramientas disponibles al conectarse.

​
Uso con varios equipos

De forma predeterminada, las solicitudes de MCP se ejecutan en el contexto de tu equipo principal. Si perteneces a varios equipos, puedes dirigirte a un equipo concreto enviando el encabezado x-hdx-team con el ID del equipo junto con el encabezado Authorization. Si se omite el encabezado, se usa tu equipo principal. Si especificas un equipo al que no perteneces, la solicitud se rechaza con un error 401. Usa la herramienta de listado de equipos de tu cliente MCP para ver a qué equipos tienes acceso y cuál está activo.

​
Solución de problemas

  • Verifica que estés usando la Personal API Access Key (no la API key de ingesta).
  • Confirma que la API key se incluya como token Bearer en el encabezado Authorization.
  • Comprueba que tu instancia de ClickStack esté en ejecución y accesible en la URL que configuraste.
El servidor MCP impone un límite de 600 solicitudes por minuto por usuario. Si superas este límite, las solicitudes se rechazarán temporalmente. Reduce la frecuencia de las solicitudes o espera antes de reintentar.
Verifica que el ID del equipo sea correcto y que tu cuenta de usuario pertenezca a ese equipo.
  • Asegúrate de que tu cliente MCP admita el transporte Streamable HTTP. Los clientes más antiguos que solo admiten el transporte stdio no funcionarán.
  • Si estás ejecutando ClickStack localmente, confirma que la aplicación esté accesible en la URL configurada (la predeterminada es http://localhost:8080).
  • En implementaciones BYOC detrás de un balanceador de carga o un proxy inverso, asegúrate de que la ruta /api/mcp no esté bloqueada ni se reescriba.
Última modificación el 10 de junio de 2026