Open WebUI·open-webui
Open WebUI MCP — подключение и инструкция
mcpo помогает подключать MCP-инструменты к Open WebUI и другим приложениям, которые ожидают OpenAPI HTTP-интерфейс.
Что умеет этот сервер
mcpo помогает подключать MCP-инструменты к Open WebUI и другим приложениям, которые ожидают OpenAPI HTTP-интерфейс.
Это прокси MCP → OpenAPI, а не отдельный сервер с доступом к данным какого-то сервиса.
Начни с одного простого read-only инструмента.
Задача для знакомства
Помоги подключить один тестовый MCP к Open WebUI через mcpo. Сначала проверь схему и read-only вызов; другие подключения не меняй.
Уточнить результат
Проверь отдельно запуск исходного MCP, работу proxy и доступность OpenAPI в клиенте. Ошибка одного слоя не означает, что нужно перенастраивать все сервера.
Как подключить
Выберите подходящий способПодключить Open WebUI MCP
Установи или запускай mcpo способом из Quick Start README. Укажи команду нужного MCP после разделителя аргументов либо config-файл со своими серверами. Настрой API key и локальный порт, затем добавь OpenAPI endpoint в Open WebUI.
Что понадобится
- Python 3.8+/uv, исходный MCP-сервер с собственными зависимостями и OpenAPI-совместимый клиент.
- 01
Подготовь окружение
Python 3.8+/uv, исходный MCP-сервер с собственными зависимостями и OpenAPI-совместимый клиент.
- 02
Установи и настрой
Установи или запускай mcpo способом из Quick Start README. Укажи команду нужного MCP после разделителя аргументов либо config-файл со своими серверами. Настрой API key и локальный порт, затем добавь OpenAPI endpoint в Open WebUI.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Первый запрос — пример для чата агента
Помоги подключить один тестовый MCP к Open WebUI через mcpo. Сначала проверь схему и read-only вызов; другие подключения не меняй.Как проверить
Проверь отдельно запуск исходного MCP, работу proxy и доступность OpenAPI в клиенте. Ошибка одного слоя не означает, что нужно перенастраивать все сервера.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Open WebUI
mcpo помогает подключать MCP-инструменты к Open WebUI и другим приложениям, которые ожидают OpenAPI HTTP-интерфейс.
Это прокси MCP → OpenAPI, а не отдельный сервер с доступом к данным какого-то сервиса. Он запускает выбранный MCP и публикует его инструменты как HTTP API.
Что подготовить перед подключением
Python 3.8+/uv, исходный MCP-сервер с собственными зависимостями и OpenAPI-совместимый клиент.
Как установить и подключить
Установи или запускай mcpo способом из Quick Start README. Укажи команду нужного MCP после разделителя аргументов либо config-файл со своими серверами. Настрой API key и локальный порт, затем добавь OpenAPI endpoint в Open WebUI.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Начни с одного простого read-only инструмента. Сравни его исходную схему MCP с доступным OpenAPI endpoint и проверь ответ в Open WebUI.
Как проверить результат и решить проблемы
Проверь отдельно запуск исходного MCP, работу proxy и доступность OpenAPI в клиенте. Ошибка одного слоя не означает, что нужно перенастраивать все сервера.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Прокси не добавляет capabilities отсутствующего MCP. HTTP-публикация меняет поверхность доступа; ключи и разрешённые интерфейсы нужно настроить до внешнего использования.
Исходники и документация
Репозиторий: open-webui/mcpo. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.