Удалённый сервер MCP в Cloud
Не все пользователи взаимодействуют с ClickHouse через консоль ClickHouse Cloud. Например, многие разработчики работают напрямую из своих привычных редакторов кода, CLI-утилит или подключаются к базе данных через собственные конфигурации, в то время как другие полагаются на универсальных AI-ассистентов, таких как Anthropic Claude, для большинства своих исследований. Этим пользователям и агентным рабочим процессам, действующим от их имени, нужен способ безопасно получать доступ к ClickHouse Cloud и выполнять запросы без сложных настроек или собственной инфраструктуры.
Функциональность удалённого сервера MCP в ClickHouse Cloud решает эту задачу, предоставляя стандартный интерфейс, который внешние агенты могут использовать для получения аналитического контекста. MCP, или Model Context Protocol, — это стандарт для структурированного доступа к данным для AI-приложений на базе 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 (self-hosted или Cloud) |
| Аутентификация | OAuth 2.0 с учетными данными ClickHouse Cloud | Переменные окружения |
| Инструменты | 13 инструментов для выполнения запросов, изучения схемы, управления сервисами, резервного копирования, ClickPipes и биллинга | 3 инструмента: run_select_query, list_databases, list_tables |
| Настройка | Установка не требуется. Укажите конечную точку для MCP-клиента и пройдите аутентификацию. | Установите и запустите сервер локально |
Удаленный MCP-сервер обеспечивает наиболее полную интеграцию с ClickHouse Cloud, включая управление сервисами, мониторинг резервных копий, просмотр ClickPipe и данные биллинга, без необходимости управлять инфраструктурой. Для самостоятельно развернутых экземпляров ClickHouse см. руководства по MCP-серверу с открытым исходным кодом.
Включение удалённого MCP-сервера
Удалённый MCP-сервер необходимо включить отдельно для каждого сервиса, прежде чем он сможет принимать подключения. В консоли ClickHouse Cloud откройте нужный сервис, нажмите кнопку Connect, выберите MCP и включите его. Подробные пошаговые инструкции со скриншотами см. в руководстве по настройке.
Конечная точка
После включения удалённый MCP-сервер будет доступен по адресу:
Аутентификация
Весь доступ к удалённому MCP-серверу осуществляется через аутентификацию OAuth 2.0. Когда MCP-клиент подключается впервые, он запускает OAuth-процедуру, в ходе которой открывается окно браузера, где пользователь входит в систему с учётными данными ClickHouse Cloud. Доступ ограничен организациями и сервисами, к которым у прошедшего аутентификацию пользователя есть права доступа. Дополнительная настройка API key не требуется.
Безопасность
Все инструменты, доступные через удалённый MCP-сервер, только для чтения. В метаданных MCP для каждого инструмента указано readOnlyHint: true. Ни один инструмент не может изменять данные, менять настройку сервиса или выполнять какие-либо разрушительные операции.
Доступные инструменты
Удалённый сервер MCP предоставляет 13 инструментов, сгруппированных по следующим категориям.
Исследование запросов и схемы
Эти инструменты позволяют агентам определять, какие данные доступны, и выполнять аналитические запросы.
| Инструмент | Описание | Параметры |
|---|---|---|
run_select_query | Выполнить SELECT-запрос только для чтения в сервисе ClickHouse. | query, допустимый SQL SELECT-запрос ClickHouse; serviceId |
list_databases | Получить список всех баз данных, доступных в сервисе ClickHouse. | serviceId |
list_tables | Получить список всех таблиц в базе данных, включая определения столбцов. | serviceId; database; при необходимости like или notLike (шаблоны SQL LIKE для фильтрации имён таблиц) |
Организации
| Tool | Описание | Параметры |
|---|---|---|
get_organizations | Возвращает все организации ClickHouse Cloud, доступные аутентифицированному пользователю. | Нет |
get_organization_details | Возвращает сведения об одной организации. | organizationId |
Сервисы
| Tool | Описание | Параметры |
|---|---|---|
get_services_list | Получить список всех сервисов в организации ClickHouse Cloud. | organizationId |
get_service_details | Получить сведения о конкретном сервисе. | organizationId; serviceId |
Резервные копии
| Инструмент | Описание | Параметры |
|---|---|---|
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 |
Биллинг
| Tool | Описание | Параметры |
|---|---|---|
get_organization_cost | Получает данные о расходах на биллинг и использование для организации. Возвращает общую сумму и ежедневные записи о расходах по сущностям. | organizationId; при необходимости from_date и to_date (YYYY-MM-DD, диапазон не более 31 дня) |
Начало работы
См. руководство по настройке, чтобы пошагово включить удалённый MCP-сервер и подключить его к MCP-клиенту.
