MCP (Model Context Protocol) 서버는 AI 전원 콘텐츠 관리를 잠금 해제하는 Umbraco CMS 용. 그것은 Umbraco Management API에 대한 포괄적 인 액세스를 제공하며, AI 에이전트가 자연 대화를 통해 사무실 작업을 수행 할 수 있도록 - UI에서 당신을 해방하고 복잡하고 반복적 인 워크플로우를 만들거나 수동으로 노력할 수 있습니다.

소개

MCP 서버는 Umbraco API 사용자를 사용하여 보안을 보장하고 Umbraco Management API에 대한 권한 기반 액세스를 보장합니다. 이것은 당신의 AI 대리인이 Umbraco의 표준 사용자 허가 체계를 통해서 할 수 있는 무슨에 완전한 통제를 유지합니다 - 요구되는 특별한 안전 모형 없음.

빠른 시작

##1. Umbraco API 사용자 만들기

첫째, 적절한 권한을 가진 Umbraco API 사용자를 만듭니다. Umbraco의 문서에 대한 지침을 찾을 수 있습니다.

##2. Claude 데스크톱 설치

Claude Desktop 앱을 다운로드하고 설치 한 다음 MCP 서버를 구성에 추가하십시오.

1. 오픈 클로드 데스크탑 설정 > 개발자 > Edit Config

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.