Windows 本地配置记录：Codex 重启后识别 Affinity MCP

说明：本文是一篇本地开发环境配置记录，用于复盘 Codex 如何读取 Affinity MCP 配置，以及为什么新增 MCP 后通常需要重启 Codex 才能在插件列表中看到。本文不涉及商业推广，不提供破解、绕过授权或修改官方程序的做法。

Windows 本地配置记录：把 Affinity by Canva 的 MCP 连接到 Codex

绕过 Claude Desktop！Affinity MCP 直连 WorkBuddy/Cursor 完整配置指南（Windows）

1. 这篇记录解决什么问题

在配置 Affinity MCP 时，容易遇到一个现象：

配置文件已经写了 命令行也能看到 MCP server 但当前 Codex 界面里暂时看不到 Affinity

这并不一定是配置失败。

原因通常是：

当前正在运行的 Codex 会话没有热加载新增 MCP

解决方式是：

保存配置 重启 Codex 重新打开插件 / MCP 管理页 确认 Affinity 是否出现

本文记录一次 Windows 本地环境中的完整验证过程。

2. 本地环境

本文使用的环境如下：

系统：Windows Codex：本地桌面环境 Affinity：已开启内置 MCP Claude Desktop：已安装 Affinity Connector Node.js：本机可用

其中 Affinity Connector 位于类似路径：

C:\Users\<你的用户名>\AppData\Roaming\Claude\Claude Extensions\ant.dir.gh.canva.affinity

这个目录中的关键文件是：

server/index.js manifest.json package.json README.md

实际连接链路可以理解为：

Codex -> node server/index.js -> http://localhost:6767/sse -> Affinity 桌面应用

3. 先确认 Affinity 侧已经开启 MCP

在 Affinity 中进入：

Edit -> Settings -> Model Context Protocol

确认下面几类开关已经开启：

Enable Affinity MCP Access desktop files Access network Use saved scripts Save scripts to Scripts panel

不同版本的界面文案可能略有差异，以本机显示为准。

修改 Affinity MCP 设置后，建议退出并重新打开 Affinity。

4. 给 Codex 写入 MCP 配置

Codex 的全局配置文件通常在：

C:\Users\<你的用户名>\.codex\config.toml

可以在文件末尾加入：

[mcp_servers.affinity] command = "node" args = ["C:/Users/<你的用户名>/AppData/Roaming/Claude/Claude Extensions/ant.dir.gh.canva.affinity/server/index.js"] startup_timeout_sec = 30 tool_timeout_sec = 120 [mcp_servers.affinity.env] SSE_URL = "http://localhost:6767/sse"

注意几点：

1. <你的用户名> 要替换成自己的 Windows 用户名 2. 路径里可以用正斜杠 / 3. SSE_URL 建议先用 http://localhost:6767/sse 4. 新增配置前最好备份 config.toml

备份示例：

Copy-Item ` -LiteralPath "$env:USERPROFILE\.codex\config.toml" ` -Destination "$env:USERPROFILE\.codex\config.toml.bak-affinity" ` -Force

5. 用命令行先检查 Codex 是否读到了配置

如果codex命令在当前终端中可用，可以执行：

codex mcp list

有些 Windows 环境中，系统可能优先调用 WindowsApps 里的codex.exe，导致出现权限问题。

这时可以使用 Codex 安装目录下的真实 CLI 路径，例如：

& "C:\Users\<你的用户名>\AppData\Local\OpenAI\Codex\bin\<版本目录>\codex.exe" mcp list

成功时，输出中应该能看到类似内容：

Name Command Args Status affinity node ...ant.dir.gh.canva.affinity/server/index.js enabled

这里能看到affinity，说明 Codex 配置文件已经被 CLI 读取。

但这一步只能说明：

配置已被 Codex CLI 识别

它不等于当前已经打开的 Codex 界面完成了热加载。

6. 为什么还需要重启 Codex

新增 MCP server 后，当前正在运行的 Codex 会话不一定会自动加载新 server。

表现可能是：

config.toml 已经写入 codex mcp list 已经看到 affinity 但插件 / MCP 列表里暂时没有 Affinity

这时不要急着反复改配置。

更稳的做法是：

1. 保存 config.toml 2. 关闭当前 Codex 窗口 3. 重新打开 Codex 4. 进入插件 / MCP 管理页 5. 查看 MCP 分组

7. 重启后的验证结果

重启 Codex 后，在插件管理页中可以看到 MCP 列表里出现：

Affinity Node Repl Pycharm

示例截图如下：

这说明：

Codex 已经识别 Affinity MCP server Affinity MCP 已经进入 Codex 插件 / MCP 管理界面

如果开关处于启用状态，就可以继续做后续工具测试。

8. 后续建议先做只读测试

第一次看到 Affinity MCP 后，不建议马上执行会修改文档的脚本。

建议先做只读测试：

list_sdk_documentation read_sdk_documentation_topic list_library_scripts render_spread render_selection

如果需要执行脚本，应先阅读 Affinity SDK 的preamble文档。

原因是 Affinity MCP 的execute_script能在桌面应用中执行 JavaScript，能力比较强，应该先确认当前文档、文件路径和操作范围。

9. 常见问题

9.1 配置写了，为什么界面里还是没有 Affinity

先执行：

codex mcp list

如果命令行能看到affinity，但界面没有，优先重启 Codex。

如果命令行也看不到，检查：

config.toml 是否写错位置 TOML 表名是否是 [mcp_servers.affinity] server/index.js 路径是否真实存在 Node.js 是否可用

9.2 浏览器打开 localhost:6767/sse 没有正常页面

这是正常现象。

http://localhost:6767/sse不是普通网页，而是 MCP/SSE 通信用的 endpoint。判断是否成功，不应该只看浏览器页面，而应该看 MCP client 是否能列出工具。

9.3 为什么不用 npx 安装某个 Affinity MCP 包

本文记录的是复用 Claude Desktop 已安装的 Affinity Connector。

不要直接照抄未经验证的包名，例如：

@affinity/mcp-server

应该先确认本机实际安装目录和manifest.json中声明的启动方式。

9.4 是否需要修改 Claude Desktop 的 connector 文件

不建议。

更稳妥的方式是：

读取 connector 的启动方式 在 Codex 中复用同一个 server/index.js 不要修改 connector 安装文件

这样后续排错更清晰，也不容易受到更新影响。

10. 最小排查清单

可以按下面顺序检查：

1. Affinity 是否已启动 2. Affinity 设置中 MCP 是否开启 3. Claude Desktop 是否已安装 Affinity Connector 4. server/index.js 路径是否存在 5. Codex config.toml 是否写入 affinity 6. codex mcp list 是否能看到 affinity 7. 是否已重启 Codex 8. 插件 / MCP 管理页是否出现 Affinity

如果第 6 步成功，第 8 步失败，大概率是还没有重启或刷新 Codex。

11. 小结

这次配置的关键点不是 TOML 写法本身，而是理解两个阶段：

阶段一：Codex CLI 读取 config.toml 阶段二：Codex 桌面界面重启后加载 MCP server

所以验证时建议分两步：

先用 codex mcp list 验证配置 再重启 Codex 验证界面可见

看到插件 / MCP 管理页中出现Affinity后，才算完成了从配置到界面的闭环。

参考链接

• Affinity 官方帮助：AI Automation with Claudehttps://www.affinity.studio/help/ai-connector-setup/

• Model Context Protocol 官方文档https://modelcontextprotocol.io/