Skip to main content
Не все пользователи взаимодействуют с ClickHouse через консоль Cloud. Например, многие разработчики работают напрямую в своих любимых редакторах кода, через CLI-агенты или подключаются к базе данных с помощью собственных настроек, тогда как другие полагаются на универсальных ИИ-помощников, таких как Anthropic Claude, в большей части своей работы. Этим пользователям и агентным рабочим нагрузкам, действующим от их имени, нужен способ безопасно получать доступ к ClickHouse Cloud и выполнять запросы без сложной настройки или собственной инфраструктуры. Функция удалённого MCP-сервера в ClickHouse Cloud решает эту задачу, предоставляя стандартный интерфейс, который внешние агенты могут использовать для получения аналитического контекста. MCP, или Model Context Protocol, — это стандарт структурированного доступа к данным для ИИ-приложений на базе LLM. Благодаря этой интеграции внешние агенты могут просматривать базы данных и таблицы, изучать схемы и выполнять ограниченные запросы SELECT в режиме только для чтения. Аутентификация осуществляется через OAuth 2.0 или с помощью ключа API ClickHouse Cloud. Сервер полностью управляется в ClickHouse Cloud, поэтому не требует настройки или обслуживания. Это упрощает подключение агентных инструментов к ClickHouse и получение нужных им данных — для анализа, обобщения, генерации кода или исследования.

​
Удаленный MCP-сервер и MCP-сервер с открытым исходным кодом

ClickHouse предлагает два MCP-сервера. Удаленный MCP-сервер обеспечивает наиболее полную интеграцию с ClickHouse Cloud, включая управление сервисами, мониторинг резервных копий, просмотр ClickPipes и данные биллинга, без необходимости управлять инфраструктурой. Для самоуправляемых экземпляров ClickHouse см. руководства по MCP-серверу с открытым исходным кодом.

​
Включение удалённого MCP-сервера

Удалённый MCP-сервер нужно включить для каждого сервиса, прежде чем он сможет принимать подключения. В консоли ClickHouse Cloud откройте свой сервис, нажмите кнопку Connect, выберите MCP и включите сервер. Для включения или отключения удалённого MCP-сервера требуется разрешение control-plane:service:manage-mcp (см. Роли и разрешения в консоли). Подробные инструкции со скриншотами см. в руководстве по настройке.

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

После включения удаленный MCP-сервер будет доступен по адресу:

​
Аутентификация

Удалённый MCP-сервер поддерживает два метода аутентификации:
  • OAuth 2.0: рекомендуется для интерактивных клиентов. При первом подключении MCP-клиент открывает окно браузера, в котором пользователь входит в систему с учётными данными ClickHouse Cloud. Доступ ограничен теми организациями и сервисами, к которым у аутентифицированного пользователя есть разрешение на доступ.
  • Ключ API ClickHouse Cloud: предназначен для удалённых, headless- и автоматизированных сред, где OAuth-поток через браузер неприменим. Передайте ID ключа API и его секрет с помощью HTTP Basic-аутентификации:
Доступ по ключу API определяется ролями, разрешениями и сроком действия, заданными для этого ключа. Используйте отдельный ключ с минимально необходимыми привилегиями и передавайте его через систему управления секретами. Кодирование Base64 не шифрует учётные данные, поэтому не коммитьте закодированное значение в систему контроля версий и не допускайте его попадания в журналы. Пример настройки MCP-клиента в headless-среде см. в разделе Аутентификация из headless-среды.

​
Безопасность

Все инструменты, предоставляемые удалённым MCP-сервером, доступны только для чтения. В метаданных MCP каждого инструмента указано readOnlyHint: true. Ни один инструмент не может изменять данные, менять конфигурацию сервиса или выполнять какие-либо разрушительные операции.

​
Доступные инструменты

Удалённый MCP-сервер предоставляет 13 инструментов, сгруппированных по следующим категориям.

​
Изучение запросов и схемы

Эти инструменты позволяют агентам определять, какие данные доступны, и выполнять аналитические запросы.

​
Организации

​
Сервисы

​
Резервные копии

​
ClickPipes

​
Биллинг

​
Начало работы

Пошаговые инструкции по включению удалённого MCP-сервера и его подключению к MCP-клиенту см. в руководстве по настройке.