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

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

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

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

2. Скопируйте URL-адрес MCP-сервера ClickHouse Cloud из окна Connect или из блока ниже

https://mcp.clickhouse.cloud/mcp

Добавление сервера ClickHouse MCP в 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 Client вы также можете напрямую редактировать JSON-конфигурацию

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

2. Запустите Claude Code в вашем рабочем каталоге

[user@host ~/Documents/repos/mcp_test] $ claude

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

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

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

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

1. В Claude Code убедитесь, что удалённый сервер MCP подключён

2. Поздравляем! Теперь вы можете использовать удалённый сервер MCP ClickHouse Cloud в Claude Code

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