MCP-сервер

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

Настройка

Главное меню → Coding agents (MCP)… показывает готовые к копированию команды, в которых уже разрешены папки проектов текущего рабочего пространства. На macOS вспомогательная программа находится в /Applications/ffgit.app/Contents/MacOS/ffgit-mcp; передайте по одному --allow на каждую папку.

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

codex 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, получают эти инструменты на время своей сессии автоматически.

Инструменты чтения

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

Инструмент	Что возвращает
`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 выводятся отдельно, как ожидаемые изменения.

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

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

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

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