Codex 插件与 MCP 完整参考手册

插件 vs MCP 对比

一、官方插件（openai-primary-runtime）

这些是 Codex 内置的核心能力插件，随 Codex 安装自动可用。

documents@openai-primary-runtime

• 功能
  ：处理 Word/Google Docs 等文档文件
• 工具
  ：读取、编辑、生成 .docx 格式文件
• 状态
  ：默认已启用

spreadsheets@openai-primary-runtime

• 功能
  ：处理 Excel/CSV 等电子表格
• 工具
  ：读写单元格、公式计算、数据分析
• 状态
  ：默认已启用

presentations@openai-primary-runtime

• 功能
  ：处理 PowerPoint/Keynote 等演示文稿
• 工具
  ：创建幻灯片、修改内容、导出
• 状态
  ：默认已启用

pdf@openai-primary-runtime

• 功能
  ：读取和解析 PDF 文件内容
• 工具
  ：提取文本、分析结构
• 状态
  ：默认已启用

template-creator@openai-primary-runtime

• 功能
  ：创建文档/表格/演示模板
• 状态
  ：默认已启用

二、内置插件（openai-bundled）

随 Codex 应用程序打包，提供系统级能力。

browser@openai-bundled

• 功能
  ：控制 Codex 内置浏览器（IAB 浏览器）
• 工具
  ：navigate / screenshot / click / type / scroll
• 使用场景
  ：在 Codex 应用内打开网页、自动填表、抓取内容
• 状态
  ：默认已启用

chrome@openai-bundled

• 功能
  ：通过 Chrome DevTools Protocol 控制系统 Chrome 浏览器
• 工具
  ：与 browser 类似，但控制的是外部 Chrome 实例
• 使用场景
  ：操作已登录的 Chrome 会话；访问内部系统
• 注意
  ：优先级高于 computer-use，Codex 会优先使用此插件控制 Chrome
• 状态
  ：默认已启用

computer-use@openai-bundled

• 功能
  ：屏幕截图 + 鼠标键盘模拟（完整电脑控制）
• 工具
  ：screenshot / click / type / key / scroll
• 使用场景
  ：无法通过 API 控制的桌面应用；复杂 GUI 操作
• 注意
  ：这是最强但也最慢的控制方式，优先使用 chrome/browser 插件
• 状态
  ：默认已启用

record-and-replay@openai-bundled

• 功能
  ：录制用户操作并重放（宏录制）
• 状态
  ：未安装（可选）
• 安装
  ：codex plugin add record-and-replay@openai-bundled

latex@openai-bundled

• 功能
  ：编译和渲染 LaTeX 文档
• 状态
  ：未安装（可选）
• 安装
  ：codex plugin add latex@openai-bundled

三、精选第三方插件（openai-curated）

OpenAI 精选的第三方集成，需手动安装。

figma@openai-curated ⭐

• 功能
  ：读取 Figma 设计文件，获取组件、样式、布局信息
• 工具
  ：get_figma_data / download_figma_images
• 使用场景
  ：设计稿转代码；让 Codex 看懂 Figma 后直接写 CSS/组件
• 安装
  ：codex plugin add figma@openai-curated
• 认证
  ：安装后需 codex mcp login figma 完成 OAuth
• 当前状态
  ：已安装但未登录

github@openai-curated ⭐

• 功能
  ：操作 GitHub 仓库、PR、Issues、代码搜索
• 工具
  ：search_code / create_issue / create_pull_request / list_commits
• 使用场景
  ：跨仓库搜索代码；自动创建 PR；读取 Issue 内容后修复
• 安装
  ：codex plugin add github@openai-curated
• 认证
  ：需要 GitHub Personal Access Token（GITHUB_PAT_TOKEN）
• 当前状态
  ：已安装，Bearer token 认证

notion@openai-curated ⭐

• 功能
  ：读写 Notion 页面、数据库
• 工具
  ：notion-search / notion-create-pages / notion-query-database
• 使用场景
  ：读取 Notion 需求文档后写代码；把任务结果写回 Notion
• 安装
  ：codex plugin add notion@openai-curated
• 认证
  ：需 codex mcp login notion 完成 OAuth
• 当前状态
  ：已安装但未登录

canva@openai-curated

• 功能
  ：在 Canva 中创建/编辑设计
• 使用场景
  ：生成社媒图片；批量制作海报
• 安装
  ：codex plugin add canva@openai-curated
• 当前状态
  ：已安装

slack@openai-curated

• 功能
  ：发送/读取 Slack 消息
• 工具
  ：post_message / list_channels / search_messages
• 安装
  ：codex plugin add slack@openai-curated

linear@openai-curated

• 功能
  ：管理 Linear Issues、Projects
• 工具
  ：create_issue / list_issues / update_issue
• 安装
  ：codex plugin add linear@openai-curated

gmail@openai-curated

• 功能
  ：读取/发送 Gmail 邮件
• 安装
  ：codex plugin add gmail@openai-curated

google-calendar@openai-curated

• 功能
  ：读取/创建 Google 日历事件
• 安装
  ：codex plugin add google-calendar@openai-curated

atlassian-rovo@openai-curated

• 功能
  ：集成 Atlassian（Jira/Confluence）
• 安装
  ：codex plugin add atlassian-rovo@openai-curated

teams@openai-curated

• 功能
  ：Microsoft Teams 消息集成
