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

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

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

• Запущенный сервис ClickHouse Cloud
• IDE или выбранный вами инструмент для агентной разработки

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

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

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

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

https://mcp.clickhouse.cloud/mcp

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

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

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

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

claude

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

/mcp

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

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

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

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

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

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

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

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

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

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

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

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

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

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

После подключения вы сможете взаимодействовать с ClickHouse Cloud с помощью промптов на естественном языке. Ниже приведены некоторые типовые сценарии работы и инструменты, которые ваш MCP-клиент будет вызывать за кулисами. Полный список доступных инструментов см. в справочнике по инструментам.

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

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

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

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

• Навыки для агентов ClickHouse