Merge pull request #7652 from umbraco/mcp-dev-docs

Formatted article as per styleguide

Author: eshanrnh

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

@@ -37,7 +37,7 @@ Replace the `UMBRACO_CLIENT_ID`, `UMBRACO_CLIENT_SECRET`, and `UMBRACO_BASE_URL`
 ![MCP Panel Added](../images/Cursor-MCP-Added.png)
 
 - The warning above indicates that the number of tools exceeds the limit is expected behaviour.
-- Next, [choose which tools or tool collections](../mcp-toolkit.md) you want to enable for your first task.
+- [Choose which tools or tool collections](../mcp-toolkit.md) you want to enable for your first task.
 
 {% hint style="info" %}
 Selecting only the tools you need helps keep your setup efficient and conversations with your AI assistant more focused.

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

@@ -30,4 +30,4 @@ Once you’ve added your MCP Server and updated the JSON configuration, restarti
 Restarting the MCP Server applies any configuration or tool changes immediately without needing to reinstall or re-add the server.
 {% endhint %}
 
-Next, [choose which tools or tool collections](../mcp-toolkit.md) you want to enable for your first task.
+[Choose which tools or tool collections](../mcp-toolkit.md) you want to enable for your first task.

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

@@ -8,29 +8,27 @@ description: "Host setup for OpenAI Codex"
 
 ## Getting started
 
-Install the Codex CLI with npm:
+Option A: Install via npm:
 
 ```bash
 npm install -g @openai/codex
 ```
 
-Or install the Codex CLI with brew:
+Option B: Install via Homebrew:
 
 ```bash
 brew install codex
 ```
 
 ### Configure using the Codex CLI
 
-Add the Umbraco MCP server with the Codex CLI:
+1. Add the Umbraco MCP server with the Codex CLI:
 
 ```bash
 codex mcp add umbraco-mcp -- npx -y @umbraco-cms/mcp-dev@16
 ```
 
-#### Define configuration values directly
-
-If you prefer to keep secrets in your shell session, pass them as environment variables during registration:
+2. 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 \
@@ -42,21 +40,24 @@ codex mcp add umbraco-mcp \
   -- npx -y @umbraco-cms/mcp-dev@16
 ```
 
-Replace the `UMBRACO_CLIENT_ID`, `UMBRACO_CLIENT_SECRET`, `UMBRACO_BASE_URL`, and `UMBRACO_INCLUDE_TOOL_COLLECTIONS` values with your local connection details.
+Replace the following values with your local connection details:
+
+- `UMBRACO_CLIENT_ID`
+- `UMBRACO_CLIENT_SECRET`
+- `UMBRACO_BASE_URL`
+- `UMBRACO_INCLUDE_TOOL_COLLECTIONS`
 
 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:
+3. Use the command below to see which MCP servers Codex is currently loading:
 
-```
+```cs
 codex mcp list
 ```
-{% endhint %}
 
 ## Managing tools and tool collections
 
-When you change the tool set:
+When you need to 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.
+- Update your `.env` file with the tool collections you want (for example, `document,media`).
+- Run the `codex mcp list` command to confirm that the server is healthy.