Admin 导入带 MCP 的插件只在桌面能用
工作区从 GitHub 导入的插件,只要声明了 mcp.json、.mcp.json 或内联 MCP,就会标成 Desktop only。CLI 和 IDE 装不上,远程 HTTPS 也不例外。
工作区管理员走 Admin > Plugins > Import marketplace 时,源填仓库 URL(不要带分支或文件夹),Path 填含 marketplace.json 的目录,不要填文件名。导入成功后,只要在 mcp.json、.mcp.json 或内联字段里声明了 MCP,该插件就会标成 Desktop only:只在 ChatGPT 桌面里能用,Codex CLI 和 IDE 扩展都跑不了。远程 HTTPS MCP 也一样,不是「只有本地 stdio 才被挡」。
这和本机 codex plugin marketplace add 不是一条路。本地 / 仓库 marketplace 装上的带 MCP 插件,CLI 仍按 [plugins."name@marketplace".mcp_servers.server] 管开关和审批。Admin 导入的副本走工作区策略,不读项目 .codex/config.toml 里的 enabled,也进不了 CLI 的插件目录。
需要 CLI 用同一份技能+MCP 时:
codex plugin marketplace add owner/repo --ref main --sparse .agents/plugins --json
codex plugin add my-plugin@team-plugins
codex plugin list --json
不要指望把 Admin 插件再写进项目 [plugins."name@marketplace"] enabled = true 来解锁 CLI。那套键只对本地 marketplace 插件有效。
把已有工作区插件交给这份 GitHub 源管,在 marketplace 条目里加 pluginId(从该插件 Admin URL 里 /admin/plugins/ 后面那段抄)。它必须和 name、source 并列,且插件已在同一工作区:
{
"name": "team-tools",
"pluginId": "plugin_00000000000000000000000000000000",
"source": {
"source": "local",
"path": "./plugins/team-tools"
}
}
接管后更新来自 GitHub,不能再用上传包覆盖;已被别的 GitHub 源管的插件不能再抢。
删掉 marketplace 条目不会删除已导入的工作区副本,只会标成 No longer in source。删整个 marketplace 才会清掉它导入的插件。重连 GitHub 不要先删 marketplace。