跳转到内容

MCP服务器

ffgit在应用内附带一个Model Context Protocol服务器ffgit-mcp。编程智能体通过ffgit自己的Git核心读取仓库,并可以请求正在运行的应用修改仓库。服务器本身从不写入。

打开主菜单 → Coding agents (MCP)…,即可看到可直接复制的命令,这些命令已允许当前工作空间的项目文件夹。辅助程序在macOS上位于/Applications/ffgit.app/Contents/MacOS/ffgit-mcp,在Windows上是ffgit.exe旁边的ffgit-mcp.exe(默认位于%LocalAppData%\Programs\ffgit),在Linux上是/usr/bin/ffgit-mcp(或tar.gz压缩包解压后ffgit文件夹中的ffgit-mcp);每个文件夹传入一个--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、未完成的操作,已暂存、未暂存、未跟踪和有冲突的文件,关联工作树
ffgit_branches本地分支和远程跟踪分支,包括上游以及领先/落后的提交数
ffgit_log所有分支或某个引用的历史,可按提交信息、作者、哈希、路径或代码搜索
ffgit_show_commit作者、日期、完整提交信息、父提交和改动的文件
ffgit_diff工作区、暂存区或两个提交之间的差异,可限定为单个路径
ffgit_blame, ffgit_line_history最多2000行的blame;对某个行范围执行git log -L
ffgit_grep在工作区或某个提交中搜索已跟踪文件里的字面文本
ffgit_conflicts当前操作、哪一侧是ours和theirs,以及每个冲突块
ffgit_backups工作树的恢复副本

.ffignore中列出的文件会作为预期内的改动单独报告。

智能体可以请求暂存、取消暂存、提交、创建分支、贮藏(stash)、解决冲突、继续某个操作,以及(具有破坏性的)跳过提交或中止操作。推送、拉取、丢弃以及删除分支或工作树均不提供。

正在运行的应用会根据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 将 Accessibility 和 Screen Recording 权限授予辅助应用 ffgit Computer Use,分别用于读取控件和截取窗口图像。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 授权与撤销.