簡短回答
- 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 給的連結購買 Skill 或訂閱，然後再問一次。在你動手前不會扣任何費用。 |
移除或中斷連線
- 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，或手動執行一次啟動指令；之後就是秒開。
參考來源
這篇指南對你有幫助嗎？
