> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Включение и подключение удалённого MCP-сервера ClickHouse Cloud

> В этом руководстве описано, как включить и использовать удалённый MCP-сервер ClickHouse Cloud

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

В этом руководстве описано, как включить удалённый MCP-сервер ClickHouse Cloud и настроить его для работы с распространёнными инструментами разработки.

**Необходимые условия**

* Запущенный [сервис ClickHouse Cloud](/docs/ru/get-started/setup/cloud)
* IDE или выбранный вами инструмент для агентной разработки

<div id="enable-remote-mcp-server">
  ## Включение удалённого MCP-сервера для Cloud
</div>

Подключитесь к сервису ClickHouse Cloud, для которого нужно включить удалённый MCP-сервер.
В меню слева нажмите **Connect**. Откроется окно со сведениями о подключении.

Выберите **Connect with MCP**:

<Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/1connectmcpmodal.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=744e5d063d27c1d69b4b09204c3627f8" alt="Выберите MCP в окне Connect" size="md" width="2190" height="2082" data-path="images/use-cases/AI_ML/MCP/1connectmcpmodal.webp" />

Включите переключатель, чтобы активировать MCP для сервиса:

<Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/2enable_mcp.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=b3dcbb434349ffabcc8402552d82eb1a" alt="Включить MCP Server" size="md" width="1340" height="884" data-path="images/use-cases/AI_ML/MCP/2enable_mcp.webp" />

Скопируйте отображаемый URL — он совпадает с приведённым ниже:

```bash theme={null}
https://mcp.clickhouse.cloud/mcp
```

<div id="setup-clickhouse-cloud-remote-mcp-server">
  ## Настройка удалённого MCP для разработки
</div>

Выберите ниже IDE или инструмент и следуйте соответствующим инструкциям по настройке.

<div id="claude-code">
  ### Claude Code
</div>

В рабочем каталоге выполните следующую команду, чтобы добавить в Claude Code конфигурацию MCP Server для ClickHouse Cloud:

```bash theme={null}
claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp
```

Затем запустите Claude Code:

```bash theme={null}
claude
```

Выполните следующую команду, чтобы получить список MCP-серверов:

```bash theme={null}
/mcp
```

Выберите `clickhouse-cloud` и авторизуйтесь через OAuth, используя свои учетные данные ClickHouse Cloud.

<div id="claude-web">
  ### Веб-интерфейс Claude
</div>

1. Перейдите в **Customize** > **Connectors**
2. Нажмите значок «+» и выберите **Add custom connector**
3. Задайте пользовательскому коннектору имя, например `clickhouse-cloud`, и добавьте его
4. Нажмите на только что добавленный коннектор `clickhouse-cloud`, затем нажмите **Connect**
5. Пройдите аутентификацию через OAuth, используя свои учетные данные ClickHouse Cloud

<div id="cursor">
  ### Cursor
</div>

1. Откройте [маркетплейс Cursor](https://cursor.com/marketplace), найдите и установите MCP-серверы.
2. Найдите ClickHouse и на странице любого сервера нажмите "Add to Cursor", чтобы установить его
3. Пройдите аутентификацию через OAuth.

<div id="visual-studio-code">
  ### Visual Studio Code
</div>

Добавьте в `.vscode/mcp.json` следующую конфигурацию:

```json theme={null}
{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
```

Подробнее см. в [документации по Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

<div id="windsurf">
  ### Windsurf
</div>

Отредактируйте файл `mcp_config.json`, указав следующую конфигурацию:

```json theme={null}
{
  "mcpServers": {
    "clickhouse-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickhouse.cloud/mcp"]
    }
  }
}
```

Подробнее см. в [документации Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp#adding-a-new-mcp).

<div id="zed">
  ### Zed
</div>

Добавьте ClickHouse как пользовательский сервер.
Добавьте следующее в настройки Zed в разделе **context\_servers**:

```json theme={null}
{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
```

При первом подключении к серверу Zed должен предложить вам пройти аутентификацию через OAuth.
Подробнее см. в [документации Zed](https://zed.dev/docs/ai/mcp#as-custom-servers).

<div id="codex">
  ### Codex
</div>

Выполните следующую команду, чтобы добавить MCP-сервер ClickHouse Cloud через CLI:

```bash theme={null}
codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp
```

<div id="example-usage">
  ## Пример использования
</div>

После подключения вы сможете взаимодействовать с ClickHouse Cloud с помощью промптов на естественном языке.
Ниже приведены некоторые типовые сценарии работы и инструменты, которые ваш MCP-клиент будет вызывать за кулисами.
Полный список доступных инструментов см. в [справочнике по инструментам](/docs/ru/products/cloud/features/ai-ml/remote-mcp#available-tools).

<div id="exploring-data">
  ### Изучение ваших данных
</div>

Для начала посмотрите, что доступно:

| Промпт                                                     | Используемый инструмент           |
| ---------------------------------------------------------- | --------------------------------- |
| "К каким организациям у меня есть доступ?"                 | `get_organizations`               |
| "Какие базы данных доступны в моём сервисе?"               | `list_databases`                  |
| "Покажи таблицы в базе данных `default`"                   | `list_tables`                     |
| "Выведи все таблицы, имена которых начинаются с `events_`" | `list_tables` (с фильтром `like`) |

<div id="running-queries">
  ### Выполнение аналитических запросов
</div>

Задавайте вопросы на естественном языке, и агент переведет их в SQL:

| Промпт                                                               | Вызываемый инструмент |
| -------------------------------------------------------------------- | --------------------- |
| "Покажи 10 первых строк из таблицы `hits`"                           | `run_select_query`    |
| "Какова средняя длительность сеанса по странам за последние 7 дней?" | `run_select_query`    |
| "Сколько строк в каждой таблице базы данных `analytics`?"            | `run_select_query`    |

Инструмент `run_select_query` позволяет выполнять только команды `SELECT`. Все запросы — только для чтения.

<div id="managing-services">
  ### Управление сервисами и инфраструктурой
</div>

Получите обзор ресурсов ClickHouse Cloud:

| Промпт                                                       | Вызываемый инструмент              |
| ------------------------------------------------------------ | ---------------------------------- |
| "Покажи все мои сервисы"                                     | `get_services_list`                |
| "Какой статус у моего сервиса в продакшне?"                  | `get_service_details`              |
| "Покажи расписание резервного копирования для этого сервиса" | `get_service_backup_configuration` |
| "Покажи последние резервные копии"                           | `list_service_backups`             |
| "Какие ClickPipes настроены для этого сервиса?"              | `list_clickpipes`                  |

<div id="monitoring-costs">
  ### Отслеживание затрат
</div>

| Промпт                                                    | Вызываемый инструмент                               |
| --------------------------------------------------------- | --------------------------------------------------- |
| "Каковы были расходы моей организации на прошлой неделе?" | `get_organization_cost`                             |
| "Покажи ежедневные расходы с 1 по 15 марта"               | `get_organization_cost` (с `from_date` и `to_date`) |

<div id="related-content">
  ## См. также
</div>

* [Навыки для агентов ClickHouse](https://github.com/ClickHouse/agent-skills)