> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Использование MCP-сервера ClickHouse с Open WebUI
> В этом руководстве показано, как настроить Open WebUI для работы с MCP-сервером ClickHouse с помощью Docker.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> В этом руководстве показано, как настроить [Open WebUI](https://github.com/open-webui/open-webui) для работы с MCP-сервером ClickHouse
> и подключить его к демонстрационным наборам данных ClickHouse.
## Установите uv
Чтобы следовать инструкциям из этого руководства, нужно установить [uv](https://docs.astral.sh/uv/).
Если вы не хотите использовать uv, обновите конфигурацию MCP-сервера, указав альтернативный менеджер пакетов.
## Запустите Open WebUI
Чтобы запустить Open WebUI, выполните следующую команду:
```bash theme={null}
uv run --with open-webui open-webui serve
```
Перейдите по адресу [http://localhost:8080/](http://localhost:8080/), чтобы открыть интерфейс.
## Настройте MCP-сервер ClickHouse
Чтобы настроить MCP-сервер ClickHouse, нужно преобразовать его в набор конечных точек Open API.
Сначала зададим переменные окружения, которые позволят подключиться к Песочнице ClickHouse:
```bash theme={null}
export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""
```
Затем можно запустить `mcpo`, чтобы создать конечные точки Open API:
```bash theme={null}
uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
```
Список созданных конечных точек можно посмотреть по адресу [http://localhost:8000/docs](http://localhost:8000/docs)
Чтобы использовать эти конечные точки в Open WebUI, перейдите в настройки:
Нажмите `Tools`:
Добавьте [http://localhost:8000](http://localhost:8000) в качестве URL инструмента:
После этого рядом со значком инструмента на панели чата должна появиться `1`:
Если нажать на значок инструмента, можно увидеть список доступных инструментов:
## Настройте OpenAI
По умолчанию Open WebUI работает с моделями Ollama, но также можно добавить конечные точки, совместимые с OpenAI.
Они настраиваются через меню настроек, но на этот раз нужно перейти на вкладку `Connections`:
Добавьте конечную точку и ключ OpenAI:
После этого модели OpenAI будут доступны в верхнем меню:
## Общение с MCP-сервером ClickHouse через Open WebUI
После этого можно начать диалог, и Open WebUI при необходимости вызовет MCP-сервер: