Skip to content

Formatted article as per styleguide #7651

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 21, 2025
Merged

Formatted article as per styleguide #7651

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 13 additions & 14 deletions 16/umbraco-cms/reference/developer-mcp/host-setup/claude-code.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,36 +16,35 @@ npm install -g @anthropic-ai/claude-code

### Configuration using the CLI tool

**Basic CLI installation**

Add an MCP server using the Claude CLI:
1. Add the Umbraco MCP server using the Claude CLI:

```bash
claude mcp add umbraco-mcp npx @umbraco-cms/mcp-dev@16
```

**Define configuration values directly**

To define configuration values directly, use this pattern:
2. Define configuration values directly using this 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="document,media,document-type,data-type" -- npx @umbraco-cms/mcp-dev@16
```

Replace the `UMBRACO_CLIENT_ID`, `UMBRACO_CLIENT_SECRET`, `UMBRACO_BASE_UR` and `UMBRACO_INCLUDE_TOOL_COLLECTIONS` values with your local connection details.
Replace the following values with your local connection details:

This command adds the MCP server as `umbraco-mcp` in your project’s `claude.json` configuration file.
- `UMBRACO_CLIENT_ID`
- `UMBRACO_CLIENT_SECRET`
- `UMBRACO_BASE_URL`
- `UMBRACO_INCLUDE_TOOL_COLLECTIONS`

{% hint style="info" %}
Use the command
This command registers the MCP server as `umbraco-mcp` in your project’s `claude.json` configuration file.

```
3. Check which MCP servers are currently active in your Claude Code environment:

```cs
claude mcp list
```

anytime to confirm which MCP servers are active in your Claude Code environment.
{% endhint %}

### Project-specific configuration via `.mcp.json`
Expand All @@ -57,7 +56,7 @@ This is the referred project-level configuration for Claude Code. Creating a `.m
- Override global Claude Code MCP settings.
- Use an `.env` file to prevent secrets being added to source.

Example `.env` file
#### Example `.env` file

```bash
UMBRACO_CLIENT_ID=umbraco-back-office-mcp
Expand All @@ -68,7 +67,7 @@ UMBRACO_INCLUDE_TOOL_COLLECTIONS=document,media,document-type,data-type

Replace the `UMBRACO_CLIENT_ID`, `UMBRACO_CLIENT_SECRET`, `UMBRACO_BASE_URL` and `UMBRACO_INCLUDE_TOOL_COLLECTIONS` values with your local connection details.

Example `.mcp.json` file
#### Example `.mcp.json` file

```json
{
Expand Down