Merge pull request #7597 from danlister/master

Add OpenAI Codex setup documentation to MCP reference

Author: eshanrnh

16/umbraco-cms/SUMMARY.md

@@ -371,6 +371,7 @@
     * [Claude Code](reference/developer-mcp/host-setup/claude-code.md)
     * [Cursor](reference/developer-mcp/host-setup/cursor.md)
     * [GitHub Copilot](reference/developer-mcp/host-setup/github-copilot.md)
+    * [OpenAI Codex](reference/developer-mcp/host-setup/openai-codex.md)
   * [Best Practice](reference/developer-mcp/best-practice/README.md)
     * [Example Instruction File](reference/developer-mcp/best-practice/example-instructions.md)
     * [Creating Media](reference/developer-mcp/best-practice/creating-media.md)

16/umbraco-cms/reference/developer-mcp/README.md

@@ -97,6 +97,7 @@ Each MCP-compatible host application has its own setup process. Below you can fi
 - [Claude Code](./host-setup/claude-code.md)  
 - [GitHub Copilot](./host-setup/github-copilot.md)  
 - [Cursor](./host-setup/cursor.md)  
+- [OpenAI Codex](./host-setup/openai-codex.md)
 
 Although the details vary slightly, the general pattern is the same across all hosts:
 

16/umbraco-cms/reference/developer-mcp/host-setup/README.md

@@ -19,3 +19,8 @@ Getting started with Cursor.
 ## [GitHub Copilot](./github-copilot.md)
 
 Getting started with GitHub Copilot.
+
+## [OpenAI Codex](./openai-codex.md)
+
+Getting started with OpenAI Codex.
+

16/umbraco-cms/reference/developer-mcp/host-setup/openai-codex.md

@@ -0,0 +1,62 @@
+---
+description: "Host setup for OpenAI Codex"
+---
+
+# OpenAI Codex Setup
+
+[OpenAI Codex](https://openai.com/blog/openai-codex) is OpenAI's terminal-first workspace that pairs a shell, editor, and conversational developer agent. With Model Context Protocol (MCP) support, you can connect Codex directly to Umbraco's tools and data so the assistant can work inside your projects.
+
+## Getting started
+
+Install the Codex CLI with npm:
+
+```bash
+npm install -g @openai/codex
+```
+
+Or install the Codex CLI with brew:
+
+```bash
+brew install codex
+```
+
+### Configure using the Codex CLI
+
+Add the Umbraco MCP server with the Codex CLI:
+
+```bash
+codex mcp add umbraco-mcp -- npx -y @umbraco-cms/mcp-dev@beta
+```
+
+#### Define configuration values directly
+
+If you prefer to keep secrets in your shell session, pass them as environment variables during registration:
+
+```bash
+codex mcp add umbraco-mcp \
+  --env UMBRACO_CLIENT_ID="your-id" \
+  --env UMBRACO_CLIENT_SECRET="your-secret" \
+  --env UMBRACO_BASE_URL="https://your-domain.com" \
+  --env NODE_TLS_REJECT_UNAUTHORIZED="0" \
+  --env UMBRACO_INCLUDE_TOOL_COLLECTIONS="document,media,document-type,data-type" \
+  -- npx -y @umbraco-cms/mcp-dev@beta
+```
+
+Replace the `UMBRACO_CLIENT_ID`, `UMBRACO_CLIENT_SECRET`, `UMBRACO_BASE_URL`, and `UMBRACO_INCLUDE_TOOL_COLLECTIONS` values with your local connection details.
+
+This command stores the MCP server as `umbraco-mcp` in your Codex configuration file (typically `~/.codex/config.toml`).
+
+{% hint style="info" %}
+Use the command below at any time to see which MCP servers Codex is currently loading:
+
+```
+codex mcp list
+```
+{% endhint %}
+
+## Managing tools and tool collections
+
+When you change the tool set:
+
+- Update your `.env` file with the tool collections you want (for example `document,media`).
+- Repeat the `codex mcp list` command to confirm that the server is healthy.