MCP-сервер
В ffgit встроен сервер Model Context Protocol — ffgit-mcp. Агенты для программирования читают репозитории через собственное ядро Git в ffgit и могут попросить запущенное приложение их изменить. Сам сервер никогда ничего не записывает.
Настройка
Section titled “Настройка”Главное меню → 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 на каждую папку.
claude mcp add --scope user ffgit -- \ /Applications/ffgit.app/Contents/MacOS/ffgit-mcp --allow ~/codecodex mcp add ffgit -- \ /Applications/ffgit.app/Contents/MacOS/ffgit-mcp --allow ~/code{ "mcpServers": { "ffgit": { "command": "/Applications/ffgit.app/Contents/MacOS/ffgit-mcp", "args": ["--allow", "/Users/you/code"] } }}Агенты, которых вы запускаете из ffgit, получают эти инструменты на время своей сессии автоматически. С ними запуск может также сообщать о коротком прогрессе — фаза, что сделано и следующий шаг, — и его карточка показывает это как Agent reported; такие сообщения никогда не меняют файлы или Git.
Инструменты чтения
Section titled “Инструменты чтения”Только чтение: инструменты ничего не разрушают и идемпотентны.
| Инструмент | Что возвращает |
|---|---|
ffgit_status | Ветку, HEAD, незавершённую операцию, проиндексированные, непроиндексированные, неотслеживаемые и конфликтующие файлы, связанные worktree |
ffgit_branches | Локальные и remote-tracking-ветки с upstream и счётчиками ahead/behind |
ffgit_log | Историю всех веток или одной ссылки с поиском по сообщению, автору, хешу, пути или коду |
ffgit_show_commit | Автора, дату, полное сообщение, родителей и изменённые файлы |
ffgit_diff | Diff рабочего дерева, индекса или между двумя коммитами, при необходимости для одного пути |
ffgit_blame, ffgit_line_history | Blame для 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 — выполняет изменения сразу, включая хуки и фильтры репозитория.
Инструменты для чатов
Section titled “Инструменты для чатов”Чат-оркестратор получает на время своей сессии инструменты для чатов: 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 то же самое делает скрипт:
ffgit-mcp chat start --chats <descriptor> --folder ~/code/app \ --agent codex --message "Run the tests and fix what fails" --waitБез разрешения сервер не предлагает инструментов для чатов. Вопросы и одобрения в чатах, которые запускает внешний агент, остаются за вами.
Computer Use
Section titled “Computer Use”Откройте 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 и их отзыв.