Insta Edits for Claude

本地服务

github.com其他1今天更新

代码仓库访问官网

关于 Insta Edits for Claude

Insta Edits for Claude 将 Claude Code 接入 Edits for Mac 的本地自动化服务。它会在应用从主页切换到完整视频编辑器时同步工具列表，并处理响应兼容性与令牌存储。

主要功能

01同步变化的编辑器工具列表
02桥接 stdio MCP 与本地 HTTP
03规范化部分工具响应
04避免令牌出现在日志中
05提供连接诊断

适用场景

01用 Claude Code 在 Edits for Mac 编辑 Reels
02打开项目后调用编辑器工具
03排查应用、令牌或连接问题

MCP 相关

这是一个 stdio MCP 服务端，在 MCP 客户端与 Edits for Mac 的本地 HTTP 自动化服务之间转发请求。它检测工具集变化并通知客户端，使完整编辑器工具可用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "faisalkhanzemi-insta-edits": {
      "command": "uvx",
      "args": [
        "insta-edits"
      ],
      "env": {
        "EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>",
        "EDITS_MCP_URL": "<EDITS_MCP_URL>"
      }
    }
  }
}

启动命令uvx insta-edits

需要配置的环境变量

EDITS_MCP_TOKEN密钥Access token from Edits › Settings › Automation

