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

Настройте проект

Проект объединяет MCP-серверы, CLI, Skills, коллекции знаний и промпт за одним URL. Корневой путь должен указывать на существующую папку на машине с MCPBox: она используется как рабочая директория команд CLI.

Внутри проекта настройки разделены на MCP, Skills, CLI, RAG и Prompt. Включайте нужные клиенту интеграции. Пауза проекта блокирует запросы к его MCP-адресу; отключённый сервер исключается из общего набора возможностей.

Добавьте MCP-сервер

Транспорт	Что указать
Локальный stdio	Программу, аргументы, рабочую папку и окружение. MCPBox управляет процессом.
Удалённый HTTP	MCP-адрес удалённого сервиса и параметры его авторизации. Сервис запускается отдельно.

Передавайте секреты через поля окружения, а не через аргументы команды. Авторизация удалённого сервера и Bearer-защита адреса вашего проекта — разные настройки.

MCPBox проверяет сервер при создании и изменении. Кнопка Check / Проверить запускает ручную проверку: MCP-рукопожатие и получение возможностей; для некоторых интеграций также вызывается диагностический инструмент. Действие Info / Информация показывает метаданные, инструменты, ресурсы, промпты и найденный рядом README локального stdio-сервера. В настройках инструментов сервера можно отключить отдельные инструменты.

Подключите ИИ-клиент

Скопируйте адрес подключения из интерфейса проекта. Типичный локальный адрес:

http://localhost:38182/mcp/<project-token>

Выберите HTTP MCP в совместимом клиенте. Для клиента на другой машине замените localhost доступным адресом сервера. Внутри контейнера localhost указывает на сам контейнер.

Если включена Bearer-защита проекта, добавьте:

Authorization: Bearer <project-bearer-token>

Токен в URL и Bearer-токен выполняют разные задачи. Токен сессии администратора и административный токен агента — также отдельные учётные данные. После перегенерации токена проекта обновите затронутые клиенты.

MCPBox собирает инструменты, ресурсы и промпты включённых серверов и направляет вызовы источнику. При совпадении имён используются псевдонимы. В зависимости от настроек проекта также доступны get_project_env_and_rules, search_project_knowledge, инструменты CLI и MCP-промпт project_prompt.

Промпт проекта

В разделе Prompt задайте инструкции и правила проекта. Непустой промпт доступен в MCP как project_prompt. Обычный MCP-клиент сам решает, запрашивать ли и применять ли его: одно подключение URL не заставляет любую модель использовать промпт. Лаунчер llama.cpp дополнительно передаёт его через файл системного промпта.

Запуск с локальными моделями

• Ollama: установите ollama, загрузите модель, выберите её в проекте и используйте действие запуска, когда оно доступно.
• LM Studio: выберите Launch Project → Add to LM Studio и подтвердите открытие ссылки в LM Studio.
• llama.cpp: установите llama-server в PATH, выберите локальный .gguf или задайте MCPBOX_LLAMACPP_MODEL, затем выберите запуск llama.cpp. MCPBox запустит сервер и откроет его веб-интерфейс.

Эти программы и файлы моделей устанавливаются отдельно. Доступные действия зависят от найденных программ и настроек проекта.

OAuth-подключения проекта

Для клиентов вроде ChatGPT, использующих предусмотренный OAuth-процесс:

1. Включите Bearer-защиту проекта.
2. Создайте именованное OAuth-подключение в проекте и укажите точный callback URL, предоставленный клиентом.
3. Используйте имя подключения как client ID, а сгенерированный токен — как client secret.
4. Укажите доступный MCP-адрес проекта в клиенте и завершите авторизацию.

Это подключение заранее настроенного клиента с authorization code и PKCE (S256), без динамической регистрации клиентов. Отключите или удалите подключение для отзыва доступа. Вход в панель через OIDC настраивается отдельно.

Для удалённого доступа предоставьте HTTPS-адрес через reverse proxy вашей установки, сохранив маршруты MCP, OAuth и discovery. Подробнее — в настройках.

Порядок проектов

Перетаскивайте проект за ручку или используйте стрелки вверх/вниз и клавиатуру. Порядок сохраняется в текущем браузере отдельно для пользователя, новые проекты добавляются в конец; между устройствами он не синхронизируется. В текущих исходниках после перезагрузки открывается первый проект в сохранённом порядке. Это исправление следует за v1.4.0; старый бинарник может выбирать первый ID. Обновление списка сохраняет текущий ручной выбор.

Проект только с подключёнными Skills тоже принимает MCP-подключения. Каталог и сценарий работы описаны в Skills, облачное и локальное подключение — в ChatGPT и локальные клиенты.

Форматы HTTP-ответов

Для удалённых HTTP MCP-серверов MCPBox отправляет Accept: application/json, text/event-stream, если свой Accept не задан в настройках. Успешные JSON-ответы сохраняют прежний путь разбора. Ответы с Content-Type: text/event-stream читаются как SSE: многострочные поля data: объединяются, возвращается JSON-RPC ответ с ID исходного запроса, уведомления и посторонние события пропускаются. Чтение заканчивается при получении ответа, не дожидаясь закрытия потока сервером.

Сохраняется поддержка старых JSON-ответов без корректного Content-Type. Узнаваемые SSE-префиксы также позволяют прочитать поток с неверным заголовком без повторного запроса. HTTP-ошибки и JSON-RPC ошибки остаются ошибками; неудачный вызов не отправляется повторно ради другого формата. Лимиты размера ответа и отмена запроса сохраняются. Общий разборщик используется для проверки сервера и рабочих MCP-вызовов.