Serveur MCP de ClickStack

ClickStack intègre un serveur Model Context Protocol (MCP) qui permet aux assistants IA d’interagir avec vos données d’observability. Une fois connecté, un assistant IA peut interroger les logs, les traces et les métriques ; gérer les tableaux de bord et les alertes ; explorer les sources de données ; et utiliser les recherches enregistrées — le tout en langage naturel.

Vous pouvez ainsi utiliser des outils comme Claude Code, Cursor ou tout client compatible MCP pour analyser des incidents, créer des tableaux de bord et gérer votre configuration d’observability sans quitter votre environnement de développement.

Le serveur MCP est disponible pour les types de déploiement ClickStack suivants :

ClickStack on ClickHouse Cloud se connecte via le MCP endpoint Cloud à https://mcp.clickhouse.cloud/clickstack et utilise OAuth 2.0 pour l’authentification. L’authentification par clé API n’est pas prise en charge pour ce endpoint.

• Un service ClickHouse Cloud en cours de fonctionnement avec ClickStack activé
• MCP activé sur le service — ouvrez la console Cloud, cliquez sur Connect, sélectionnez Connect with MCP, puis activez-le

https://mcp.clickhouse.cloud/clickstack

L’authentification utilise OAuth 2.0. Lorsque votre client MCP se connecte pour la première fois, une fenêtre de navigateur s’ouvre afin que vous puissiez vous connecter avec vos identifiants ClickHouse Cloud. Aucune clé API n’est nécessaire.

Chaque client gère automatiquement le flux OAuth lors de la première connexion.

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

Sans l’en-tête x-service-id, les requêtes sont dirigées par défaut vers le premier service ClickStack provisionné et utilisé par votre compte. Pour cibler un autre service, ajoutez x-service-id: <YOUR_SERVICE_ID> comme en-tête dans la configuration de votre client MCP.

Les déploiements Open Source et BYOC utilisent l'endpoint MCP intégré de votre instance ClickStack avec une authentification par jeton Bearer.

• Une instance ClickStack active (voir Déploiement pour les options de déploiement)
• Une Personal API Access Key — trouvez la vôtre dans HyperDX, sous Team Settings → API Keys → Personal API Access Key

Le serveur MCP est disponible sur le chemin /api/mcp de l’URL du frontend ClickStack. Par exemple, avec un déploiement local par défaut, l’URL est http://localhost:8080/api/mcp. Remplacez localhost:8080 par l’hôte et le port de votre instance si vous avez modifié les valeurs par défaut.

Le serveur MCP utilise le transport Streamable HTTP avec une authentification par Bearer token.

Remplacez <YOUR_CLICKSTACK_URL> par l’URL de votre instance (par exemple, http://localhost:8080) et <YOUR_API_KEY> par votre 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>"

Une fois connecté, votre assistant IA a accès à un ensemble d’outils couvrant les principaux domaines de ClickStack. Il s’agit notamment de :

• Interrogation des données — Recherchez et agrégerez les logs, les traces et les métriques à l’aide du query builder de ClickStack, de la syntaxe de recherche ou de SQL brut.
• Sources de données — Répertoriez les sources de données disponibles, les connexions aux bases de données, les schémas de colonnes et les clés d’attribut.
• Tableaux de bord — Créez, mettez à jour, supprimez et inspectez les tableaux de bord ainsi que leurs tuiles.
• Alertes — Créez, mettez à jour et inspectez les alertes, ainsi que leur historique d’évaluation.
• Recherches enregistrées — Créez, mettez à jour et inspectez des définitions de recherches enregistrées réutilisables.
• Webhooks — Répertoriez les destinations webhook disponibles pour les notifications d’alerte.
• Équipes — Répertoriez les équipes auxquelles appartient l’utilisateur actuel et identifiez l’équipe active.

L’ensemble des outils disponibles peut évoluer au fil du temps. Votre client MCP découvrira automatiquement les outils disponibles lors de la connexion.

Cela s'applique uniquement aux déploiements Open Source et BYOC. Pour ClickStack on ClickHouse Cloud, voir Cibler un service spécifique.

Par défaut, les requêtes MCP s'exécutent dans le contexte de votre équipe principale. Si vous appartenez à plusieurs équipes, ajoutez l'en-tête x-hdx-team avec l'ID de l'équipe, en plus de votre en-tête Authorization. Si cet en-tête est omis, votre équipe principale est utilisée. Si vous spécifiez une équipe à laquelle vous n'appartenez pas, la requête est rejetée avec une erreur 401.

Utilisez l'outil de liste des équipes de votre MCP client pour voir à quelles équipes vous avez accès et laquelle est active.