ClickHouse
Query ClickHouse Cloud — run SQL, list databases and tables, explore services and backups, inspect usage, run ClickPipes.
Что умеет
- Get Clickpipe: Returns the specified ClickPipe.
- Get Organizations: Retrieves all accessible ClickHouse Cloud organizations.
- Run Select Query: Executes a SELECT query against a ClickHouse service. Runs a read-only SELECT query on the specified ClickHouse service via the Query API endpoint. This function provides direct acce
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
Query ClickHouse Cloud — run SQL, list databases and tables, explore services and backups, inspect usage, run ClickPipes.
Как подключить
Как подключить ClickHouse к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://clickhouse.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить ClickHouse к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://clickhouse.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить ClickHouse к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://clickhouse.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (13)
Технические названия из tools/list. Нужны только разработчикам.
| get_clickpipe | Returns the specified ClickPipe. |
| get_organizations | Retrieves all accessible ClickHouse Cloud organizations. |
| run_select_query | Executes a SELECT query against a ClickHouse service. Runs a read-only SELECT query on the specified ClickHouse service via the Query API endpoint. This function provides direct access to database content through SQL queries while ensuring that only read operations are permitted. |
| list_databases | Retrieves all databases available in a ClickHouse service. |
| list_tables | Retrieves a comprehensive list of tables in a ClickHouse database, including columns. |
| get_services_list | Retrieves all services in a ClickHouse Cloud organization. |
| get_organization_details | Returns details of a single organization. The auth key must belong to the organization. |
| get_service_details | Returns a service that belongs to the organization. |
| list_clickpipes | Retrieves all ClickPipes configured for a specific service. |
| list_service_backups | Returns a list of all backups for the service. The most recent backups comes first in the list. |
| get_organization_cost | Retrieves billing and usage cost data for a ClickHouse Cloud organization. Returns a grand total and a list of daily, per-entity organization usage cost records for the organization in the queried time period (maximum 31 days). |
| get_service_backup_details | Returns a single backup info. |
| get_service_backup_configuration | Returns the service backup configuration. |