Add comprehensive host setup documentation for Claude Desktop and Claude Code

- Added detailed setup guide for Claude Desktop with configuration examples
- Added detailed setup guide for Claude Code with CLI and .mcp.json configuration
- Updated main README with Node.js version requirement hint
- Improved formatting of host setup links in README

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: Phil Whittaker

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

@@ -81,17 +81,18 @@ For example:
 - A user with Administrator permissions grants full access — including the ability to create, edit, or delete document types, data types and more within Umbraco.
 
 {% hint style="warning" %}
-Only use a dedicated API user for MCP connections. Do not share or reuse credentials from an existing backoffice user.
+Only use a dedicated API user for MCP connections.   
+Do not share or reuse credentials from an existing backoffice user.
 {% endhint %}
 
 ### Host Setup
 
 Each MCP-compatible host application has its own setup process. For this reason, we provide dedicated setup guides for the main developer environments we see most often:
 
-[Claude Desktop](./host-setup/claude-desktop.md)
-[Claude Code](./host-setup/claude-code.md)
-[GitHub Copilot](./host-setup/github-copilot.md)
-[Cursor](./host-setup/cursor.md)
+[Claude Desktop](./host-setup/claude-desktop.md)  
+[Claude Code](./host-setup/claude-code.md)  
+[GitHub Copilot](./host-setup/github-copilot.md)  
+[Cursor](./host-setup/cursor.md)  
 
 Although the details vary slightly, the general pattern is the same across all hosts:
 
@@ -115,6 +116,11 @@ Add your Umbraco MCP configuration values (Client ID, Client Secret, URL of umbr
 
 Once restarted, you’ll have access to the full suite of tools available through the Umbraco CMS Developer MCP Server.
 
+{% hint style="info" %}
+This Developer MCP Server requires Node.js version 22 or higher to be installed.  
+You can check your current Node.js version by running node -v in your terminal.
+{% endhint %}
+
 ### Choosing Your Tools
 
 Your first step after setup should be deciding which tools you want to enable.

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

@@ -0,0 +1,81 @@
+---
+description: "Host set up for Claude Code"
+---
+
+# Claude Code
+
+[Claude Code](https://www.claude.com/product/claude-code) is a developer-focused coding environment from Anthropic that integrates Claude’s large language models (LLMs) directly into your code editor.
+It allows you to chat, refactor, and generate code within your projects.
+
+To get started install Claude Code globally
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+## Configuration using the CLI tool
+
+Basic install
+
+```bash
+claude mcp add umbraco-mcp npx @umbraco-cms/mcp-dev@beta
+```
+
+If you prefer to define configuration values directly, use the following pattern:
+
+```bash
+
+# Add with environment variables
+claude 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="culture,document,media" -- npx @umbraco-cms/mcp-dev@beta
+```
+
+This will register umbraco-mcp in your project’s claude.json configuration file.
+
+{% hint style="info" %}
+Use claude mcp list anytime to confirm which MCP servers are active in your Claude Code environment.
+{% endhint %}
+
+## Configuration via .mcp.json (Project-specific)
+
+For project-level configuration, create a .mcp.json file in your project root.  
+
+Using the `.mcp.json` file allows you to:
+- Configure MCP servers per project
+- Share configuration safely with team members
+- Override global Claude Code MCP settings
+- Use an .env file to prevent secrets being added to source
+
+Example .env file
+
+```bash
+UMBRACO_CLIENT_ID=umbraco-back-office-mcp
+UMBRACO_CLIENT_SECRET=1234567890
+UMBRACO_BASE_URL=http://localhost:123456
+```
+
+Example .mcp.json file
+
+```json
+{
+  "mcpServers": {
+    "umbraco-mcp": {
+      "command": "npx",
+      "args": ["@umbraco-cms/mcp-dev@beta"],
+    }
+  }
+}
+```
+
+For details on .env format and supported configuration keys, see the [Configuration guide](../configuration.md).
+
+{% hint style="warning" %}
+Never commit live credentials to source control. Always use environment variables or a .env file.
+{% endhint %}
+
+## Easier tool and tool collection management 
+
+Another benefit of using a .env file is that it makes it much easier to adjust tool configurations for different tasks.
+Claude Code lets you quickly reconnect to an MCP server using its slash commands, so you can switch environments or update settings without editing your main configuration files.
+
+- Update the .env file with the new tools set
+- In Claude Code CLI use **/mcp reconnect umbraco-mcp** to restart the mcp server 

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

@@ -0,0 +1,53 @@
+---
+description: "Host set up for Claude Desktop"
+---
+
+# Claude Desktop
+
+[Claude Desktop](https://www.anthropic.com/claude/desktop) is Anthropic’s AI-powered assistant for macOS and Windows, designed to help you work conversationally across all kinds of tasks — from writing and brainstorming to coding and automation.
+
+## Getting started 
+
+First download and install the [Claude.ai desktop app](https://claude.ai/download).  
+
+To edit the MCP settings, go to Settings → Developer → Edit Config.
+Open the JSON configuration file in your preferred text editor and add the following snippet. Replace the UMBRACO_CLIENT_ID, UMBRACO_CLIENT_SECRET, and UMBRACO_BASE_URL values with your local connection details.
+
+The NODE_TLS_REJECT_UNAUTHORIZED environment flag is included to allow Claude Desktop to connect to the MCP Server when using a self-signed certificate.
+
+
+```bash
+{
+  "mcpServers": 
+  {
+    "umbraco-mcp": 
+    {
+      "command": "npx",
+      "args": ["@umbraco-cms/mcp-dev@beta"],
+      "env": 
+      {
+        "NODE_TLS_REJECT_UNAUTHORIZED": "0",
+        "UMBRACO_CLIENT_ID": "umbraco-back-office-mcp",
+        "UMBRACO_CLIENT_SECRET": "1234567890",
+        "UMBRACO_BASE_URL": "https://localhost:12345"
+      }
+    }
+  }
+}
+```
+
+Restart Claude to activate the new configuration.
+When the Umbraco MCP Server starts, you’ll be prompted to allow access for each of the available tools.
+
+If you encounter a connection error, open the logs and review the file named mcp-server-umbraco-mcp.log for details on how to resolve the issue.
+
+> [!NOTE]
+> You may need to update to a paid version of Claude.ai in order to have a large enough context window to run your prompts.
+
+## Node version mismatch
+
+Occasionally, Claude Desktop may use the wrong version of Node.js when running the MCP Server.
+A minimum of Node.js version 22 is required. This issue most commonly occurs when using a Node.js version manager such as nvm, as Claude Desktop can sometimes default to the lowest installed version rather than the active one set by nvm.
+
+Unfortunately, the only reliable fix is to remove all older Node.js versions, leaving only version 22 or higher installed.
+This behaviour appears to be specific to Claude Desktop and does not affect other AI hosts.