# 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:

```toml
[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.