先说结论
- 1跑一次
codex mcp add skillry -- npx --yes skillry-cli@latest mcp；Windows 上把启动命令包进cmd /c。 - 2用
codex mcp list确认，或者在 Codex TUI 里输入/mcp。 - 3ChatGPT 桌面 App 和 IDE 扩展共用这条配置：设置一次，三处都能用。
开始之前
以上步骤于 2026 年 10 月 28 日按官方文档核对，尚未在这个客户端的真实安装上实测。要是你机器上有哪一步不一样，用页尾的 反馈问题 告诉我们。
- Codex 已登录：CLI、带 Codex 的 ChatGPT 桌面 App，或者 IDE 扩展。三者共用一份配置。
- Node.js 22 或更新（
node --version）。Codex 用npx启动服务。 - 项目级的
.codex/config.toml也行，但只在你标记为信任的项目里生效。本指南用全局文件。
把 Skillry 加进 Codex
- 1
在任意终端运行：
macOS codex mcp add skillry -- npx --yes skillry-cli@latest mcp正常的话你会看到： 没有报错，
codex mcp list里多了skillry。 - 2
Windows 上改跑这条，让 Windows 能启动
npx：Windows（PowerShell 或命令提示符） codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp - 3
重新启动 Codex；App 或扩展开着的话也重启一下。
正常的话你会看到： Codex 里
/mcp列表中有skillry。
- 1
ChatGPT 桌面 App：打开 Settings，选 MCP servers。IDE 扩展：打开齿轮菜单，选 MCP servers。
- 2
点 Add server。名称填
skillry，类型选 STDIO，命令填npx --yes skillry-cli@latest mcp（Windows 填cmd /c npx --yes skillry-cli@latest mcp）。 - 3
保存，然后在 App 里点 Restart，在 IDE 里点 Restart extension。
正常的话你会看到： MCP 服务器列表里
skillry显示为已启用。
- 1
用编辑器打开
~/.codex/config.toml；没有就新建。 - 2
追加这个表。已经有
[mcp_servers.skillry]的话，替换掉它。macOS [mcp_servers.skillry] command = "npx" args = ["--yes","skillry-cli@latest","mcp"] - 3
Windows 上改用这个表。
Windows [mcp_servers.skillry] command = "cmd" args = ["/c","npx","--yes","skillry-cli@latest","mcp"] - 4
第一次启动超时的话，在表下面加一行
startup_timeout_sec = 60。默认是 10 秒，而第一次npx运行要下载包。 - 5
保存，重新启动 Codex。
正常的话你会看到：
codex mcp list和/mcp里都有skillry。
确认 Codex 已连接
- 1
在终端列出已配置的服务器：
终端 codex mcp list正常的话你会看到：
skillry和你填的那条npx命令。 - 2
在 Codex TUI 里输入
/mcp。正常的话你会看到： 活动服务器里有
skillry，带着它的工具。
试一次搜索
搜索不需要账户，所以这是验证连接最快的办法。
- 1
在 Codex 里开一个新对话，把这段话粘进去。
发给 Agent 的提示词 Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.正常的话你会看到： 三个候选 Skill，每个都带预览链接、需要的输入、依赖和外部费用。什么都没有被安装。
- 2
Agent 要是回答它没有 Skillry 工具，或者请求一直卡着，去看不好使怎么办。
Codex 看不到 Skillry 怎么办
| 你看到的现象 | 可能的原因 | 怎么办 |
|---|---|---|
codex mcp list 里没有 skillry | 表写进了未信任项目的项目级文件，或者表名有错字 | 把表放进 ~/.codex/config.toml，确认写的正是 [mcp_servers.skillry]。 |
| 服务器一直没就绪，或者 Codex 报启动超时 | 第一次 npx 下载超过了 startup_timeout_sec（默认 10 秒） | 在表里加 startup_timeout_sec = 60，或者手动跑一次启动命令把包缓存下来。 |
| CLI 里能用，ChatGPT App 里不行 | 改文件时 App 一直开着 | 退出并重开 ChatGPT 桌面 App，或者在 IDE 里点 Restart extension。 |
| 服务器列出来了，但显示失败，或者一直起不来 | 没装 npx、Node.js 低于 22，或者第一次启动下载包时超时了 | 在终端跑 node --version 和 npx --version。然后手动跑一次 npx --yes skillry-cli@latest mcp，等它启动后按 Ctrl+C，再回客户端试：包已经缓存好了。 |
| Windows 上服务器一启动就退出 | 配置直接启动了 npx，而 Windows 需要通过 shell 才能跑它 | 用本页的 Windows 版配置：命令是 cmd，参数以 /c、npx 开头。 |
| 浏览器页面说请求无效或已过期 | 设备码批准得太晚，或者是上一次尝试留下的 | 让 Agent 重新连接，几分钟内批准新的设备码。 |
| 安装时提示需要 Premium 或购买 | 这个 Skill 是 Premium，你的账户既没有套餐也没买过它 | 顺着 Agent 给的链接单买或订阅，再让它装一次。你不点，就不会扣费。 |
移除或断开
- 1
从
~/.codex/config.toml删掉[mcp_servers.skillry]这个表，或者用codex mcp --help列出的、你这个版本的移除命令。想关掉但不删，在表里加enabled = false。 - 2
重启 Codex、App 或扩展。
正常的话你会看到：
codex mcp list里没有skillry了。
删掉配置并不会让你退出 Skillry。想把已存的授权也撤掉，先让 Agent 断开你的 Skillry 账户，或者删掉配置后等授权 7 天自动过期。
参考
| 项目 | macOS | Windows |
|---|---|---|
| 全局配置文件 | ~/.codex/config.toml | %USERPROFILE%\.codex\config.toml |
| 项目配置文件 | .codex/config.toml（仅信任的项目） | 相同 |
| 启动命令 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 检查 | codex mcp list 或 /mcp | 相同 |
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]超时、工具白名单和审批模式，见 Codex MCP 官方文档。
常见问题
ChatGPT 桌面 App 要单独设置吗？
不用。App、CLI 和 IDE 扩展读的是同一个 config.toml。改完重启 App 就行。
能只在一个项目里用吗？
能。在信任的项目里，把表写进那个项目的 .codex/config.toml，不写全局文件。
为什么第一次启动这么慢？
第一次 npx 运行要下载 skillry-cli。调高 startup_timeout_sec，或者手动跑一次启动命令；之后就是秒开。
参考来源
这篇对你有帮助吗？
