IMG.LY CE.SDK 官方 Codex 用 -a codex,文档 MCP 无鉴权
官方 Codex:npx skills add imgly/agent-skills -a codex。实时文档才 mcp add imgly_docs --url https://mcp.img.ly/mcp,无 API key。不要抄 Claude 的 cesdk@imgly,也不要和 @imgly/codesign-mcp 搞混。
IMG.LY 给 Codex 有专节。CE.SDK 的官方主路径是 Agent Skills,不是 Codex /plugins。仓库 README 默认是 Claude(-a claude-code 和 claude plugin install cesdk@imgly),不要抄过来。只要 Codex 时钉死:
npx skills add imgly/agent-skills -a codex
-a codex 就是 --agent codex,不要省略。不带这个旗标会按默认 agent 落盘(常常是 Claude)。它把技能装进项目旁的 .agents/skills/,离线带 10 个 Web 框架的文档和 starter kit。加 -g 才装到本机全局。用 npx skills add imgly/agent-skills --list 核对。技能不出现就再跑一遍安装,然后新开一轮。不要手拷到 ~/.codex/skills。
Codex 里用 $build、$explain、$docs-react 这种 $name 显式调用。不要抄 Claude 插件的 /cesdk:docs-react。不要发明 codex plugin add cesdk@imgly 或 imgly@openai-curated。
实时文档是另一台远程 MCP,无鉴权、无 API key。官方 Codex 对照:
codex mcp add imgly_docs --url https://mcp.img.ly/mcp
[mcp_servers.imgly_docs]
url = "https://mcp.img.ly/mcp"
enabled = true
URL 带 /mcp 后缀。用户层表名官方就是 imgly_docs。这台没有 OAuth,不要 codex mcp login。不要抄 Claude 的 --transport http,也不要抄 Cursor / VS Code 的 type: http JSON。不要抄 npx mcp-remote。不要给它配 bearer_token_env_var。
官方建议技能和 MCP 一起用:技能负责离线脚手架,MCP 查最新文档。不要和 codex mcp add codesign -- npx -y @imgly/codesign-mcp@latest stdio 那台 CoDesign 本地 MCP 配成一张表。不要给它 required = true 挂全局。不要一上来 --yolo。网页 Cloud 不读 ~/.codex/config.toml。改完用 codex mcp get imgly_docs 看传输是 streamable_http。脚手架项目需要本机 Node.js 20 及以上。
不要做这些:
- 不要抄
claude plugin marketplace add imgly/agent-skills/claude plugin install cesdk@imgly。 - 不要抄
npx skills add imgly/agent-skills -a claude-code。 - 不要发明
codex plugin add cesdk@imgly。 - 不要把 CoDesign 的
@imgly/codesign-mcp当成 CE.SDK 文档 MCP。