Перейти к основному содержанию
Перейти к основному содержанию

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

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

Включите удалённый MCP-сервер для вашего сервиса ClickHouse Cloud

  1. Подключитесь к вашему сервису ClickHouse Cloud, нажмите кнопку Connect и включите Remote MCP Server для вашего сервиса.
Выберите MCP в окне Connect
Включите MCP Server
  1. Скопируйте URL сервера ClickHouse Cloud MCP из окна Connect или ниже на странице.
https://mcp.clickhouse.cloud/mcp

Добавление MCP-сервера ClickHouse в Claude Code

  1. В рабочем каталоге выполните следующую команду, чтобы добавить конфигурацию MCP-сервера ClickHouse Cloud в Claude Code. В этом примере мы назвали MCP-сервер в конфигурации Claude Code clickhouse_cloud.
claude mcp add --transport http clickhouse_cloud https://mcp.clickhouse.cloud/mcp

1b. В зависимости от используемого клиента MCP вы также можете напрямую редактировать JSON-конфигурацию

{
  "mcpServers": {
    "clickhouse-remote": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
  1. Запустите Claude Code в рабочем каталоге
[user@host ~/Documents/repos/mcp_test] $ claude

Аутентификация в ClickHouse Cloud через OAuth

  1. При первом запуске Claude Code откроет окно браузера. В дальнейшем вы можете инициировать подключение, выполнив команду /mcp в Claude Code и выбрав MCP‑сервер clickhouse_cloud

  2. Выполните аутентификацию, используя свои учетные данные ClickHouse Cloud

Процесс подключения через OAuth
Успешное подключение через OAuth

Использование удаленного MCP‑сервера ClickHouse Cloud из Claude Code

  1. Убедитесь в Claude Code, что удаленный MCP‑сервер подключен
Успешная работа Claude Code MCP
Подробности Claude Code MCP
  1. Поздравляем! Теперь вы можете использовать удаленный MCP‑сервер ClickHouse Cloud из Claude Code
Использование Claude Code MCP

Хотя в этом примере использовался Claude Code, вы можете использовать любой LLM‑клиент с поддержкой MCP, выполнив аналогичные шаги.