> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP de ClickStack

> Conecta asistentes de IA a ClickStack mediante el servidor del Model Context Protocol (MCP)

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

ClickStack incluye un servidor [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://www.cursor.com/) 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.

<div id="availability">
  ## Disponibilidad
</div>

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

| Implementación                                    | Estado        |
| ------------------------------------------------- | ------------- |
| **Open Source ClickStack**                        | Disponible    |
| **BYOC (Bring Your Own Cloud)**                   | Disponible    |
| **Managed ClickStack**                            | Próximamente  |
| **HyperDX v1** ([hyperdx.io](https://hyperdx.io)) | No compatible |

<Info>
  **Managed ClickStack**

  La 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.
</Info>

<div id="prerequisites">
  ## Requisitos previos
</div>

Antes de conectar un cliente MCP, necesitas:

* Una instancia de ClickStack en ejecución (consulta [Implementación](/es/clickstack/deployment/overview) 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**

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/Y9kcWM6RbYppspJn/images/clickstack/api-key-personal.png?fit=max&auto=format&n=Y9kcWM6RbYppspJn&q=85&s=dbd0e27eab9687a639d51efe86b2d749" alt="Personal API Access Key en Team Settings" size="md" border width="3798" height="1938" data-path="images/clickstack/api-key-personal.png" />

<Note>
  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.
</Note>

<div id="endpoint">
  ## Punto de conexión
</div>

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.

<Note>
  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.
</Note>

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

<div id="connecting-a-client">
  ## Conectar un cliente MCP
</div>

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.

<div id="claude-code">
  ### Claude Code
</div>

```shell theme={null}
claude mcp add --transport http hyperdx <YOUR_CLICKSTACK_URL>/api/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"
```

<div id="cursor">
  ### Cursor
</div>

Añade lo siguiente a `.cursor/mcp.json` de tu proyecto o a la configuración global de Cursor:

```json theme={null}
{
  "mcpServers": {
    "hyperdx": {
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

<div id="opencode">
  ### OpenCode
</div>

Añade lo siguiente a la configuración de `opencode.json`:

```json theme={null}
{
  "mcp": {
    "hyperdx": {
      "type": "http",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

<div id="other-clients">
  ### Otros clientes
</div>

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>`

<div id="capabilities">
  ## ¿Qué puedes hacer con MCP?
</div>

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.

<div id="multi-team">
  ## Uso con varios equipos
</div>

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.

<div id="troubleshooting">
  ## Solución de problemas
</div>

<Accordion title="Me aparece un error 403 de autenticación">
  * 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.
</Accordion>

<Accordion title="He superado el límite de solicitudes">
  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.
</Accordion>

<Accordion title="Me aparece un error 401 con el encabezado x-hdx-team">
  Verifica que el ID del equipo sea correcto y que tu cuenta de usuario pertenezca a ese equipo.
</Accordion>

<Accordion title="No puedo conectarme al servidor MCP">
  * 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.
</Accordion>