Настройки и хранение данных

Сетевые адреса

Переменная окружения	По умолчанию	Назначение
MCPBOX_HOST	127.0.0.1	Адрес прослушивания панели.
MCPBOX_PORT	38181	Порт панели.
MCPBOX_MCP_HOST	127.0.0.1	Адрес прослушивания MCP-подключений.
MCPBOX_MCP_PORT	38182	Порт MCP-подключений.
MCPBOX_PUBLIC_MCP_URL	не задана	Публичный HTTPS origin MCP/OAuth без пути.

Например, чтобы оставить прежний порт панели:

MCPBOX_PORT=38180 ./MCPBox

Также доступны флаги -host, -port, -mcp-host и -mcp-port. Явные флаги имеют приоритет над окружением. MCP-порт обслуживает подключения, OAuth/discovery и проверку доступности, но не панель управления.

Адрес прослушивания 0.0.0.0 не является адресом назначения для клиента. В клиенте указывайте доступное имя хоста или IP. Для удалённого HTTPS-доступа используйте reverse proxy перед нужным портом. Сохраните маршруты MCP, /oauth/*, /.well-known/*, сведения о внешнем хосте и протоколе и потоковую передачу. Если нужны удалённое управление или OIDC callback, отдельно обеспечьте доступ к порту панели.

Публичный MCP URL и OAuth

Задайте MCPBOX_PUBLIC_MCP_URL=https://mcp.example.com в окружении процесса MCPBox и перезапустите службу. Значение должно быть HTTPS origin: без учётных данных, пути, query и fragment. Завершающий слеш допустим. Некорректное значение игнорируется; без корректного значения адрес определяется по запросу и заголовкам прокси.

Этот origin используется для OAuth discovery, метаданных защищённого ресурса и основного URL подключения проекта (https://mcp.example.com/mcp/<project-token>). Интерфейс показывает и копирует адрес от бэкенда, даже если админка использует другой домен или порт. Переменная не меняет адреса listener и не настраивает прокси.

При раздельных listener маршруты /.well-known/ и /oauth/ обслуживаются на MCP listener (по умолчанию 38182); административный listener возвращает для них 404. Направляйте эти пути и /mcp/ на MCP listener. OIDC-вход в административную панель по-прежнему использует /api/pro/sso/callback на admin listener. См. подключение ChatGPT и сетевой доступ.

Рабочие файлы

По умолчанию пути разрешаются рядом с исполняемым файлом:

Путь	Содержимое
mcpbox.db	База SQLite, включая начальные настройки и состояние доступа.
package_store/	Установленные управляемые пакеты.
skill_store/	Пакеты Skills, файлы заданий и результаты.
knowledge_base/	Локальные данные коллекций и индексы.
.mcpboxpro/rag-shadow/	Совместимый путь к теневым данным RagBox.

Папка должна быть постоянной и доступной для записи. Запуск того же бинарника из другой текущей директории не переключает базу. Сохраняйте учётные данные и пути к внешним источникам как часть конфигурации установки.

Настройки хранилища

Раздел хранилища различает начальную SQLite, выбранную операционную базу и фактически активную базу.

• SQLite остаётся начальной базой, включая авторизацию и конфигурацию хранилища.
• PostgreSQL может хранить состояние интеграций и теневые записи проектов и знаний. Настраиваются хост, порт, база, схема, пользователь и пароль.
• Основные записи проектов и серверов, а также базовые записи аудита продолжают использовать общее хранилище SQLite. Выбор PostgreSQL не переносит туда всё приложение.
• Если PostgreSQL недоступна или настроена не полностью, runtime сообщает о возврате к SQLite. После сохранения проверьте активную базу и причину fallback.

Настройки ClickHouse и Elasticsearch сейчас позволяют сохранить конфигурацию и проверить подключение и статус выбранного хранилища логов. Существующие обработчики аудита продолжают писать в общее хранилище; доступность внешнего сервиса ещё не подтверждает полную доставку логов в него. Не удаляйте SQLite и её резервные копии после изменения этих настроек.

Логи и диагностика

В логах проекта и общем журнале доступны действия управления, MCP-методы, трассировки проверок, события доступа. Метрики показывают количество запросов, ошибки, задержки и трафик. Диагностика проверок маскирует секреты, но учётные данные всё равно стоит передавать через окружение, а не аргументы команд.

Порядок резервного копирования и миграции описан в обновлении. Переменные OIDC — в разделе доступа, настройки RagBox — во внешних интеграциях.

Интерфейс настроек

Настройки разделены на Система (хранилище, RagBox) и Безопасность (доступ, пользователи, сессии). Справка открывается кнопкой !, подробная диагностика хранилища свёрнута. Сохранённая конфигурация не означает успешное подключение. Ошибка RagBox отображается в его разделе с повтором и техническими подробностями.

Переключатель внизу навигации и на экране входа выбирает светлую, тёмную или системную тему. Выбор сохраняется в этом браузере.

Доступ по сети

Оба порта по умолчанию доступны только локально. Для прямого подключения с другой машины явно задайте --mcp-host 0.0.0.0 или нужный сетевой адрес и настройте firewall, HTTPS и авторизацию. Не вводите 0.0.0.0 как адрес клиента. Прокси на той же машине, включая Funnel, может работать с локальным 127.0.0.1:38182. См. подключение ChatGPT.

Базу и skill_store/ сохраняйте одной согласованной копией. Переменная MCPBOX_RUNTIME_CONTEXT_HMAC_SECRET больше не используется: миграция PolicyBox.