> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://github.com/ClickHouse/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-серверу с открытым исходным кодом](/ru/guides/use-cases/ai-ml/MCP/index).
## Включение удалённого MCP-сервера
Удалённый MCP-сервер нужно включить для каждого сервиса, прежде чем он сможет принимать подключения. В консоли ClickHouse Cloud откройте свой сервис, нажмите кнопку **Connect**, выберите **MCP** и включите сервер. Подробные инструкции со скриншотами см. в [руководстве по настройке](/ru/products/cloud/features/ai-ml/mcp/remote-mcp#enable-remote-mcp-server).
## Конечная точка
После включения удаленный MCP-сервер будет доступен по адресу: ```text theme={null} 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-клиенту см. в [руководстве по настройке](/ru/products/cloud/features/ai-ml/mcp/remote-mcp).