> ## 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 с Claude Desktop
> В этом руководстве рассказывается, как настроить Claude Desktop для работы с MCP-сервером ClickHouse.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> В этом руководстве рассказывается, как настроить Claude Desktop для работы с MCP-сервером ClickHouse с помощью uv
> и подключить его к примерам наборов данных ClickHouse.
Чтобы выполнить инструкции из этого руководства, вам потребуется установить [uv](https://docs.astral.sh/uv/).
Если вы не хотите использовать uv, вам нужно будет изменить конфигурацию MCP-сервера и указать альтернативный менеджер пакетов.
Вам также потребуется установить приложение Claude Desktop, которое можно скачать на [сайте Claude Desktop](https://claude.ai/desktop).
После установки Claude Desktop можно переходить к настройке [MCP-сервера ClickHouse](https://github.com/ClickHouse/mcp-clickhouse).
Это можно сделать через [файл конфигурации Claude Desktop](https://claude.ai/docs/configuration).
Чтобы найти этот файл, сначала откройте страницу настроек (`Cmd+,` на Mac), а затем нажмите вкладку `Developer` в меню слева.
После этого вы увидите следующий экран, где нужно нажать кнопку `Edit config`:
Вы попадёте в каталог, содержащий файл конфигурации (`claude_desktop_config.json`).
При первом открытии этого файла он, скорее всего, будет содержать следующее:
```json theme={null}
{
"mcpServers": {}
}
```
Словарь `mcpServers` использует имя MCP-сервера в качестве ключа, а словарь параметров конфигурации — в качестве значения.
Например, конфигурация MCP-сервера ClickHouse для подключения к Песочнице ClickHouse будет выглядеть так:
```json theme={null}
{
"mcpServers": {
"mcp-clickhouse": {
"command": "uv",
"args": [
"run",
"--with",
"mcp-clickhouse",
"--python",
"3.10",
"mcp-clickhouse"
],
"env": {
"CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
"CLICKHOUSE_PORT": "8443",
"CLICKHOUSE_USER": "demo",
"CLICKHOUSE_PASSWORD": "",
"CLICKHOUSE_SECURE": "true",
"CLICKHOUSE_VERIFY": "true",
"CLICKHOUSE_CONNECT_TIMEOUT": "30",
"CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
}
}
}
}
```
После обновления конфигурации вам нужно будет перезапустить Claude Desktop, чтобы изменения вступили в силу.
В зависимости от того, как вы установили `uv`, при перезапуске Claude Desktop может появиться следующая ошибка:
```text theme={null}
MCP mcp-clickhouse: spawn uv ENOENT
```
Если это произойдёт, вам нужно будет изменить `command`, указав полный путь к `uv`. Например, если вы устанавливали его через Cargo, путь будет таким: `/Users//.cargo/bin/uv`
После перезапуска Claude Desktop вы сможете найти MCP-сервер ClickHouse, нажав на значок `Search and tools`:
Затем можно выбрать, отключить все инструменты или только некоторые из них.
Теперь всё готово, чтобы задавать Claude вопросы, при ответе на которые он будет использовать MCP-сервер ClickHouse.
Например, можно спросить: `What's the most interesting dataset in the SQL playground?`.
При первом обращении к инструменту Claude попросит подтвердить использование каждого инструмента MCP-сервера:
Ниже показана часть диалога, включающего несколько вызовов инструментов MCP-сервера ClickHouse: