MCP-сервер ClickStack

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

Благодаря этому вы можете использовать такие инструменты, как Claude Code, Cursor, или любой клиент, совместимый с MCP, чтобы расследовать инциденты, создавать панели мониторинга и управлять вашей системой обсервабилити, не покидая среду разработки.

MCP-сервер доступен в следующих типах развертывания ClickStack:

ClickStack в ClickHouse Cloud подключается через конечную точку Cloud MCP по адресу https://mcp.clickhouse.cloud/clickstack и использует аутентификацию OAuth 2.0. Аутентификация с помощью API-ключа для этой конечной точки не поддерживается.

• Запущенный сервис ClickHouse Cloud с включенным ClickStack
• Включенный MCP на сервисе — откройте консоль Cloud, нажмите Connect, выберите Connect with MCP и включите его

https://mcp.clickhouse.cloud/clickstack

Для аутентификации используется OAuth 2.0. Когда ваш MCP-клиент подключается впервые, откроется окно браузера, в котором нужно войти с учетными данными ClickHouse Cloud. Ключ API не требуется.

При первом подключении каждый клиент автоматически выполняет OAuth-поток.

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

Без заголовка x-service-id запросы по умолчанию направляются в первый сервис ClickStack, созданный в вашем аккаунте. Чтобы обратиться к другому сервису, передайте x-service-id: <YOUR_SERVICE_ID> в качестве заголовка в конфигурации вашего MCP-клиента.

Развертывания Open Source и BYOC используют встроенную конечную точку MCP экземпляра ClickStack с аутентификацией по Bearer-токену.

• запущенный экземпляр ClickStack (варианты развертывания см. в разделе Развертывание)
• Personal API Access Key — его можно найти в HyperDX: Team Settings → API Keys → Personal API Access Key

MCP-сервер доступен по пути /api/mcp в URL фронтенда ClickStack. Например, для локального развертывания с настройками по умолчанию URL: http://localhost:8080/api/mcp. Замените localhost:8080 на хост и порт вашего экземпляра, если вы изменили стандартные значения.

MCP-сервер использует транспорт Streamable HTTP с аутентификацией по Bearer token.

Замените <YOUR_CLICKSTACK_URL> на URL вашего экземпляра (например, http://localhost:8080), а <YOUR_API_KEY> — на ваш 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>"

После подключения ваш ИИ-помощник получает доступ к набору инструментов, охватывающих основные области ClickStack. В их числе:

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

Со временем набор инструментов может расширяться. Ваш MCP-клиент автоматически обнаружит доступные инструменты при подключении.

Это относится только к развертываниям с открытым исходным кодом и BYOC. Для ClickStack в ClickHouse Cloud см. указание конкретного сервиса.

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

Используйте в своём MCP-клиенте инструмент вывода списка команд, чтобы узнать, к каким командам у вас есть доступ и какая из них активна.