> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-framing-web-ui.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 <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> В этом руководстве объясняется, как настроить [Open WebUI](https://github.com/open-webui/open-webui) с MCP-сервером ClickHouse
> и подключить его к демонстрационным наборам данных ClickHouse.

<Steps>
  <Step title="Установите uv" id="install-uv">
    Чтобы следовать инструкциям из этого руководства, вам потребуется установить [uv](https://docs.astral.sh/uv/).
    Если вы не хотите использовать uv, потребуется обновить конфигурацию MCP-сервера и указать альтернативный менеджер пакетов.
  </Step>

  <Step title="Запустите Open WebUI" id="launch-open-webui">
    Чтобы запустить Open WebUI, выполните следующую команду:

    ```bash theme={null}
    uv run --with open-webui open-webui serve
    ```

    Перейдите по адресу [http://localhost:8080/](http://localhost:8080/), чтобы открыть интерфейс.
  </Step>

  <Step title="Настройте MCP-сервер ClickHouse" id="configure-clickhouse-mcp-server">
    Чтобы настроить 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)

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/0_endpoints.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=b37f0088435c19a0086059ba57f78814" alt="Конечные точки OpenAPI" size="md" width="1455" height="759" data-path="images/use-cases/AI_ML/MCP/0_endpoints.webp" />

    Чтобы использовать эти конечные точки в Open WebUI, перейдите в настройки:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/1_settings.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=33be06efdea1df329374b67049e101f5" alt="Настройки Open WebUI" size="md" width="518" height="575" data-path="images/use-cases/AI_ML/MCP/1_settings.webp" />

    Нажмите `Tools`:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/2_tools_page.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=fb687ad7bfed8c5691457d63967bdd07" alt="Инструменты Open WebUI" size="md" width="1829" height="1190" data-path="images/use-cases/AI_ML/MCP/2_tools_page.webp" />

    Добавьте [http://localhost:8000](http://localhost:8000) как URL инструмента:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/3_add_tool.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=3cc5057681654506c979cf02fde03755" alt="Инструмент Open WebUI" size="md" width="1838" height="1201" data-path="images/use-cases/AI_ML/MCP/3_add_tool.webp" />

    После этого рядом со значком инструмента на панели чата должна появиться цифра `1`:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/4_tools_available.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=5fc41a805ec365ddadbdf1ede96ef4c7" alt="Доступные инструменты Open WebUI" size="md" width="1495" height="229" data-path="images/use-cases/AI_ML/MCP/4_tools_available.webp" />

    Если нажать на значок инструмента, можно будет увидеть список доступных инструментов:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/5_list_of_tools.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=a67ce3e89aacdd7f9aef76dd8156947c" alt="Список инструментов Open WebUI" size="md" width="1373" height="711" data-path="images/use-cases/AI_ML/MCP/5_list_of_tools.webp" />
  </Step>

  <Step title="Настройте OpenAI" id="configure-openai">
    По умолчанию Open WebUI работает с моделями Ollama, но также можно добавить конечные точки, совместимые с OpenAI.
    Они настраиваются через меню настроек, но на этот раз нужно открыть вкладку `Connections`:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/6_connections.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=0a7c20543bff52fe4eb5ac37011454bf" alt="Подключения Open WebUI" size="md" width="1824" height="1184" data-path="images/use-cases/AI_ML/MCP/6_connections.webp" />

    Добавим конечную точку и ключ OpenAI:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/7_add_connection.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=258fdc427a090274a0ab9c95c439e215" alt="Open WebUI — добавить OpenAI как подключение" size="md" width="1821" height="1192" data-path="images/use-cases/AI_ML/MCP/7_add_connection.webp" />

    После этого модели OpenAI будут доступны в верхнем меню:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/8_openai_models_more.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=ee9e09f99e0376bfd640740d76445c86" alt="Open WebUI — модели" size="md" width="1574" height="1248" data-path="images/use-cases/AI_ML/MCP/8_openai_models_more.webp" />
  </Step>

  <Step title="Общайтесь с MCP-сервером ClickHouse через Open WebUI" id="chat-to-clickhouse-mcp-server">
    После этого можно начать диалог, и Open WebUI при необходимости обратится к MCP-серверу:

    <Image img="https://mintcdn.com/private-7c7dfe99-framing-web-ui/JD8rhpHOLGi1SSTp/images/use-cases/AI_ML/MCP/9_conversation.webp?fit=max&auto=format&n=JD8rhpHOLGi1SSTp&q=85&s=d360d518c12ac8c139c2eff4a4ab85de" alt="Open WebUI — чат с MCP-сервером ClickHouse" size="md" width="2449" height="1839" data-path="images/use-cases/AI_ML/MCP/9_conversation.webp" />
  </Step>
</Steps>
