Umbraco CMS 的 MCP（模型上下文协议）服务器，解锁 AI 驱动的内容管理。它提供对 Umbraco 管理 API 的全面访问，使你的 AI 代理能够通过自然对话完成后台任务——让你摆脱界面，让那些繁琐或无法手动完成的复杂重复工作变得轻松无阻。

开场白

MCP服务器通过Umbraco API用户进行身份验证，确保安全且基于权限的访问Umbraco管理API。这意味着您可以通过Umbraco标准的用户权限系统，完全控制AI代理的功能——无需特殊安全模型。

快速启动

1.创建一个 Umbraco API 用户

首先，创建一个拥有适当权限的 Umbraco API 用户。你可以在 Umbraco 的文档中找到相关说明。

2.在 Claude Desktop 中安装

下载并安装Claude桌面应用，然后将MCP服务器添加到你的配置中：

1. 打开 Claude 桌面设置>开发者>编辑配置

2. 将此配置添加到你的claude_desktop_config.json中：

3. 完全重启 Claude 桌面（包括 Windows 的系统托盘）

Umbraco MCP

An MCP (Model Context Protocol) server for Umbraco CMS that unlocks AI-powered content management. It provides comprehensive access to the Umbraco Management API, enabling your AI agent to perform back office tasks through natural conversation - freeing you from the UI and making complex, repetitive workflows that would be tedious or impossible manually become effortless.

Intro

The MCP server authenticates using an Umbraco API user, ensuring secure, permission-based access to the Umbraco Management API. This means you maintain complete control over what your AI agent can do through Umbraco’s standard user permission system - no special security model required.

Quick Start

1. Create an Umbraco API User

First, create an Umbraco API user with appropriate permissions. You can find instructions in Umbraco’s documentation.

2. Install in Claude Desktop

Download and install the Claude Desktop app, then add the MCP server to your configuration:

1. Open Claude Desktop Settings > Developer > Edit Config
2. Add this configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "umbraco-mcp": {
      "command": "npx",
      "args": ["@umbraco-cms/mcp-dev@17"],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0",
        "UMBRACO_CLIENT_ID": "your-api-user-id",
        "UMBRACO_CLIENT_SECRET": "your-api-secret",
        "UMBRACO_BASE_URL": "https://localhost:{port}",
        "UMBRACO_INCLUDE_TOOL_COLLECTIONS": "document,media,document-type,data-type"
      }
    }
  }
}

3. Fully restart Claude Desktop (including in the system tray on Windows)

Tip: Pin @umbraco-cms/mcp-dev to your site’s Umbraco major (e.g. @17 above, or @18 for an Umbraco 18.x site) rather than @latest. Tool schemas track the Management API of the package’s own major, so a mismatched major can fail confusingly mid-task once a tool’s shape has drifted. The server checks the connected site’s version on startup and warns on a mismatch, but pinning avoids it altogether.

Documentation

For complete installation instructions, configuration options, tool listings, and usage examples, see the full documentation:

Umbraco MCP Documentation

Hosted Deployment

The Cloudflare Worker entry point (src/worker.ts) supports two deployment modes, selected at request time by the @umbraco-cms/mcp-hosted library:

• Single-tenant (default) — the worker authenticates against the UMBRACO_BASE_URL configured in wrangler.toml. This is the existing behavior and requires no extra configuration.