EDITS_MCP_URLEdits automation endpoint (default http://127.0.0.1:19501/mcp)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiinsta-edits0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Claude 的 Insta Edits

让 Claude Code 在 Mac 版 Instagram Edits 中编辑，使用完整编辑器，而不只是主屏幕。

_{一个提示词，一次真实的 Claude Code 会话，没有任何脚本。Edits 没有找到节拍，所以 Claude 自行分析了音乐（122 BPM），按节拍剪切每个片段，检查自己的画面，然后导出短片。观看带声音版本。}

Meta 于 2026 年 11 月 5 日推出的 Mac 版 Edits 内置了一个支持 MCP 的自动化服务：用 Meta 的话说，你可以将 AI Agent“通过 MCP 连接到桌面编辑器，让它们协助处理你的项目”。你可以直接让 Claude Code 连接它，但只能使用其中一部分功能。

Edits 会根据屏幕切换工具。主屏幕提供 32 个工具：项目、导入和目录。打开项目后，它会提供 274 个工具，涵盖文本、字幕、特效、转场、关键帧、音频和导出。Edits 会声明工具发生变化（tools.listChanged: true），但从不发送通知。整个会话中，Claude 始终只能使用主屏幕上的 32 个工具，看不到编辑器。

这个桥接层连接了两者。每次工具调用后，它都会询问 Edits 当前提供哪些工具。如果工具集合发生变化，它就会通知 Claude，由 Claude 刷新列表。它还修复了部分 Claude Code 构建版本会拒绝的回复格式、提供易读的错误信息，并避免将令牌保存在配置文件中。

Claude Code ──stdio──▶ insta-edits ──HTTP──▶ Edits for Mac (127.0.0.1:19501)
             ◀── tools/list_changed ──┘  checks the tool set after each call

**兼容：**终端中的 Claude Code，以及 Claude 桌面应用“Code”标签页中的 Claude Code。这是一个标准的 stdio MCP 服务，因此其他 MCP 客户端（Claude 桌面聊天、Cursor、Codex）也可以运行 insta-edits serve，不过我们只测试过 Claude Code。

你将获得什么

完整的编辑器。 Edits 在主页（32 个工具）和编辑器（274 个工具）之间切换时，Claude 会立即收到 notifications/tools/list_changed。没有桥接程序，就不会收到这条通知。
每个 Claude Code 版本都能接受的回复。 Edits 会将每个结果标记为 "resultType": "complete"，但不包含较新的 MCP 架构与之配套的缓存字段。有些 Claude Code 版本随后会丢弃所有工具，并显示 Invalid result for tools/list: ttlMs … cacheScope。只有缺少这些字段时，桥接程序才会移除该标记。
令牌始终保密。 插件将令牌保存在 macOS 钥匙串中。CLI 将令牌保存在权限为 0600 的文件中。令牌绝不会出现在 ~/.claude.json、日志或错误消息中。
启动顺序不限。 如果 Edits 尚未打开，桥接程序仍会连接并报告没有工具；等 Edits 响应后，它会立即通知 Claude，让编辑器无需重启就能显示。
可据以采取行动的错误提示。 “无法连接 Edits：请打开 Edits 并启用 Automation Server”取代了堆栈跟踪。令牌被拒绝时，提示会说明如何更新令牌。
doctor 会检查从应用到登录的每个环节，而 --json 会生成一份可附在错误报告中的报告。
一个 edits 技能，教 Claude 如何使用服务：先探索再猜测，使用标准化的画布坐标，检查渲染帧，并且未经你明确同意，绝不发布。
仅使用 Python 标准库。 插件无需通过 pip install 安装任何内容，并且会使用 macOS 自带的 python3 运行。

要求

一台搭载 Apple 芯片（M1 或更新型号）的 Mac，以及已登录 Instagram 的免费应用 Edits for Mac
Claude Code
python3 3.9 或更高版本。如果 macOS 提示安装命令行工具，请运行 xcode-select --install。

安装

开始之前： 打开 Edits for Mac 并登录，同时确保已安装 Claude Code。设置大约需要两分钟。

1. 在 Edits 中启用自动化服务

前往 Edits › Settings › Automation，开启 Enable Automation Server，并复制 Access token。Claude 工作期间请保持 Edits 开启。

2a. 作为 Claude Code 插件安装（推荐）

在终端中启动 claude，然后依次运行以下两条命令：

/plugin marketplace add faisalkhanzemi/insta-edits-for-claude

/plugin install insta-edits@insta-edits

Claude Code 会通过遮蔽输入的提示要求你提供访问令牌，并将其保存在钥匙串中。重启 Claude Code，然后运行 /mcp：edits 应显示为已连接。插件还会安装 edits 技能。

想直接让 Claude 操作？将下面这句话作为普通消息粘贴到 Claude Code 中：

从 github.com/faisalkhanzemi/insta-edits-for-claude 安装 Insta Edits 插件

Claude 会通过终端执行相同的两步安装流程。此方式无法显示遮蔽令牌的输入提示，因此请在完成安装后运行 /plugin configure insta-edits@insta-edits 并粘贴令牌，切勿将令牌发到聊天中。

通过 Shell 脚本安装，或使用 Claude 桌面应用

Shell 命令执行相同操作，但不会提示输入令牌，因此请在 Claude Code 中运行 /plugin configure insta-edits@insta-edits 设置令牌：

claude plugin marketplace add faisalkhanzemi/insta-edits-for-claude

claude plugin install insta-edits@insta-edits

以这种方式按用户范围安装的插件也会显示在 Claude 桌面应用的 Code 选项卡中，该应用读取相同的设置。

2b. 作为独立 MCP 服务安装

pipx install insta-edits

insta-edits set-token

claude mcp add --scope user edits -- insta-edits serve

set-token 会通过隐藏输入提示要求你提供令牌，并将其保存到权限为 0600 的 ~/.config/insta-edits/token 文件中。切勿将令牌本身放在 claude mcp add 命令中：这样会让令牌以明文形式出现在 ~/.claude.json 和 Shell 历史记录中。

检查连接

insta-edits doctor

insta-edits 0.1.1 doctor

  ✓ macOS                      27.0.1
  ✓ Edits app installed        /Applications/Edits.app
  ✓ Automation server          answering at http://127.0.0.1:19501/mcp (HTTP 403 without a token, as expected)
  ✓ Access token               from ~/.config/insta-edits/token
  ✓ Sign-in                    metapilot-native 1.0.0, protocol 2025-06-18
  ✓ Tools                      32 on the current screen (home screen; Edits offers more once a project is open)
  ✓ Reply format               normalised for older Claude Code builds (resultType without caching fields)
  ✓ Edits automation schema    2026.10.19-1
  ✓ Tool-change notifications  Edits announces them but never sends any; the bridge checks after each call and tells Claude

All good. Claude can drive Edits.

每条 ✗ 提示都说明了对应的修复方法。想使用 doctor 的插件用户可以按 2b 中的步骤安装 CLI。插件令牌保存在钥匙串中，因此如果没有使用 set-token，doctor 检查会停留在登录步骤。

更新或卸载

插件：

claude plugin marketplace update insta-edits && claude plugin update insta-edits@insta-edits

claude plugin uninstall insta-edits@insta-edits && claude plugin marketplace remove insta-edits

独立服务：运行 pipx upgrade insta-edits 进行更新；运行 claude mcp remove edits、pipx uninstall insta-edits 和 rm -r ~/.config/insta-edits 将其卸载。你也可以随时在 Edits 中关闭自动化服务，以断开连接。

使用方法

用自然语言描述你要进行的编辑：

打开我最新的 Edits 项目，告诉我时间线上有什么。

将 ~/Movies/broll/ 导入新项目，按旁白的节拍剪辑，并使用简洁的无衬线字体添加逐字字幕。

为每个产品特写添加轻柔的缩放效果，并在每个剪辑切换处添加呼啸音效，然后渲染预览，以便我检查画面。

Claude 会打开项目，显示编辑工具，并使用这些工具进行操作。它不会发布内容。发布操作会留在 Edits 窗口中，除非你明确要求 Claude 分享某个特定视频。

工作原理

步骤	工作内容
会话	桥接程序转发 `initialize`，保留 Edits 的 `Mcp-Session-Id`，并在每个请求中发送 `MCP-Protocol-Version`。
响应	它接受 JSON 和 `text/event-stream` 响应以及批量请求，并且只在缓存字段缺失时规范化 `resultType`。
工具同步	每次 `tools/call` 后，它都会向 Edits 发送自己的 `tools/list` 请求，使用一个 Claude 不会看到的 ID，并比较工具名称。如果名称发生变化，它会向 Claude 发送 `notifications/tools/list_changed`。使用 `serve --no-sync` 可关闭此功能。
通知	如果未来版本的 Edits 开放了服务器到客户端的数据流，桥接程序会监听并转发收到的内容。目前 Edits 尚未提供此类数据流，因此首次遭拒后，桥接程序就会停止尝试。使用 `serve --no-stream` 可关闭此功能。
Edits 已关闭	桥接程序会自行响应 `initialize`，报告没有可用工具，并每隔 5 秒重试连接 Edits（`INSTA_EDITS_OFFLINE_POLL`）。Edits 响应后，桥接程序会建立会话并发送 `notifications/tools/list_changed`。
错误	Edits 关闭时调用工具会返回 JSON-RPC 错误 `-32001`。Edits 返回 HTTP 错误时会返回 `-32002`。两种情况都会附带一行修复建议。

设置从环境变量读取：EDITS_MCP_URL（默认值为 http://127.0.0.1:19501/mcp）、EDITS_MCP_TOKEN 和 EDITS_MCP_TOKEN_FILE。日志会输出到 stderr。

测试环境

	版本
Edits for Mac	454.0.0（服务 `metapilot-native` 1.0.0，自动化架构 2026.10.19-1）
Claude Code	2.1.296
macOS	27.0.1
Python	3.9.6（系统版本），CI 中使用 3.11、3.13

Edits 经常更新，其自动化服务没有文档。如果新版本导致某项功能失效，请运行 insta-edits doctor --json，并附上输出提交问题。输出中不包含令牌。

故障排除

症状	解决方法
`Cannot reach Edits`	打开 Edits，并在“设置 › 自动化 › 启用自动化服务器”中开启自动化服务器。
HTTP 401 或 403	Edits 中的令牌已更改。在 `/plugin` 中更新令牌，或运行 `insta-edits set-token`。
打开项目后仍然只有主页工具	检查 `/mcp` 中的 `edits` 是否指向桥接服务，而不是直接指向 `127.0.0.1:19501`，并确认启动时没有使用 `--no-sync`。
导入失败，提示 `file not found: ~/…`	Edits 不会展开 `~`。请传入完整路径，例如 `/Users/you/Movies/clip.mp4`。
导入失败，提示 `Sandbox bookmark unavailable`	Edits 处于沙盒环境中。在我们的测试中，它可以从 `~/Movies` 导入，但无法从 `~/Downloads`、`~/Desktop`、临时文件夹和项目文件夹导入。请将素材移到 `~/Movies`，并从那里导入。
导出的视频在应该有歌曲的地方没有声音	Edits 音乐库中的歌曲会作为授权曲目添加，而通过自动化启动的导出会将其排除：所有测试中，音乐轨道都没有声音，而我们自己的音频文件则能正常导出。若需要使用音乐库中的歌曲，请从 Edits 窗口导出或发布。
`addSongToComposition` 添加了另一首歌	传入曲目 ID 有时会添加另一首曲目。在我们的测试中，传入准确的标题则添加了正确的歌曲。

安全

桥接服务只会连接到你配置的网址，默认值为 127.0.0.1。它不会向其他任何地方发送数据，也没有遥测功能。
所有日志行、错误消息和 repr 中的令牌都会被隐藏。doctor --json 会报告令牌的来源，但绝不会报告令牌值。
Edits 已登录你的 Instagram 账号。随附的技能会告诉 Claude，除非你针对某一条帖子明确授权，否则绝不发布、分享或安排发布。
如需私下报告漏洞，请参阅 SECURITY.md 中的说明。

常见问题

如何将 Claude 连接到 Instagram Edits？ 在 Mac 上安装 Edits，在“设置 › 自动化 › 启用自动化服务器”中开启自动化服务器，然后按照安装中的说明添加此插件，并运行两行 /plugin 命令。之后 Claude 就能打开并编辑你的项目。

Claude 能编辑 Instagram Reels 吗？ 可以，在 Mac 版 Edits 中可以。它能导入片段、按节拍剪辑、添加字幕、文字、转场、缩放和变速，检查渲染帧并导出。你需要自行从 Edits 发布 Reel。

它能在浏览器中的 claude.ai 上运行吗？ 不能。Edits 在你的 Mac 上运行，且只接受本地连接，因此需要在同一台 Mac 上运行 Claude Code（或其他 MCP 客户端）。

这是官方项目吗？ 不是。这是一个独立的开源项目，与 Meta、Instagram 或 Anthropic 无关，也未获其认可。“Instagram”和“Edits”是 Meta Platforms, Inc. 的商标。

它能在 Windows 上运行或配合 Edits 手机应用使用吗？ 不能。桌面版 Edits 仅适用于 macOS，自动化服务器也仅在 macOS 上提供。

如果我的 Claude Code 版本能处理 Edits 的回复，我还需要这个吗？ 需要，编辑器工具仍需要它。Edits 不会通知你工具已发生变化，而且客户端若不主动查询，就无法获知这些变化。

Claude 能替我发布到 Instagram 吗？ 桥接服务不会阻止 Claude 调用 Edits 的分享工具，但随附的技能会要求它等待你的明确授权。默认情况下，从 Edits 窗口发布更安全。

开发

git clone https://github.com/faisalkhanzemi/insta-edits-for-claude && cd insta-edits-for-claude
python3 -m venv .venv && . .venv/bin/activate
pip install -e . pytest ruff
pytest && ruff check . && ruff format --check .

测试使用 tests/fake_edits.py 运行，这是一个模拟真实服务的替身：它不会发送通知，会在打开项目时更改工具集，并会返回 resultType。运行测试不需要 Mac 或 Edits。请参阅 CONTRIBUTING.md。

致谢

演示素材：来自 Pexels 的库存片段（Pexels License）。音乐：“Tech House vibes”，作者 Alejandro Magaña，Mixkit（Mixkit License）。

License

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。