Servidor MCP de ClickStack

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, trace 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.

El servidor MCP está disponible en los siguientes tipos de implementación de ClickStack:

ClickStack on ClickHouse Cloud se conecta a través del endpoint MCP de Cloud en https://mcp.clickhouse.cloud/clickstack y se autentica con OAuth 2.0. La autenticación mediante API key no es compatible con este endpoint.

• Un servicio de ClickHouse Cloud en funcionamiento con ClickStack habilitado
• MCP habilitado en el servicio — abre la consola de Cloud, haz clic en Conectar, selecciona Conectar con MCP y actívalo

https://mcp.clickhouse.cloud/clickstack

La autenticación utiliza OAuth 2.0. Cuando tu cliente MCP se conecta por primera vez, se abre una ventana del navegador para que inicies sesión con tus credenciales de ClickHouse Cloud. No necesitas ninguna API key.

Cada cliente gestiona el flujo de OAuth automáticamente en la primera conexión.

claude mcp add --transport http clickstack https://mcp.clickhouse.cloud/clickstack

{
  "mcpServers": {
    "clickstack": {
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

{
  "servers": {
    "clickstack": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

{
  "mcp": {
    "clickstack": {
      "type": "remote",
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

mcpServers:
  clickstack:
    type: streamable-http
    url: https://mcp.clickhouse.cloud/clickstack

Sin el encabezado x-service-id, las solicitudes se dirigen de forma predeterminada al primer servicio de ClickStack aprovisionado y utilizado por su cuenta. Para dirigirse a otro servicio, pase x-service-id: <YOUR_SERVICE_ID> como encabezado en la configuración de su cliente MCP.

Las implementaciones de Open Source y BYOC usan el endpoint MCP integrado de la instancia de ClickStack con autenticación mediante token Bearer.

• 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 configuración del equipo → API Keys → Personal API Access Key

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, la URL es http://localhost:8080/api/mcp. Reemplace localhost:8080 por el host y el puerto de su instancia si ha personalizado los valores predeterminados.

El servidor MCP usa el transporte Streamable HTTP con autenticación mediante token Bearer.

Sustituye <YOUR_CLICKSTACK_URL> por la URL de tu instancia (por ejemplo, http://localhost:8080) y <YOUR_API_KEY> por tu Personal API Access Key.

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

{
  "mcpServers": {
    "hyperdx": {
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "hyperdx": {
      "type": "http",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

{
  "mcp": {
    "hyperdx": {
      "type": "remote",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

mcpServers:
  clickstack:
    type: streamable-http
    url: <YOUR_CLICKSTACK_URL>/api/mcp
    headers:
      Authorization: "Bearer <YOUR_API_KEY>"

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.

Esto se aplica solo a implementaciones de Open Source y BYOC. Para ClickStack on ClickHouse Cloud, consulta Dirigirse a un servicio específico.

De forma predeterminada, las solicitudes de MCP se ejecutan en el contexto de tu equipo principal. Si perteneces a varios equipos, pasa 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.