Set up docs MCPНе все пользователи взаимодействуют с ClickHouse через консоль Cloud. Например, многие разработчики работают напрямую в своих любимых редакторах кода, через CLI-агенты или подключаются к базе данных с помощью собственных настроек, тогда как другие полагаются на универсальных ИИ-помощников, таких как Anthropic Claude, в большей части своей работы. Этим пользователям и агентным рабочим нагрузкам, действующим от их имени, нужен способ безопасно получать доступ к ClickHouse Cloud и выполнять запросы без сложной настройки или собственной инфраструктуры.
Функция удалённого MCP-сервера в ClickHouse Cloud решает эту задачу, предоставляя стандартный интерфейс, который внешние агенты могут использовать для получения аналитического контекста. MCP, или Model Context Protocol, — это стандарт структурированного доступа к данным для ИИ-приложений на базе LLM. Благодаря этой интеграции внешние агенты могут просматривать базы данных и таблицы, изучать схемы и выполнять ограниченные запросы SELECT в режиме только для чтения. Аутентификация осуществляется через OAuth. Сервер полностью управляется в ClickHouse Cloud, поэтому не требует настройки или обслуживания.
Это упрощает подключение агентных инструментов к ClickHouse и получение нужных им данных — для анализа, обобщения, генерации кода или исследования.
Удаленный MCP-сервер и MCP-сервер с открытым исходным кодом
ClickHouse предлагает два MCP-сервера.
| Удаленный MCP-сервер (Cloud) | MCP-сервер с открытым исходным кодом | |
|---|---|---|
| Источник | Полностью управляется ClickHouse Cloud | mcp-clickhouse на GitHub |
| Транспорт | HTTP с поддержкой стриминга (https://mcp.clickhouse.cloud/mcp) |
Локальный stdio |
| Работает с | сервисами ClickHouse Cloud | Любым экземпляром ClickHouse (самоуправляемым или Cloud) |
| Аутентификация | OAuth 2.0 с вашими учетными данными ClickHouse Cloud | Переменные окружения |
| Инструменты | 13 инструментов для выполнения запросов, изучения схем, управления сервисами, мониторинга резервных копий, просмотра ClickPipes и данных биллинга | 3 инструмента: run_select_query, list_databases, list_tables |
| Настройка | Без установки. Укажите конечную точку для MCP-клиента и пройдите аутентификацию. | Установите и запустите сервер локально |
Удаленный MCP-сервер обеспечивает наиболее полную интеграцию с ClickHouse Cloud, включая управление сервисами, мониторинг резервных копий, просмотр ClickPipes и данные биллинга, без необходимости управлять инфраструктурой. Для самоуправляемых экземпляров ClickHouse см. руководства по MCP-серверу с открытым исходным кодом.
Включение удалённого MCP-сервера
Удалённый MCP-сервер нужно включить для каждого сервиса, прежде чем он сможет принимать подключения. В консоли ClickHouse Cloud откройте свой сервис, нажмите кнопку Connect, выберите MCP и включите сервер. Подробные инструкции со скриншотами см. в руководстве по настройке.
Конечная точка
После включения удаленный MCP-сервер будет доступен по адресу:
https://mcp.clickhouse.cloud/mcpАутентификация
Весь доступ к удалённому MCP-серверу проходит через OAuth 2.0. Когда MCP-клиент подключается впервые, он инициирует OAuth-поток, который открывает окно браузера, чтобы пользователь мог войти в систему с помощью своих учётных данных ClickHouse Cloud. Доступ ограничен организациями и сервисами, к которым у прошедшего аутентификацию пользователя есть права доступа. Дополнительная настройка API key не требуется.
Безопасность
Все инструменты, предоставляемые удалённым MCP-сервером, доступны только для чтения. В метаданных MCP каждого инструмента указано readOnlyHint: true. Ни один инструмент не может изменять данные, менять конфигурацию сервиса или выполнять какие-либо разрушительные операции.
Доступные инструменты
Удалённый MCP-сервер предоставляет 13 инструментов, сгруппированных по следующим категориям.
Изучение запросов и схемы
Эти инструменты позволяют агентам определять, какие данные доступны, и выполнять аналитические запросы.
| Tool | Description | Parameters |
|---|---|---|
run_select_query |
Выполнить SELECT-запрос в режиме только для чтения к сервису ClickHouse. | query, корректный SELECT-запрос ClickHouse SQL; serviceId |
list_databases |
Вывести список всех баз данных, доступных в сервисе ClickHouse. | serviceId |
list_tables |
Вывести список всех таблиц в базе данных, включая определения столбцов. | serviceId; database; необязательно like или notLike (шаблоны SQL LIKE для фильтрации имён таблиц) |
Организации
| Инструмент | Описание | Параметры |
|---|---|---|
get_organizations |
Возвращает все организации ClickHouse Cloud, доступные аутентифицированному пользователю. | Нет |
get_organization_details |
Возвращает сведения об одной организации. | organizationId |
Сервисы
| Tool | Description | Parameters |
|---|---|---|
get_services_list |
Выводит список всех сервисов в организации ClickHouse Cloud. | organizationId |
get_service_details |
Возвращает сведения о конкретном сервисе. | organizationId; serviceId |
Резервные копии
| Tool | Description | Parameters |
|---|---|---|
list_service_backups |
Возвращает список всех резервных копий сервиса, начиная с самых новых. | organizationId; serviceId |
get_service_backup_details |
Возвращает сведения об одной резервной копии. | organizationId; serviceId; backupId |
get_service_backup_configuration |
Возвращает конфигурацию резервного копирования для сервиса (расписание и параметры хранения). | organizationId; serviceId |
ClickPipes
| Инструмент | Описание | Параметры |
|---|---|---|
list_clickpipes |
Вывести список всех ClickPipes, настроенных для сервиса. | organizationId; serviceId |
get_clickpipe |
Вернуть сведения о конкретном ClickPipe. | organizationId; serviceId; clickPipeId |
Биллинг
| Инструмент | Описание | Параметры |
|---|---|---|
get_organization_cost |
Получить данные о биллинге и расходах на использование для организации. Возвращает общую сумму и ежедневные записи о расходах по каждой сущности. | organizationId; необязательно from_date и to_date (YYYY-MM-DD, не более 31 дня) |
Начало работы
Пошаговые инструкции по включению удалённого MCP-сервера и его подключению к MCP-клиенту см. в руководстве по настройке.