---
title: "Admin 导入带 MCP 的插件只在桌面能用"
summary: "工作区从 GitHub 导入的插件，只要声明了 mcp.json、.mcp.json 或内联 MCP，就会标成 Desktop only。CLI 和 IDE 装不上，远程 HTTPS 也不例外。"
category: skills
level: intermediate
surfaces: [app, cli]
tags: ["plugins", "企业", "MCP"]
canonical: /tips/plugin-admin-mcp-desktop/
---

# 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 时：

```bash
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` 并列，且插件已在同一工作区：

```json
{
  "name": "team-tools",
  "pluginId": "plugin_00000000000000000000000000000000",
  "source": {
    "source": "local",
    "path": "./plugins/team-tools"
  }
}
```

接管后更新来自 GitHub，不能再用上传包覆盖；已被别的 GitHub 源管的插件不能再抢。

删掉 marketplace 条目不会删除已导入的工作区副本，只会标成 No longer in source。删整个 marketplace 才会清掉它导入的插件。重连 GitHub 不要先删 marketplace。

## 来源

- [OpenAI · Plugin management](https://learn.chatgpt.com/docs/enterprise/plugin-management)