Remote MCP в Cloud

Описание функции remote MCP в ClickHouse Cloud

Не все пользователи взаимодействуют с 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 инструментов для выполнения запросов, изучения схем, управления сервисами, мониторинга резервных копий, просмотра ClickPipe и данных биллинга	3 инструмента: run_select_query, list_databases, list_tables
Настройка	Без установки. Укажите конечную точку для MCP-клиента и пройдите аутентификацию.	Установите и запустите сервер локально

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