Перейти к основному содержанию
ClickStack включает встроенный сервер Model Context Protocol (MCP), который позволяет AI-ассистентам взаимодействовать с вашими данными обсервабилити. После подключения AI-ассистент может выполнять запросы к журналам, трассировкам и метрикам; управлять панелями мониторинга и оповещениями; просматривать источники данных; и работать с сохранёнными поисками — всё это на естественном языке. Благодаря этому вы можете использовать такие инструменты, как Claude Code, Cursor, или любой клиент, совместимый с MCP, чтобы расследовать инциденты, создавать панели мониторинга и управлять вашей системой обсервабилити, не покидая среду разработки.

​
Доступность

MCP-сервер доступен в следующих типах развертывания ClickStack:
РазвертываниеСтатус
Open Source ClickStackДоступно
BYOC (Собственное облако)Доступно
Управляемый ClickStackСкоро будет доступно
HyperDX v1 (hyperdx.io)Не поддерживается
Управляемый ClickStackПоддержка MCP-сервера для Управляемого ClickStack находится в активной разработке и скоро станет доступна. Инструкции на этой странице относятся к развертываниям Open Source ClickStack и BYOC.

​
Предварительные требования

Перед подключением MCP-клиента вам потребуется:
  • запущенный экземпляр ClickStack (варианты развертывания см. в разделе Развертывание)
  • Personal API Access Key — его можно найти в HyperDX: Team Settings → API Keys → Personal API Access Key
Personal API Access Key отличается от Ingestion API Key в Team Settings, который используется для аутентификации телеметрических данных, отправляемых в OpenTelemetry Collector.

​
Конечная точка

MCP-сервер доступен по пути /api/mcp в URL фронтенда ClickStack: Например, для локального развертывания с настройками по умолчанию: Замените localhost:8080 на хост и порт вашего экземпляра, если вы изменили стандартные значения.
В примерах на этой странице используется URL фронтенд-приложения (по умолчанию порт 8080). Вы также можете обращаться к MCP-серверу напрямую через бэкенд по адресу <BACKEND_URL>/mcp, но не во всех развертываниях бэкенд доступен извне, поэтому в этой документации используется путь через фронтенд.
MCP-сервер использует транспорт Streamable HTTP с аутентификацией по Bearer token.

​
Подключение MCP-клиента

В примерах ниже показано, как настроить популярные MCP-клиенты. Замените <YOUR_CLICKSTACK_URL> URL-адресом вашего экземпляра (например, http://localhost:8080), а <YOUR_API_KEY> — вашим Personal API Access Key.

​
Claude code

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

​
Cursor

Добавьте следующее в файл .cursor/mcp.json вашего проекта или в глобальные настройки Cursor: 
{
  "mcpServers": {
    "hyperdx": {
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

​
OpenCode

Добавьте следующее в файл конфигурации opencode.json: 
{
  "mcp": {
    "hyperdx": {
      "type": "http",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

​
Другие клиенты

Подключиться может любой MCP-клиент, поддерживающий транспорт Streamable HTTP. Настройте его следующим образом:
  • URL: <YOUR_CLICKSTACK_URL>/api/mcp
  • Заголовок: Authorization: Bearer <YOUR_API_KEY>

​
Что можно делать с MCP?

После подключения ваш ИИ-помощник получает доступ к набору инструментов, охватывающих основные области ClickStack. В их числе:
  • Запросы к данным — Ищите и агрегируйте журналы, трассировки и метрики с помощью конструктора запросов ClickStack, поискового синтаксиса или raw SQL.
  • Источники данных — Просматривайте доступные источники данных, подключения к базам данных, схемы столбцов и ключи атрибутов.
  • Панели мониторинга — Создавайте, обновляйте, удаляйте и просматривайте панели мониторинга вместе с их плитками.
  • Оповещения — Создавайте, обновляйте и просматривайте оповещения вместе с историей их выполнения.
  • Сохранённые поиски — Создавайте, обновляйте и просматривайте повторно используемые определения сохранённых поисков.
  • Вебхуки — Просматривайте доступные пункты назначения вебхуков для уведомлений об оповещениях.
  • Команды — Просматривайте команды, в которые входит текущий пользователь, и определяйте активную команду.
Со временем набор инструментов может расширяться. Ваш MCP-клиент автоматически обнаружит доступные инструменты при подключении.

​
Использование в нескольких командах

По умолчанию запросы MCP выполняются в контексте вашей основной команды. Если вы состоите в нескольких командах, можно обратиться к конкретной команде, передав заголовок x-hdx-team с ID команды вместе с заголовком Authorization. Если этот заголовок не указан, используется ваша основная команда. Если указать команду, в которую вы не входите, запрос будет отклонён с ошибкой 401. Используйте в своём MCP-клиенте инструмент вывода списка команд, чтобы узнать, к каким командам у вас есть доступ и какая из них активна.

​
Устранение неполадок

  • Убедитесь, что вы используете Personal API Access Key (а не ключ API для приёма данных).
  • Убедитесь, что ключ передаётся как токен Bearer в заголовке Authorization.
  • Проверьте, что ваш экземпляр ClickStack запущен и доступен по указанному URL.
MCP-сервер ограничивает частоту запросов до 600 запросов в минуту на пользователя. Если вы превысите этот лимит, запросы будут временно отклоняться. Уменьшите частоту запросов или подождите перед повторной попыткой.
Убедитесь, что идентификатор команды указан верно и что ваша учётная запись входит в эту команду.
  • Убедитесь, что ваш MCP-клиент поддерживает транспорт Streamable HTTP. Более старые клиенты, поддерживающие только transport stdio, работать не будут.
  • Если вы запускаете ClickStack локально, убедитесь, что приложение доступно по указанному URL (по умолчанию — http://localhost:8080).
  • Для BYOC-развертываний за балансировщиком нагрузки или обратным прокси убедитесь, что путь /api/mcp не блокируется и не переписывается.
Последнее изменение 10 июня 2026 г.