Codex MCP插件接入Figma失败及修复
速览
用户尝试在Codex中使用Figma MCP时遇到invalid_redirect_uri错误,且Codex Desktop的第三方API接入后无法使用。通过研究,用户发现只需从Claude Code本地获取Figma accessToken并手动配置到Codex的mcp_servers中即可正常使用。此外,运行npx -y @openai/[email protected] mcp login figma也能解决授权问题。最新版Codex CLI已直接支持figma MCP授权。
AI 深度解读
背景
OpenAI Codex 作为一款面向开发者的 AI 编程助手,支持通过 MCP(Model Context Protocol)集成外部工具,扩展其能力边界。Figma MCP 是 Figma 官方提供的 MCP 服务器,允许 AI 客户端直接读取和操作 Figma 设计文件,实现设计稿转代码、组件提取等自动化工作流。然而,当用户尝试在 Codex Desktop 中通过第三方 API 接入(非官方登录)来使用 Figma MCP 时,遇到了 OAuth 授权流程失败、插件无法生效等问题。这一痛点影响了众多期望将 Codex 与 Figma 深度整合的开发者。
核心内容
原始帖子记录了用户从遇到问题到最终解决的全过程,主要包含三个阶段:
1. 初始尝试与失败
用户首先在 Codex CLI 中执行 codex mcp add figma --url https://mcp.figma.com/mcp 命令添加 Figma MCP,系统提示已添加全局 MCP 服务器,并检测到 OAuth 支持。但启动 OAuth 流程时返回错误:
Registration failed: Dynamic registration failed: Registration failed: HTTP 400 Bad Request: {"error":"invalid_redirect_uri"}
随后用户尝试在 Codex Desktop 中通过插件方式使用,发现只有通过官方登录授权后才能工作,切换到 API 接入后立即失效。社区中提到的 “Codex++” 解锁方案也未能解决实际问题。
2. 自行探索的解决方案(2026-05-31 13:27:12 更新)
用户研究了远程 MCP 服务端配置,发现 Figma MCP 的 token 信息通常存储在 ChatGPT 后台(Codex 深度集成于 ChatGPT),本地无法直接获取。但 Claude Code 工具会在本地 ~/.claude/.credentials.json 文件中保存 Figma 授权后的 accessToken。用户通过该文件提取 token,然后在 Codex 配置文件中添加以下内容以实现手动绑定:
[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
http_headers = { Authorization = "Bearer accessToken" }
完成后,Codex 可以直接调用 Figma MCP,资源下载等功能均正常工作。
3. 社区反馈和官方修复(2026-05-31 14:02:28 更新 & 2026-06-08 23:00:12 更新)
后续社区指出该问题为已知 bug,可通过运行特定命令绕过 OAuth 注册问题:
npx -y @openai/[email protected] mcp login figma
该命令直接触发 Figma 的 OAuth 授权流程,成功完成认证。而在 6 月 8 日的更新中,最新版 Codex CLI 已经修复了该 bug,用户可以直接使用 codex mcp add figma --url https://mcp.figma.com/mcp 进行正常的授权登录,无需手动配置 token 或使用旧版本变通。
关键要点
- 问题根源:Codex 在通过第三方 API 接入(非官方账号登录)时,OAuth 动态客户端注册的 redirect_uri 校验失败,导致无法完成授权。
- 临时手动方案:从其他已授权客户端(如 Claude Code)的本地凭据文件中提取 Figma 的 accessToken,手动写入 Codex 的 MCP 配置(添加
http_headers)。 - 官方临时 workaround:使用旧版 CLI 命令
npx -y @openai/[email protected] mcp login figma可绕过 bug 完成授权。 - 最终修复:最新版 Codex CLI(2026 年 6 月 8 日之后版本)已解决该问题,正常命令即可工作。
- Token 存储差异:Figma MCP 的 token 在 ChatGPT/Codex 后台存储(无法直接读取),而在 Claude Code 中则明文存储于本地 JSON 文件。
- 社区协作价值:LINUX DO 社区的多轮更新体现了用户互助与官方 bug 修复的并行推进。
意义与影响
- 对 MCP 生态的启示:MCP 的 OAuth 动态注册机制在不同客户端间存在兼容性问题。Codex 与 Figma 的整合案例揭示了规范化和一性认证流程的重要性,未来 MCP 服务端和客户端应加强对 redirect_uri 的校验透明度和错误提示。
- 对开发者工具链的实用性:文中提供的手动 token 提取和配置方法,为在官方修复前有迫切需求的用户提供了可落地的临时方案,同时也展示了本地凭据文件的安全风险——建议 Claude Code 等工具对 token 进行加密存储。
- 对 AI 编码助手整合能力的参考:Codex 通过 MCP 接入 Figma 是 AI 驱动设计到代码工作流的关键一环。该案例表明,即使出现 OAuth 短板,只要理解底层原理,开发者仍能通过逆向和配置文件绕过限制,体现了开放平台的灵活性。
- 社区与官方协同的正面案例:从用户发现问题、社区分享 workaround,到数周内官方修复,展现了开源社区反馈驱动产品迭代的良性循环。这也鼓励其他用户在遇到类似边缘问题时勇于探索并分享经验。