• 安装
  ：codex plugin add teams@openai-curated

outlook-email@openai-curated / outlook-calendar@openai-curated

• 功能
  ：Outlook 邮件/日历
• 安装
  ：codex plugin add outlook-email@openai-curated

sharepoint@openai-curated

• 功能
  ：SharePoint 文件和协作
• 安装
  ：codex plugin add sharepoint@openai-curated

netlify@openai-curated

• 功能
  ：部署到 Netlify、管理站点
• 安装
  ：codex plugin add netlify@openai-curated

vercel@openai-curated

• 功能
  ：部署到 Vercel、管理 deployments
• 安装
  ：codex plugin add vercel@openai-curated

stripe@openai-curated

• 功能
  ：查询 Stripe 支付数据
• 安装
  ：codex plugin add stripe@openai-curated

hugging-face@openai-curated

• 功能
  ：调用 Hugging Face 模型和数据集
• 安装
  ：codex plugin add hugging-face@openai-curated

codex-security@openai-curated

• 功能
  ：安全扫描工具，检测代码漏洞
• 状态
  ：默认已启用

mem@openai-curated

• 功能
  ：跨会话持久记忆（知识库）
• 状态
  ：已启用

superpowers@openai-curated

• 功能
  ：技能/工作流增强系统
• 状态
  ：已启用

四、MCP Servers（通用协议）

与 Claude Code 共用 MCP 协议，配置在 ~/.codex/config.toml 的 [mcp_servers] 段，或通过 codex mcp add 命令添加。

当前已配置的 MCP Servers

cloudbase（腾讯云 CloudBase）

[mcp_servers.cloudbase]type = ”stdio”command = ”cloudbase-mcp”[mcp_servers.cloudbase.env]INTEGRATION_IDE = ”CodeX”

node_repl（内置 Node.js REPL）

• Codex 内置，提供 JavaScript 执行环境
• 与浏览器/Chrome 插件联动

figma（HTTP 远程 MCP）

# 通过 codex mcp add 添加# URL: https://mcp.figma.com/mcp

github（HTTP 远程 MCP）

# Bearer token 认证# URL: https://api.githubcopilot.com/mcp/

notion（HTTP 远程 MCP）

# URL: https://mcp.notion.com/mcp# OAuth 认证（需要登录）

添加自定义 MCP Server

# stdio 类型（本地进程）codex mcp add postgres \ --command ”npx” \ --args ”-y,@modelcontextprotocol/server-postgres,postgresql://user:pass@localhost/db”# HTTP 类型（远程服务）codex mcp add my-api \ --url ”https://my-company.com/mcp” \ --header ”Authorization: Bearer token123”

或直接编辑 ~/.codex/config.toml：

[mcp_servers.my-postgres]type = ”stdio”command = ”npx”args = [”-y”, ”@modelcontextprotocol/server-postgres”, ”postgresql://...”][mcp_servers.my-remote]type = ”http”url = ”https://my-company.com/mcp/sse”[mcp_servers.my-remote.headers]Authorization = ”Bearer your-token”

五、Codex 独有能力（Claude Code 没有的）

1 Computer Use（电脑控制）

Codex 可以直接控制整个 macOS 桌面，这是 Claude Code 没有的能力。

codex ”帮我把 Finder 里的文件整理到对应文件夹”codex ”打开 Xcode，编译当前项目，把报错截图给我看”codex ”在 Safari 里填写这个表单并提交”

底层实现：

• 轻量操作 → chrome@openai-bundled 或 browser@openai-bundled
• 复杂 GUI → computer-use@openai-bundled（屏幕截图+鼠标键盘）

2 图像生成（image_gen 工具）

Codex 内置图像生成工具（DALL-E 3 / GPT-Image），Claude Code 需要通过 MCP 或外部工具实现。

printf '生成一张 1024x1536 的赛博朋克海报，保存到 /tmp/poster.png' | \ codex exec --sandbox workspace-write -c approval_policy=never

结构化输出（--output-schema）

# 强制 Codex 输出符合 JSON Schema 的结构化数据codex exec \ --output-schema schema.json \ ”分析 src/ 目录下所有 TypeScript 文件，列出所有导出的函数名和参数”

多配置文件（-p / --profile）

# 不同任务用不同配置codex exec -p production ”在生产数据库配置下检查 schema”codex exec -p testing ”在测试环境配置下运行”

配置文件：~/.codex/production.config.toml、~/.codex/testing.config.toml

与 Claude Code MCP 生态对照

快速速查

# 插件管理codex plugin list# 查看所有插件codex plugin add figma@openai-curated# 安装 Figmacodex plugin add github@openai-curated# 安装 GitHubcodex plugin add notion@openai-curated# 安装 Notioncodex plugin add slack@openai-curated# 安装 Slackcodex plugin add computer-use@openai-bundled# 安装电脑控制codex plugin remove figma@openai-curated# 卸载# MCP 管理codex mcp list# 查看已配置 MCPcodex mcp add name --command ”cmd” --args# 添加 stdio MCPcodex mcp add name --url ”https://...”# 添加 HTTP MCPcodex mcp login figma# OAuth 登录codex mcp remove name# 移除# 当前已安装插件（本机）figma, github, notion, canva,# 精选第三方browser, chrome, computer-use,# 内置系统控制documents, pdf, spreadsheets, presentations# 文档处理