# Umbraco-CMS-MCP-Dev

MCP-сервер связывает ИИ-агента с Umbraco Management API через служебную учётную запись. Пригодится разработчикам для правки документов и медиафайлов без веб-интерфейса.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 39
- Автор: umbraco
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/umbraco/Umbraco-CMS-MCP-Dev
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/umbraco-cms-mcp-dev

## Что делает

Сервер открывает ассистенту доступ к Umbraco Management API. Через него агент изменяет документы и медиафайлы без ручной работы в бэкофисе. Доступ ограничен правами учётной записи Umbraco API user. Поэтому агент не выйдет за рамки выданных разрешений.

Пакет запускается локально через `npx` либо разворачивается в Cloudflare Worker для Umbraco Cloud. Переменная `UMBRACO_INCLUDE_TOOL_COLLECTIONS` фильтрует активные наборы инструментов. Флаг `UMBRACO_READONLY` включает безопасный режим только для чтения.

Версию `@umbraco-cms/mcp-dev` необходимо фиксировать под мажорный релиз CMS, например `@17` или `@18`. Если мажорные версии разойдутся, схемы инструментов перестанут совпадать с Management API прямо посреди выполнения задачи.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `UMBRACO_CLIENT_ID`, `UMBRACO_CLIENT_SECRET`, `UMBRACO_BASE_URL`, `UMBRACO_INCLUDE_TOOL_COLLECTIONS`, `UMBRACO_READONLY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env UMBRACO_CLIENT_ID=<UMBRACO_CLIENT_ID> --env UMBRACO_CLIENT_SECRET=<UMBRACO_CLIENT_SECRET> --env UMBRACO_BASE_URL=<UMBRACO_BASE_URL> --env UMBRACO_INCLUDE_TOOL_COLLECTIONS=<UMBRACO_INCLUDE_TOOL_COLLECTIONS> --env UMBRACO_READONLY=<UMBRACO_READONLY> --transport stdio umbraco-cms-mcp-dev -- npx -y @umbraco-cms/mcp-dev
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add umbraco-cms-mcp-dev --env UMBRACO_CLIENT_ID=<UMBRACO_CLIENT_ID> --env UMBRACO_CLIENT_SECRET=<UMBRACO_CLIENT_SECRET> --env UMBRACO_BASE_URL=<UMBRACO_BASE_URL> --env UMBRACO_INCLUDE_TOOL_COLLECTIONS=<UMBRACO_INCLUDE_TOOL_COLLECTIONS> --env UMBRACO_READONLY=<UMBRACO_READONLY> -- npx -y @umbraco-cms/mcp-dev
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "umbraco-cms-mcp-dev": {
            "command": "npx",
            "args": [
                "-y",
                "@umbraco-cms/mcp-dev"
            ],
            "env": {
                "UMBRACO_CLIENT_ID": "<UMBRACO_CLIENT_ID>",
                "UMBRACO_CLIENT_SECRET": "<UMBRACO_CLIENT_SECRET>",
                "UMBRACO_BASE_URL": "<UMBRACO_BASE_URL>",
                "UMBRACO_INCLUDE_TOOL_COLLECTIONS": "<UMBRACO_INCLUDE_TOOL_COLLECTIONS>",
                "UMBRACO_READONLY": "<UMBRACO_READONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "umbraco-cms-mcp-dev": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@umbraco-cms/mcp-dev"
            ],
            "env": {
                "UMBRACO_CLIENT_ID": "<UMBRACO_CLIENT_ID>",
                "UMBRACO_CLIENT_SECRET": "<UMBRACO_CLIENT_SECRET>",
                "UMBRACO_BASE_URL": "<UMBRACO_BASE_URL>",
                "UMBRACO_INCLUDE_TOOL_COLLECTIONS": "<UMBRACO_INCLUDE_TOOL_COLLECTIONS>",
                "UMBRACO_READONLY": "<UMBRACO_READONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e UMBRACO_CLIENT_ID=<UMBRACO_CLIENT_ID> -e UMBRACO_CLIENT_SECRET=<UMBRACO_CLIENT_SECRET> -e UMBRACO_BASE_URL=<UMBRACO_BASE_URL> -e UMBRACO_INCLUDE_TOOL_COLLECTIONS=<UMBRACO_INCLUDE_TOOL_COLLECTIONS> -e UMBRACO_READONLY=<UMBRACO_READONLY> umbraco-cms-mcp-dev npx -y @umbraco-cms/mcp-dev
```
Вместо <…> подставьте свои значения

## Когда брать
- управлять контентом и медиафайлами в Umbraco CMS через чат
- просматривать и менять типы документов без панели управления
- настраивать типы данных в Umbraco через Management API
- ограничивать операции ИИ-агента безопасным режимом `UMBRACO_READONLY`

## Примеры запросов агенту
- Создай новый документ типа `blogPost` в разделе новостей Umbraco.
- Выведи список зарегистрированных типов данных из коллекции `data-type`.
- Загрузи файл изображения в коллекцию `media`.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md