Umbraco-CMS-MCP-Dev — MCP-сервер для Claude Code
MCP-сервер связывает ИИ-агента с Umbraco Management API через служебную учётную запись. Пригодится разработчикам для правки документов и медиафайлов без веб-интерфейса.
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Что делает 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 прямо посреди выполнения задачи.
Какие задачи решает
- управлять контентом и медиафайлами в Umbraco CMS через чат
- просматривать и менять типы документов без панели управления
- настраивать типы данных в Umbraco через Management API
- ограничивать операции ИИ-агента безопасным режимом
UMBRACO_READONLY
Примеры запросов агенту
- Создай новый документ типа
blogPostв разделе новостей Umbraco. - Выведи список зарегистрированных типов данных из коллекции
data-type. - Загрузи файл изображения в коллекцию
media.
Как установить Umbraco-CMS-MCP-Dev
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Umbraco-CMS-MCP-Dev
Как установить Umbraco-CMS-MCP-Dev в Claude Code?
Выполните команду: `claude mcp add umbraco-cms-mcp-dev -e UMBRACO_CLIENT_ID=<UMBRACO_CLIENT_ID> -e UMBRACO_CLIENT_SECRET=<UMBRACO_CLIENT_SECRET> -e UMBRACO_BASE_URL=<UMBRACO_BASE_URL> -- npx -y @umbraco-cms/mcp-dev`. Значения в угловых скобках замените на реквизиты API user и адрес вашей CMS.
Что нужно подготовить перед запуском сервера?
В панели Umbraco нужно создать пользователя API user и сгенерировать client ID с секретом. Также потребуется запущенный инстанс CMS с доступным Management API.
Почему важно указывать номер мажорной версии при установке?
Схемы инструментов в пакете строго соответствуют конкретному релизу Management API. Несовпадение мажорных версий пакета и сайта приведёт к сбою вызовов в процессе работы.
