MACRO

Open WebUI + MacroData

#Подключение MacroData к Open WebUI

Подключите MacroData к Open WebUI, чтобы задавать ИИ-ассистенту аналитические вопросы по данным вашей компании: о сделках, продажах и платежах, проектах и т.д. Доступ к аналитической базе предоставляется только на чтение.

Подключение настраивает администратор Open WebUI в разделе Admin → Settings → Integrations, в блоке External Tool Servers. Администратор MACRO разрешает сотрудникам доступ к MacroData и добавляет адрес возврата в панели «Доступы» на странице настройки MacroData. Каждый сотрудник подтверждает доступ под своей учётной записью MACRO.

#Подготовьте доступ в MACRO

Выполняется сотрудниками поддержки:

  1. Откройте страницу настройки MacroData и найдите панель «Доступы».
  2. Отметьте сотрудников, которым разрешено подключение через MCP.
  3. Нажмите Сохранить доступ.

#Разрешите Callback URL в MACRO

Callback URL — полный адрес Open WebUI, на который MACRO возвращает пользователя после подтверждения доступа. Это не адрес MCP-сервера и не просто главная страница Open WebUI.

При идентификаторе подключения ID = openwebui и домене gpt.macrodom.ru укажите:

https://<домен-Open-WebUI>/oauth/clients/mcp:openwebui/callback

Для другой установки адрес строится из её внешнего адреса и идентификатора подключения:

https://<домен-Open-WebUI>/oauth/clients/mcp:<ID-подключения>/callback
  1. На странице настройки MacroData в панеле «Доступы».
  2. В поле «Разрешённые OAuth callback URL» добавьте полный адрес отдельной строкой. Сохраните другие адреса, которые нужны вашей компании.
  3. Нажмите Сохранить callback URL.
  4. Дождитесь сообщения «Callback URL сохранены» и убедитесь, что нужный адрес остался в поле.

Разрешение действует только для текущей компании и точного адреса. Используйте HTTPS URL без параметров, фрагмента, логина, пароля и масок. Не добавляйте завершающий слеш, если его нет в адресе, сформированном Open WebUI.

#Добавьте подключение в Open WebUI

  1. Войдите в Open WebUI под учётной записью администратора.
  2. Откройте Admin → Settings → Integrations.
  3. В блоке External Tool Servers нажмите + (Add Connection).
  4. Заполните параметры подключения:
ПолеЗначение
TypeMCP (Streamable HTTP)
NameMacroData
IDopenwebui — идентификатор подключения в этом примере
URLhttps://api.macroserver.ru/macrodata/mcpПереход на внешний сайтhttps://api.macroserver.ru/macrodata/mcp
AuthOAuth 2.1
OAuth Scopes, если поле доступноmacrodata:read

Если ваша система использует другой домен, уточните адрес API у администратора. Путь MCP остаётся /macrodata/mcp.

  1. Нажмите Register Client и дождитесь сообщения об успешной регистрации.
  2. Сохраните подключение кнопкой Save. После регистрации не меняйте ID: он участвует в адресе возврата.

Для этого подключения используется OAuth 2.1 с динамической регистрацией клиента. Не выбирайте OAuth 2.1 (Static) и не вводите самостоятельно придуманные Client ID или Client Secret. Адреса авторизации и получения токена Open WebUI определяет через OAuth discovery.

Названия элементов приведены для английского интерфейса. Их расположение и перевод могут отличаться в вашей установке.

#Подтвердите подключение

  1. Откройте сохранённое подключение и нажмите Authorize OAuth, если эта кнопка доступна, либо начните авторизацию при использовании подключения в чате.
  2. На странице MACRO войдите под сотрудником, которому предоставлен доступ. Проверьте, что выбрана нужная компания.
  3. Подтвердите подключение кнопкой Подтвердить.
  4. Дождитесь возврата в Open WebUI.

#Проверьте работу в чате

  1. Откройте чат и включите подключение MacroData в списке доступных инструментов.
  2. Выберите модель с поддержкой вызова инструментов.
  3. Задайте вопрос, например: «Сколько сейчас просроченных платежей и какова их сумма?».
  4. Убедитесь, что ассистент обращается к MacroData и возвращает результат по данным, а не только сообщает о готовности выполнить расчёт.

#Если подключение не работает

#«Callback URL не разрешён для этой компании. Обратитесь к администратору»

Сравните значение redirect_uri из запроса авторизации со строкой в поле «Разрешённые OAuth callback URL». Проверьте домен, HTTPS, идентификатор подключения, двоеточие после mcp и завершающий слеш. Убедитесь, что адрес сохранён именно для компании, выбранной при авторизации. После исправления начните авторизацию заново.

#Подключение прошло, но модель не может прочитать схему

Если модель сообщает о недоступности status, overview или resources/read, передайте администратору Open WebUI текст ошибки, версию приложения и способ подключения MCP. Это отдельная проблема доступности ресурсов для модели; замена callback её не устраняет.

Не просите модель угадывать таблицы или пропускать проверку данных. Администратору нужно проверить, предоставляет ли подключение механизм чтения ресурсов MCP. Для другого клиента используйте инструкции Claude.ai + MacroDataПереход на внешний сайтhttps://yt.macrodigital.ru/articles/DOCS-A-732 или ChatGPT (Codex) + MacroDataПереход на внешний сайтhttps://yt.macrodigital.ru/articles/DOCS-A-733.

#Open WebUI не может подключиться к серверу

Попросите администратора проверить доступность MCP URL из среды, где работает Open WebUI, включая контейнер, DNS и HTTPS-сертификат. Доступность адреса в браузере пользователя сама по себе не подтверждает доступность из контейнера.

#