Umbraco CMS 用の MCP (Model Context Protocol) サーバーで、AI によるコンテンツ管理のロックを解除します。 Umbraco Management API への包括的なアクセスを提供し、AI エージェントが自然な会話を通してバックオフィスのタスクを実行できるようにします。UI から解放し、複雑で反復的なワークフローをすることで、面倒な、または不可能な手動で楽になりましょう。

イントロ

MCP サーバーは、Umbraco API ユーザを使用して認証を行い、Umbraco Management API へのセキュアで権限ベースのアクセスを保証します。 これは、Umbracoの標準的なユーザーパーミッションシステム - 特別なセキュリティモデルは必要ありません。

クイックスタート

##1. Umbraco API ユーザーを作成する

まず、Umbraco API ユーザを適切な権限で作成します。 Umbraco のドキュメントの指示があります。

##2. Claudeデスクトップにインストール

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.