Перейти к содержимому

MCP-сервер

В ffgit встроен сервер Model Context Protocol — ffgit-mcp. Агенты для программирования читают репозитории через собственное ядро Git в ffgit и могут попросить запущенное приложение их изменить. Сам сервер никогда ничего не записывает.

Главное меню → Coding agents (MCP)… показывает готовые к копированию команды, в которых уже разрешены папки проектов текущего рабочего пространства. Вспомогательная программа — это /Applications/ffgit.app/Contents/MacOS/ffgit-mcp на macOS, ffgit-mcp.exe рядом с ffgit.exe на Windows (по умолчанию в %LocalAppData%\Programs\ffgit) и /usr/bin/ffgit-mcp на Linux (или ffgit-mcp в папке ffgit из архива); передайте по одному --allow на каждую папку.

Terminal window
claude mcp add --scope user ffgit -- \
/Applications/ffgit.app/Contents/MacOS/ffgit-mcp --allow ~/code

Агенты, которых вы запускаете из ffgit, получают эти инструменты на время своей сессии автоматически. С ними запуск может также сообщать о коротком прогрессе — фаза, что сделано и следующий шаг, — и его карточка показывает это как Agent reported; такие сообщения никогда не меняют файлы или Git.

Только чтение: инструменты ничего не разрушают и идемпотентны.

ИнструментЧто возвращает
ffgit_statusВетку, HEAD, незавершённую операцию, проиндексированные, непроиндексированные, неотслеживаемые и конфликтующие файлы, связанные worktree
ffgit_branchesЛокальные и remote-tracking-ветки с upstream и счётчиками ahead/behind
ffgit_logИсторию всех веток или одной ссылки с поиском по сообщению, автору, хешу, пути или коду
ffgit_show_commitАвтора, дату, полное сообщение, родителей и изменённые файлы
ffgit_diffDiff рабочего дерева, индекса или между двумя коммитами, при необходимости для одного пути
ffgit_blame, ffgit_line_historyBlame для 2 000 строк максимум; git log -L для диапазона строк
ffgit_grepТочное вхождение текста в отслеживаемых файлах — в рабочем дереве или на коммите
ffgit_conflictsОперацию, какая сторона «наша», а какая «их», и каждый блок конфликта
ffgit_backupsРезервные копии этого worktree

Файлы из .ffignore выводятся отдельно, как ожидаемые изменения.

Изменения с вашего одобрения

Section titled “Изменения с вашего одобрения”

Агенты могут попросить проиндексировать файлы или убрать их из индекса, закоммитить, создать ветку, сделать stash, разрешить конфликт, продолжить операцию и — уже с потерей данных — пропустить коммит или прервать операцию. Push, pull, discard и удаление веток или worktree не предлагаются.

Запущенное приложение выполняет каждое изменение, предварительно создав резервную копию, согласно настройке Changes from agents в Coding agents (MCP)…:

  • Off — отклоняет все изменения.
  • Ask every time (по умолчанию) — показывает запрос с указанием агента, репозитория и изменения; изменение выполняется только после Approve.
  • Allow without asking — выполняет изменения сразу, включая хуки и фильтры репозитория.

Чат-оркестратор получает на время своей сессии инструменты для чатов: ffgit_chat_agents, ffgit_chat_start, ffgit_chat_send, ffgit_chat_wait, ffgit_chat_read, ffgit_chat_list, ffgit_chat_stop, ffgit_chat_answer и ffgit_chat_image. Он запускает чаты Claude Code и Codex в ваших проектах, пишет им, ждёт их и читает только те чаты, которые запустил сам.

Агенты вне ffgit получают те же инструменты только по разрешению: Coding agents (MCP)… → Outside agents that drive chats → Allow… выбирает самый высокий режим разрешений, которым может пользоваться агент (Up to Auto, Manual, Accept edits или Plan), и показывает команду claude mcp add … --chats <descriptor> для копирования. Take back отзывает разрешение; его чаты остаются. На Mac то же самое делает скрипт:

Terminal window
ffgit-mcp chat start --chats <descriptor> --folder ~/code/app \
--agent codex --message "Run the tests and fix what fails" --wait

Без разрешения сервер не предлагает инструментов для чатов. Вопросы и одобрения в чатах, которые запускает внешний агент, остаются за вами.

Откройте Coding agents (MCP)… → Computer use… и включите Offer computer use to new chats для новых чатов Claude Code и Codex. macOS выдаёт вспомогательному приложению ffgit Computer Use разрешение Accessibility для чтения элементов интерфейса и Screen Recording для снимков окна. ffgit отдельно запрашивает доступ для чата и для каждого приложения. Разрешение можно сохранить для чата или проекта либо выбрать Only this time.

При чтении агент получает элементы интерфейса и текст одного разрешённого окна. Он также может запросить снимок. Эти данные передаются провайдеру агента вместе с чатом. В режимах Plan и Read only доступно чтение. Если режим допускает управление, агент может нажимать кнопки и клавиши, вводить текст и прокручивать окно. Кнопка Stop на плавающей панели прерывает действие. Если чатом управляет ffgit, она также завершает текущий ход агента.

Панель самого помощника заблокирована. В список блокировки входят известные терминалы, приложения других агентов, редакторы со встроенным терминалом, системные настройки, окна проверки подлинности, Связка ключей и менеджеры паролей. Если разрешить управление самим ffgit, агент получит доступ к собственным запросам на подтверждение и настройкам Privacy….

Для внешнего агента откройте Coding agents (MCP)… → Outside agents that use other apps и выберите Read windows only или Read and act. Доступ к каждому приложению по-прежнему выдаётся отдельно. Содержимое окна получает этот внешний агент. Разрешения Computer Use и их отзыв.