bjd-cms-content/install/codex.md

Codex Adapter

Codex is an optional packaging target. The server itself has no Codex runtime dependency.

After installing the release, register the extracted server as a stdio MCP server in Codex's current MCP configuration and set BJD_CMS_SKILL_ROOT to the complete extracted skill directory. A typical TOML mapping is:

[mcp_servers.bjd-cms-content]
command = "python3"
args = ["/absolute/version/path/plugin/bjd-cms-content/scripts/server.py"]
cwd = "/absolute/version/path/plugin/bjd-cms-content"

[mcp_servers.bjd-cms-content.env]
BJD_CMS_SKILL_ROOT = "/absolute/version/path/skill/bjd-cms-content"

Install the complete skill folder through Codex's supported local-skill flow so Codex can read SKILL.md; do not copy only that file. The bundled .codex-plugin/plugin.json and .mcp.json are optional Codex metadata and do not replace the private CMS configuration described in generic-mcp.md.

Restart Codex or start a new thread after installation or upgrade, then run the credential-free native-smoke acceptance before any CMS call.