Codex integration guide
Install the Codex plugin
Install Service Architect from its public repository marketplace and open a new Codex task so the MCP server and skills are discovered.
When to use
Install once per Codex environment, then update the marketplace installation when a newer plugin version is published.
Behavior
- The repository marketplace is declared in
.agents/plugins/marketplace.json. - The plugin manifest is
plugins/service-architect/.codex-plugin/plugin.json; the MCP process is configured byplugins/service-architect/.mcp.json. - Codex loads the packaged skills and starts the Python MCP server through the package revision pinned by the plugin.
- Open a new task after installation or update so tool discovery starts with the new plugin definition.
Installation sources properties
Files used by Codex plugin discovery.
PropertyTypeDescription
Repository marketplace
git clone https://github.com/gorundebug/sa-python-dsl.git
cd sa-python-dsl
# Add this repository marketplace in Codex, install Service Architect,
# then open a new task in the Python topology project.