Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте ClickHouse Cloud одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Управляйте организацией ClickHouse Cloud из AI-агента: список сервисов с состоянием, эндпоинтами и масштабированием, запуск, остановка и пробуждение, изменение доступа по IP, тегов и автомасштабирования, проверка бэкапов и ClickPipes, стоимость использования в ClickHouse Credits и остаток кредитов, а также уведомления, квоты, участники, роли, API-ключи и журнал аудита.
Попробуй спросить
Примеры промптов для ClickHouse Cloud
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → ClickHouse Cloud, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
ClickHouse Cloud
Управляйте организацией ClickHouse Cloud из AI-агента: список сервисов с состоянием, эндпоинтами и масштабированием, запуск, остановка и пробуждение, изменение доступа по IP, тегов и автомасштабирования, проверка бэкапов и ClickPipes, стоимость использования в ClickHouse Credits и остаток кредитов, а также уведомления, квоты, участники, роли, API-ключи и журнал аудита.
Настройка
Настройка занимает около 3 минут. Нужен доступ к консоли ClickHouse Cloud вашей организации.
- В консоли ClickHouse Cloud (https://console.clickhouse.cloud) откройте Organization, API keys и нажмите New API key.
- Задайте имя, срок действия, при желании список разрешённых IP и нужную роль: для чтения достаточно роли read-only или developer; для запуска, остановки, масштабирования и изменения сервисов нужен admin или своя роль с правом управлять сервисами.
- Скопируйте Key ID в
CLICKHOUSE_CLOUD_KEY_ID, а Key secret вCLICKHOUSE_CLOUD_KEY_SECRET. Секрет показывается только один раз; если он потерян, создайте новый ключ. API принимает оба значения как HTTP Basic auth (Key ID как имя пользователя, секрет как пароль). - Установите коннектор и выполните
clickhouse_cloud_list_organizations: он вернётorganization_id, который нужен всем остальным инструментам, и подтвердит ключ.
Коннектор работает с control plane Cloud (https://api.clickhouse.cloud/v1) и не выполняет SQL. Для запросов к таблицам установите коннектор ClickHouse, который использует HTTPS-интерфейс сервиса.
Что он читает:
- Организация и ключ:
clickhouse_cloud_list_organizations,clickhouse_cloud_get_organization(приватные эндпоинты, настройки BYOC) иclickhouse_cloud_whoami(ключ, его организация и роли; у ClickHouse это бета-эндпоинт). - Сервисы:
clickhouse_cloud_list_services(с необязательным фильтром по тегам, напримерtag:Environment=Production) иclickhouse_cloud_get_serviceс состоянием, облачным провайдером и регионом, версией ClickHouse, тарифом, эндпоинтами, памятью и числом реплик, idle-масштабированием, списком доступа по IP, каналом релизов и тегами.clickhouse_cloud_get_service_settingsпоказывает настройки сервера, отличные от значений по умолчанию,clickhouse_cloud_get_service_metricsтекущие метрики Prometheus в текстовом виде (filtered_metricsдля короткого отобранного списка). - Бэкапы:
clickhouse_cloud_list_backups,clickhouse_cloud_get_backup(статус, начало и конец, размер, длительность, полный или инкрементальный) иclickhouse_cloud_get_backup_configuration(интервал, срок хранения и ежедневное время запуска). - Загрузка данных:
clickhouse_cloud_list_clickpipesиclickhouse_cloud_get_clickpipeдля ClickPipes из Kafka, S3, Postgres, MySQL и других источников. Им нужен ключ с правом управлять ClickPipes. - Стоимость и состояние:
clickhouse_cloud_get_usage_costпо дням и по сущностям (хранилище данных, сервис, ClickPipe) с метриками, из которых она складывается (вычисления, хранение, бэкапы, передача данных),clickhouse_cloud_get_credit_balances(нужно право просмотра биллинга),clickhouse_cloud_list_notifications(биллинг, состояние сервисов, сбои ClickPipes, обновления; фильтры по важности, типу, ресурсу и датам) иclickhouse_cloud_list_quotas. - Люди и доступ:
clickhouse_cloud_list_members,clickhouse_cloud_list_invitations,clickhouse_cloud_list_roles,clickhouse_cloud_list_api_keys(секреты никогда не возвращаются) иclickhouse_cloud_list_activities, журнал аудита с автором, IP-адресом и id объектов.
Что он меняет:
clickhouse_cloud_change_service_stateзапускает, останавливает или будит (awake) сервис. Остановка выключает вычисления: данные сохраняются, оплата вычислений прекращается, но запросы не выполняются, пока сервис снова не запущен, поэтому ИИ сначала спрашивает вас.clickhouse_cloud_update_serviceпереименовывает сервис, задаёт канал релизов (slow,defaultилиfast), добавляет и удаляет записи списка доступа по IP и теги. Меняются только переданные поля; удаление выполняется раньше добавления.clickhouse_cloud_update_replica_scalingменяет память на реплику (минимум и максимум в ГБ, кратно 4; лимиты памяти только на тарифе Production), режим автомасштабирования, число реплик, idle-масштабирование и тайм-аут простоя (не меньше 5 минут).clickhouse_cloud_change_clickpipe_stateзапускает, останавливает или пересинхронизирует ClickPipe. Resync заново копирует исходные таблицы, поэтому ИИ согласует его с вами.clickhouse_cloud_create_invitationприглашает человека по e-mail с id ролей изclickhouse_cloud_list_roles.
После установки активны все 26 инструментов, ни один не отключён. Если ИИ должен только смотреть, дайте ключу роль read-only.
Форматы данных: каждый ответ имеет вид {status, requestId, result}, данные лежат в result. Id это UUID, время в ISO 8601 по UTC. Стоимость указана в ClickHouse Credits (CHC): grandTotalCHC за период и totalCHC на запись. Память в ГБ, размер бэкапа в байтах, длительность в секундах. state сервиса проходит через starting или stopping, прежде чем стать running или stopped; idle значит, что сервис масштабирован до нуля и проснётся от следующего запроса.
Пагинация: clickhouse_cloud_list_organizations, clickhouse_cloud_list_api_keys и clickhouse_cloud_list_notifications принимают limit (до 250) и возвращают nextCursor, если есть ещё записи; ИИ передаёт его как cursor, пока он не исчезнет. Остальные списки приходят целиком за один раз.
Ограничения: один отчёт о стоимости охватывает не больше 31 дня (to_date не позже чем через 30 дней после from_date); для более длинных периодов ИИ делает несколько вызовов. Для API действует лимит запросов на ключ.
Типичные ошибки: 401 означает неверный Key ID или секрет либо просроченный или отключённый ключ. 403 означает, что у роли ключа нет права на этот вызов (биллинг, ClickPipes и управление сервисами это отдельные права) или IP вызывающего не входит в список разрешённых IP ключа: в AnythingMCP Cloud добавьте исходящий IP сервера, при self-hosted IP вашего сервера. 404 означает неверный id организации, сервиса или бэкапа. 429 это лимит запросов; подождите несколько секунд и повторите.
Коннектор не выполняет SQL, не создаёт и не удаляет сервисы, не восстанавливает и не удаляет бэкапы, не создаёт и не отзывает API-ключи и не удаляет участников.
Предварительные требования: CLICKHOUSE_CLOUD_KEY_ID, CLICKHOUSE_CLOUD_KEY_SECRET
Локальная установка коннектора
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Откройте http://localhost:3000/connectors/store, выберите ClickHouse Cloud и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| Tool | What it does |
|---|---|
clickhouse_cloud_whoami | Who the API key is: key id, name, organization and assigned roles (actorType tells a key from a user) |
clickhouse_cloud_list_organizations | Organizations the API key belongs to (an organization key sees exactly one): id, name, creation date, private endpoints, BYOC configuration |
clickhouse_cloud_get_organization | Details of one organization: name, creation date, private endpoints and BYOC settings |
clickhouse_cloud_list_services | All ClickHouse services of the organization: id, name, cloud provider and region, state (running, idle, stopped, starting, stopping… |
clickhouse_cloud_get_service | One service with its current state, endpoints, ClickHouse version, scaling settings (min and max replica memory in GB, replicas, idle… |
clickhouse_cloud_get_service_settings | ClickHouse server settings changed on the service (the values that differ from the defaults) |
clickhouse_cloud_get_service_metrics | Current Prometheus metrics of a service as Prometheus text exposition (queries, inserts, memory, storage, merges, ...) |
clickhouse_cloud_list_backups | Backups of a service, newest first: id, status (done, error, in_progress), start and finish time, size in bytes, duration in seconds, type… |
clickhouse_cloud_get_backup | One backup of a service: status, start and finish time, size in bytes, duration and type |
clickhouse_cloud_get_backup_configuration | Backup schedule of a service: backup period in hours, retention period in hours and the daily start time (UTC) when set |
clickhouse_cloud_list_clickpipes | ClickPipes (managed ingestion from Kafka, S3, Postgres, MySQL, ...) of a service: id, name, state, source, destination table and scaling |
clickhouse_cloud_get_clickpipe | One ClickPipe with its state, source, destination, field mappings and settings |
clickhouse_cloud_get_usage_cost | Usage cost of the organization per day and per entity (data warehouse, service, ClickPipe) in ClickHouse Credits (CHC), with the metrics… |
clickhouse_cloud_get_credit_balances | Remaining prepaid credits of the organization, in total and per credit balance |
clickhouse_cloud_list_activities | Audit log of the organization: who did what and when (service created, stopped, scaled, key created, member invited, ...), with actor, IP… |
clickhouse_cloud_list_notifications | Notifications of the organization (billing, service health, ClickPipe failures, upgrades, ...), newest first, with severity, resource and… |
clickhouse_cloud_list_quotas | Quotas of the organization (for example the maximum number of services) with the current usage and whether they can be raised |
clickhouse_cloud_list_members | Members of the organization: user id, name, e-mail, role and assigned roles, join date |
clickhouse_cloud_list_invitations | Open invitations to the organization: e-mail, role, creation and expiry date |
clickhouse_cloud_list_roles | Roles defined in the organization (built-in and custom) with their permissions; the role ids are used by clickhouse_cloud_create_invitation |
clickhouse_cloud_list_api_keys | API keys of the organization: id, name, state, roles, key suffix, creation, expiry and last use |
clickhouse_cloud_change_service_state | Start, stop or wake a service. stop shuts the compute down (data is kept, billing for compute stops); start brings a stopped service back… |
clickhouse_cloud_update_service | Rename a service, change its release channel, add or remove IP access list entries or tags |
clickhouse_cloud_update_replica_scaling | Change the autoscaling of a service: memory per replica (min and max in GB, multiples of 4), number of replicas, idle scaling and idle… |
clickhouse_cloud_change_clickpipe_state | Start or stop a ClickPipe, or resync it (a database CDC pipe copies the source tables again) |
clickhouse_cloud_create_invitation | Invite a person to the organization by e-mail |
Примеры запросов
- «Какие из наших сервисов ClickHouse Cloud сейчас работают, а какие простаивают или остановлены?»
- «Сколько ClickHouse Credits мы потратили в октябре по каждому сервису? Какой день был самым дорогим?»
- «Завершился ли ночной бэкап продакшен-сервиса? Покажи размер и длительность.»
- «Добавь 203.0.113.0/24 с описанием „офис“ в список доступа по IP сервиса staging.»
- «Кто останавливал или масштабировал сервисы за последние 7 дней? Покажи записи журнала аудита.»
Следующие шаги
Это руководство помогло?