Документация

MCP: VibeForge для внешних агентов

Подключите Claude Code, Codex или другого доверенного агента к VibeForge по токену: чтение проектов и сессий, тикеты «Фабрики», ожидание событий, а с полным управлением — всё, что вы делаете в окне. Доступно в подписке.

У VibeForge есть собственный MCP-сервер: ваш агент, работающий снаружи — в Claude Code, Codex или другом клиенте, — может читать проекты, состояние сессий, ожидания, изменения и расход токенов, а с отдельным правом — заводить и вести тикеты «Фабрики». Доступ выдаётся токеном и требует подписки на том компьютере или сервере, к которому подключено приложение.

Что умеет

Право	Инструменты
Чтение	Список проектов и сессий, состояние сессии, изменения и дифф, расход, возможности (какие режимы открыты и что с каждым движком), сводка, черновик запуска без самого запуска.
Чтение + тикеты фабрики	Доски, тикеты и журнал переходов «Фабрики», ожидание событий; завести тикет текстом или из GitHub issue, поправить его, ответить на вопросы разбора, решить «ещё круг» / «вернуть» / «отложить», поставить доску на паузу.
Одобрение (отдельная галочка)	Принять тикет как есть без пройденных проверок и утвердить план оркестратора.
Полное управление	Всё, что вы делаете в окне: заводить сессии и писать агентам, очередь и остановка, модели и режимы, решения по планам и воротам, git, «Применить в проект», «Фабрика» и скиллы.

Полное управление выдавайте только своему агенту. Удаление, push, «Применить в проект» и откаты он выполнит, только если явно подтвердит действие в самом запросе; без подтверждения получит описание того, что произошло бы. Терминал, файлы, окружение, лицензия и сопряжение устройств по MCP закрыты при любых правах.

Выдать доступ

1Откройте «Настройки → Сервер → MCP — доступ внешних агентов». Карточка показывает, настраиваете вы компьютер или подключённый сервер, и его адрес.
2Задайте имя клиента, срок (по умолчанию 90 дней; бессрочный выбирается отдельно) и права. Права токена не меняются — для других прав выпускается новый.
3Нажмите «Выпустить токен» и сохраните секрет: он показывается один раз, в базе хранится только хэш. Пример конфигурации скопируйте отдельно — секрета в нём нет.
4Подставьте адрес из карточки и задайте VIBEFORGE_MCP_TOKEN в окружении процесса клиента. Переменная относится к клиенту, а не к серверу VibeForge.
5Проверьте чтение текущей сессии и её несохранённых правок. Ненужный доступ отзовите в списке токенов.

Каждый токен открывает чтение всех проектов этого бэкенда, без изоляции по проекту. Фильтр скрывает типичные файлы с секретами, но не ищет секреты, вписанные в обычный исходник. Выдавайте доступ только доверенному клиенту.

Пример для Claude Code

{
  "mcpServers": {
    "vibeforge": {
      "type": "http",
      "url": "http://127.0.0.1:4820/mcp",
      "headers": { "Authorization": "Bearer ${VIBEFORGE_MCP_TOKEN}" }
    }
  }
}

Используйте адрес из настроек: фактический порт компьютера или ssh-туннеля может отличаться от примера. Codex CLI берёт адрес и имя переменной с секретом параметрами -c mcp_servers.vibeforge.url=… и -c mcp_servers.vibeforge.bearer_token_env_var=VIBEFORGE_MCP_TOKEN. Любому другому HTTP-клиенту нужны этот адрес и заголовок Authorization: Bearer <MCP-токен>; основной токен подключения VibeForge для этого не подходит. Клиенты, которым требуется OAuth, прямой браузерный доступ или только stdio, пока не поддерживаются.

Агент ведёт тикеты «Фабрики»

Рекомендованный цикл: прочитать доску проекта, затем ждать событий с курсором из прошлого ответа — ответ приходит на первом событии или по таймауту, и вызов повторяется. Журнал переходов хранится в базе, поэтому после офлайна и перезапуска ничего не теряется. На интересном событии агент читает тикет: вопросы разбора, находки ревью, итоги стадий, доступные решения — и отвечает теми же инструментами. Каждый его переход записывается в журнал с автором.

Закрыть доступ и работа на сервере

«Отозвать» навсегда закрывает один токен; выключатель MCP закрывает весь маршрут, сохраняя список токенов. Просмотр, отзыв и выключение доступны и после окончания подписки. Клиент на вашем компьютере может использовать ssh-туннель приложения к серверу. Клиенту на другой машине нужен отдельный HTTPS-адрес, который публикует только /mcp; остальные маршруты и WebSocket оставьте закрытыми — публичный HTTP передаёт секрет открытым текстом.

Чтение по токену ничего не пишет в репозиторий и не запускает программы из его настроек: файл под фильтром git сравнивается как лежит на диске, правки внутри подмодуля не раскрываются. Когда что-то прочитать нельзя, ответ говорит об этом полем incomplete, а не выдаёт пустой список за «изменений нет».