Маркет и база знаний
Установка интеграции из Маркета
- Откройте Маркет и синхронизируйте каталог. Синхронизация также выполняется при открытии раздела.
- Выберите интеграцию и проверьте необходимые программы и runtime.
- Установите пакет, заполните настройки и секреты, подключите его к проекту.
- Проверьте работоспособность сервера перед использованием в клиенте.
Определения интеграций загружаются из удалённого JSON-манифеста или локального файла. Каталог Маркета по умолчанию — https://mcpbox.sh/catalog.json; каталог CLI хранится отдельно.
Установленный пакет можно использовать в нескольких проектах. Каждое подключение создаёт управляемый MCP-сервер с настройками конкретного проекта. Перед удалением общего пакета проверьте, где он используется.
Манифест может описывать необходимые программы, окружение, секретные поля и проверки после установки. Отсутствие зависимостей может блокировать установку. Стратегии go_install нужны Go и устанавливаемый Go-модуль с исполняемой программой. Docker-интеграциям нужен Docker; они используют ограниченный процесс docker run --rm -i. Маркет не управляет Compose-окружениями.
Создание локальной коллекции знаний
- Откройте Базу знаний и создайте коллекцию.
- Укажите папку источников на машине, где работает MCPBox.
- Запустите индексацию и проверьте результат.
- Найдите известное слово, чтобы убедиться, что нужные файлы попали в поиск.
- Подключите коллекцию в разделе RAG нужного проекта.
Коллекции общие: одна может использоваться несколькими проектами, а проект может подключать несколько коллекций. Отключение связи с проектом и удаление коллекции — разные действия. Перед удалением общих знаний проверьте все подключения.
Поддерживаемые локальные файлы
Локальный индекс принимает .go, .js, .php, .md, .txt, .csv, .xlsx, .docx, .pptx и .pdf. Для PDF нужен текстовый слой. Встроенное извлечение не выполняет OCR сканов и изображений.
Служебные и сгенерированные папки, включая .git, node_modules, vendor, dist и build, пропускаются. Результаты содержат пути к источникам и, когда доступны, указания листа, слайда или страницы. Локальная индексация использует полнотекстовый поиск Bleve, без обязательных эмбеддингов и векторной базы. Используйте конкретные слова из документов: этот режим не выполняет семантический поиск.
Для периодического сканирования включите автоматическую переиндексацию при создании или изменении коллекции bleve_only: цикл выполняется раз в десять минут. По умолчанию она выключена и недоступна для RagBox-only и двойного режима. После изменения файлов индексацию также можно запустить вручную.
Режимы коллекции и загрузка файлов
Коллекция может работать в режиме bleve_only (локально), ragbox_only (внешний сервис) или dual (оба механизма). Для коллекций RagBox выберите существующий workspace или настройте векторное подключение, необходимое вашей установке.
В карточке коллекции также доступна загрузка файла. Режим keep сохраняет загруженный источник в управляемой папке коллекции, transient удаляет временный источник после обработки. Временный источник нельзя использовать для последующей полной переиндексации, поэтому храните оригиналы отдельно. Проверяйте результат локальной обработки и RagBox: принятая внешняя задача загрузки ещё может выполняться.
Поиск из ИИ-клиента
Подключённые коллекции доступны через встроенный MCP-инструмент search_project_knowledge. Подключите коллекцию к проекту клиента, обновите инструменты и попросите клиента выполнить поиск по базе знаний. Создание общей коллекции само по себе не подключает её ко всем проектам.
Внешний поиск через RagBox
Необязательная интеграция RagBox подключает отдельно запущенный сервис загрузки и поиска. Укажите адрес сервиса, tenant, API-токен и при необходимости admin-токен, затем синхронизируйте и свяжите коллекции. Настройка и режимы описаны в разделе внешних интеграций.
Локальный поиск Bleve и поиск RagBox — отдельные механизмы. Возможности семантического и векторного поиска зависят от подключённого RagBox и его настроек.
Новый интерфейс базы знаний
Карточки компактны: ! открывает справку или сведения коллекции, Поиск — единый диалог запроса и результатов, включая загрузку и ошибки. Закрытие окна во время запроса не открывает его повторно.
Если загрузка/переиндексация завершается missing bearer token, операция не подтверждена. Это известное серверное ограничение, в том числе при нестандартном admin-порте; сохраните исходный документ и проверьте Логи. Само обновление интерфейса не устраняет эту ошибку.