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

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

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

Предварительные требования

  • Работающий сервис ClickHouse Cloud
  • IDE или выбранный вами инструмент для agentic-разработки

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

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

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

Выбор MCP в окне Connect

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

Включение сервера MCP

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

https://mcp.clickhouse.cloud/mcp

Настройка удалённого MCP для разработки​

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

Claude Code​

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

claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp

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

claude

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

/mcp

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

Веб-интерфейс Claude​

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

Cursor​

  1. Откройте Cursor Marketplace, чтобы найти и установить MCP-серверы.
  2. Найдите ClickHouse и нажмите «Add to Cursor» на любом сервере, чтобы установить его.
  3. Пройдите аутентификацию через OAuth.

Visual Studio Code​

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

{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

Подробнее см. в документации Visual Studio Code

Windsurf​

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

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

Подробнее см. в документации Windsurf

Zed​

Добавьте ClickHouse в качестве пользовательского сервера. Добавьте в настройки Zed следующее в разделе context_servers:

{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

При первом подключении к серверу Zed должен предложить вам пройти аутентификацию через OAuth. Подробнее см. в документации Zed

Codex​

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

codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

Связанные материалы​