{
  "markdown": "# Umbraco MCP ![GitHub License](https://img.shields.io/github/license/umbraco/Umbraco-CMS-MCP-Dev?style=plastic&link=https%3A%2F%2Fgithub.com%2Fumbraco%2FUmbraco-CMS-MCP-Dev%2Fblob%2Fmain%2FLICENSE)\n\nAn MCP (Model Context Protocol) server for [Umbraco CMS](https://umbraco.com/) 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.\n\n## Intro\n\nThe 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.\n\n## Quick Start\n\n### 1. Create an Umbraco API User\n\nFirst, create an Umbraco API user with appropriate permissions. You can find instructions in [Umbraco's documentation](https://docs.umbraco.com/umbraco-cms/fundamentals/data/users/api-users).\n\n### 2. Install in Claude Desktop\n\nDownload and install the [Claude Desktop app](https://claude.ai/download), then add the MCP server to your configuration:\n\n1. Open Claude Desktop Settings > Developer > Edit Config\n2. Add this configuration to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"umbraco-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"@umbraco-cms/mcp-dev@17\"],\n      \"env\": {\n        \"NODE_TLS_REJECT_UNAUTHORIZED\": \"0\",\n        \"UMBRACO_CLIENT_ID\": \"your-api-user-id\",\n        \"UMBRACO_CLIENT_SECRET\": \"your-api-secret\",\n        \"UMBRACO_BASE_URL\": \"https://localhost:{port}\",\n        \"UMBRACO_INCLUDE_TOOL_COLLECTIONS\": \"document,media,document-type,data-type\"\n      }\n    }\n  }\n}\n```\n\n3. Fully restart Claude Desktop (including in the system tray on Windows)\n\n## Documentation\n\nFor complete installation instructions, configuration options, tool listings, and usage examples, see the full documentation:\n\n**[Umbraco MCP Documentation](https://docs.umbraco.com/umbraco-developer-mcp)**\n\n## Hosted Deployment\n\nThe Cloudflare Worker entry point (`src/worker.ts`) supports two deployment modes, selected at request time by the `@umbraco-cms/mcp-hosted` library:\n\n- **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.\n- **Multi-tenant Umbraco Cloud** — set `UMBRACO_CLOUD_ROUTING_ENABLED = \"true\"` under `[vars]` in `wrangler.toml`. Requests to `/at/{alias}/...` resolve the upstream Umbraco Cloud project for `{alias}` and issue access tokens scoped to that resource per the MCP resource-indicator spec. Each Umbraco Cloud project served by the worker must register an OpenIddict client with id `umbraco-cms-developer-mcp-hosted`.\n\n`siteRouting` is wired unconditionally; the per-request toggle is the env var.\n\n## Contributing with AI Tools\n\nThis project is optimized for development with AI coding assistants. We provide instruction files for popular AI tools to help maintain consistency with our established patterns and testing standards.\n\n### Using rulesync\n\nThe project includes rulesync configuration files that can automatically generate instruction files for 19+ AI development tools. Generate configuration files for your preferred AI tools:\n\n```bash\n# Generate only for Claude Code\nnpx rulesync generate --claudecode\n\n# Generate only for Cursor\nnpx rulesync generate --cursor\n\n# Generate only for Vs Code Copilot\nnpx rulesync generate --copilot\n```\n\n### Other AI Tools\n\nrulesync supports 19+ AI development tools including GitHub Copilot, Cline, Aider, and more. Check the [rulesync repository](https://github.com/dyoshikawa/rulesync) for the complete list of supported tools.\n\nThe instruction files cover:\n- MCP development patterns and conventions\n- TypeScript implementation guidelines\n- Comprehensive testing standards with builders and helpers\n- Project-specific context and architecture\n- API integration patterns with Umbraco Management API\n",
  "bytes": 4169,
  "sha": "19728463652f4467727c9146b148c0313997ae4992682da1ad84c819081382e3",
  "repo_slug": "umbraco/umbraco-cms-mcp-dev",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_umbraco_umbraco_cms_mcp_dev_development__d2dcd412/readme"
}