> ## 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 с 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](https://docs.astral.sh/uv/).
Если вы не хотите использовать uv, потребуется обновить конфигурацию MCP-сервера и указать альтернативный менеджер пакетов.
Чтобы запустить Open WebUI, выполните следующую команду:
```bash theme={null}
uv run --with open-webui open-webui serve
```
Перейдите по адресу [http://localhost:8080/](http://localhost:8080/), чтобы открыть интерфейс.
Чтобы настроить MCP-сервер ClickHouse, нам нужно преобразовать его в конечные точки OpenAPI.
Сначала зададим переменные окружения, которые позволят подключиться к Песочнице ClickHouse:
```bash theme={null}
export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""
```
Затем можно запустить `mcpo`, чтобы создать конечные точки OpenAPI:
```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`:
Если нажать на значок инструмента, можно будет увидеть список доступных инструментов:
По умолчанию Open WebUI работает с моделями Ollama, но также можно добавить конечные точки, совместимые с OpenAI.
Они настраиваются через меню настроек, но на этот раз нужно открыть вкладку `Connections`:
Добавим конечную точку и ключ OpenAI:
После этого модели OpenAI будут доступны в верхнем меню:
После этого можно начать диалог, и Open WebUI при необходимости обратится к MCP-серверу: