Шаблоны, конструктор дизайна, модули, FTP и скиллы — через AI-инструменты
MCP (Model Context Protocol) для uCoz — production-ready сервер из пяти инструментов: templates_tool, tmaker_tool, ftp_tool, modules_tool, skills_tool. Через обычные текстовые запросы AI может править отдельные шаблоны, публиковать дизайн всего сайта из каркаса, управлять меню и страницами, устанавливать модули, работать с FTP и учитывать использование скиллов.
npx ucoz-mcp@latest. Повседневные правки — через templates_tool; новый дизайн целиком — через tmaker_tool.
Обновляйте шаблоны сайта за минуты — без ручного редактирования в панели управления.
Автоматический бэкап перед каждым сохранением и быстрый откат к предыдущей версии.
Проверка HTML-кода шаблона перед сохранением без риска сломать отображение сайта.
Загружайте CSS, JS и изображения с локального проекта или прямо из чата агента.
Создавайте и обновляйте меню через AI — горизонтальные и вертикальные, с вложенностью.
Создание форм обратной связи с нужными полями и шаблоном письма прямо из чата.
Создавайте и редактируйте страницы из чата — с собственным дизайном или в общем стиле сайта.
Соберите каркас и опубликуйте его сразу во все шаблоны — с валидацией, снимками и автобэкапом.
Подключайте нужные модули и управляйте настройками сайта без панели управления.
Создавайте и меняйте FTP-пароль через AI — без ручного входа в панель.
Официальные скиллы из каталога сами фиксируют использование на сайте через MCP.
Поддержка Cursor, Codex, Antigravity, Claude Desktop и любых других stdio-совместимых клиентов.
Для работы MCP требуется установленный Node.js, так как сервер запускается через npx.
node -vnpx -vДля работы с API необходимо создать персональный токен доступа.
tmaker_tool, modules_tool и ftp_password_* включите право «Доступ к панели управления»Для работы с файлами сайта через MCP потребуется FTP-доступ.
{
"mcpServers": {
"ucoz-mcp": {
"command": "npx",
"args": ["-y", "ucoz-mcp@latest"],
"env": {
"UCOZ_API_TOKEN": "ВАШ_UCOZ_API_TOKEN",
"UCOZ_SITE_URL": "https://ваш-сайт.ucoz.net/",
"UCOZ_FTP_HOST": "ваш-сайт.ucoz.net",
"UCOZ_FTP_USER": "ваш-ftp-логин",
"UCOZ_FTP_PASS": "ваш-ftp-пароль"
}
}
}
}Сохраните файл и перезапустите MCP-сервер в настройках.
STDIO.npx.-y, ucoz-mcp@latest.UCOZ_API_TOKEN — ваш uAPI-токен.UCOZ_SITE_URL — адрес сайта.UCOZ_FTP_HOST — FTP-хост.UCOZ_FTP_USER — FTP-логин.UCOZ_FTP_PASS — FTP-пароль.Сохраните настройки и перезапустите MCP-сервер.
... в правом верхнем углу.mcp_config.json. Добавьте в него блок:{
"mcpServers": {
"ucoz-mcp": {
"command": "npx",
"args": ["-y", "ucoz-mcp@latest"],
"env": {
"UCOZ_API_TOKEN": "ВАШ_UCOZ_API_TOKEN",
"UCOZ_SITE_URL": "https://ваш-сайт.ucoz.net/",
"UCOZ_FTP_HOST": "ваш-сайт.ucoz.net",
"UCOZ_FTP_USER": "ваш-ftp-логин",
"UCOZ_FTP_PASS": "ваш-ftp-пароль"
}
}
}
}Сохраните файл, нажмите Refresh и убедитесь, что сервер появился и включён.
Добавьте тот же блок в claude_desktop_config.json:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%/Claude/claude_desktop_config.json{
"mcpServers": {
"ucoz-mcp": {
"command": "npx",
"args": ["-y", "ucoz-mcp@latest"],
"env": {
"UCOZ_API_TOKEN": "ВАШ_UCOZ_API_TOKEN",
"UCOZ_SITE_URL": "https://ваш-сайт.ucoz.net/",
"UCOZ_FTP_HOST": "ваш-сайт.ucoz.net",
"UCOZ_FTP_USER": "ваш-ftp-логин",
"UCOZ_FTP_PASS": "ваш-ftp-пароль"
}
}
}
}
Пять инструментов: templates_tool, tmaker_tool, ftp_tool, modules_tool, skills_tool.
templates_tool правит один шаблон (module_id + template_id),
а tmaker_tool пересобирает все шаблоны сайта из одного каркаса. Для повседневных правок используйте templates_tool.
templates_tool
— основной инструмент для шаблонов, бэкапов, глобальных блоков, меню, почтовых форм и страниц сайта. Перед сохранением создаётся бэкап. Вывод в шаблоне: $NMENU_<ID>$ (вертикальное меню), $SMENU_<ID>$ (горизонтальное), $MFORM_<ID>$ (почтовая форма).
| Action | Что делает | Обязательные параметры |
|---|---|---|
list_modules | Возвращает список модулей и ID шаблонов. | — |
get_variables | Показывает переменные для выбранного модуля/шаблона. | module_id, template_id |
read_template | Читает текущий HTML-код шаблона (include_variables=true — добавляет список переменных). | module_id, template_id |
patch_template | Точечная замена фрагмента без перезаписи всего шаблона (см. блок ниже). | module_id, template_id, code_search, code_paste |
update_template | Полная замена шаблона; бэкап создаётся автоматически. Только для новых шаблонов или полной перезаписи. | module_id, template_id, html_content |
validate_template | Проверяет код шаблона без сохранения. | module_id, template_id, content |
list_backups | Список существующих бэкапов шаблона. | module_id, template_id |
create_backup | Создаёт бэкап вручную. | module_id, template_id |
delete_backup | Удаляет бэкап по ID. | backup_id |
restore_backup | Восстанавливает шаблон из бэкапа. | backup_id |
gblock_create | Создаёт глобальный блок. | name, content |
gblock_delete | Удаляет глобальный блок. | block_id |
menu_list | Список всех меню сайта. | — |
menu_create | Создаёт новое меню (layout: 0 — горизонт., 1 — верт.). | title, layout |
menu_get | Возвращает меню с пунктами. | menu_id |
menu_update | Обновляет заголовок и/или тип меню. | menu_id |
menu_delete | Удаляет меню. | menu_id |
menu_update_items | Заменяет дерево пунктов меню (поддерживает children). | menu_id, items |
mail_list_forms | Список всех почтовых форм. | — |
mail_get_form | Детали формы. | form_id |
mail_create_form | Создаёт новую форму. | name, email |
mail_update_form | Обновляет имя, получателей, сообщение об успехе. | form_id |
mail_delete_form | Удаляет форму. | form_id |
mail_list_fields | Список полей формы. | form_id |
mail_add_field | Добавляет поле в форму. | form_id, label, type |
mail_update_field | Обновляет поле. | form_id, field_id |
mail_delete_field | Удаляет поле. | form_id, field_id |
mail_move_field | Меняет порядок поля. | form_id, field_id, direction |
mail_get_template | Читает HTML-шаблон письма формы. | form_id |
mail_save_template | Сохраняет HTML-шаблон письма. | form_id, template_html |
page_list | Список страниц сайта (пагинация: page_page, page_per_page). | — |
page_get | Возвращает страницу по ID. | page_id |
page_add | Создаёт страницу. page_tmpl — личный шаблон; только page_message — общий дизайн сайта. | — |
page_update | Обновляет страницу (меняются только переданные поля). | page_id |
page_delete | Удаляет страницу (главную, ID=1, удалить нельзя). | page_id |
get_reference | Справочник переменных языка шаблонов. | — |
get_guide | Руководство по архитектуре шаблонов. | — |
get_backup_guide | Руководство по безопасной работе с бэкапами. | — |
patch_template — точечные правки шаблонаИспользуйте для любых изменений существующего кода. Перед сохранением создаётся бэкап (как и при update_template).
| Параметр | Описание |
|---|---|
code_search | Точный фрагмент для поиска — побайтное совпадение (пробелы, табы, переносы строк). Копируйте из read_template, не переформатируйте. Должен встречаться ровно один раз. |
code_paste | Текст замены. Пустая строка "" удаляет найденный фрагмент. Нельзя удалить или скрыть $POWERED_BY$. |
При достижении лимита бэкапов сохранение блокируется — удалите старый бэкап через delete_backup.
tmaker_tool
— уровень всего дизайна (конструктор шаблонов / каркас). Один HTML-каркас разворачивается во все шаблоны сайта: шапка, подвал, контейнеры, глобальные блоки, попапы, информеры и настройки дизайна. Нужно право «Доступ к панели управления».
| Action | Что делает | Обязательные параметры |
|---|---|---|
skeleton_guide | Руководство по каркасу: служебные блоки, синтаксис, ограничения. Вызывать первым. | — |
skeleton_rules | Справочник кодов и переменных, допустимых в каркасе. Не придумывайте переменные. | — |
designs_list / design_get | Каталог и содержимое штатных дизайнов uCoz как стартовый каркас. | для get — ID дизайна |
project_list / project_get | Список и содержимое сохранённых снимков каркаса. | для get — project_id |
skeleton_validate | Проверяет каркас без публикации. | код каркаса |
project_save | Сохраняет снимок каркаса без перезаписи активного проекта. | код каркаса |
project_save_active | Сохраняет снимок и помечает его активным; шаблоны сайта ещё не переписываются. | код каркаса |
project_delete | Удаляет снимок. | project_id |
skeleton_archive | Упаковывает каркас в ZIP и возвращает ссылку на скачивание. | код каркаса |
skeleton_publish | Публикует каркас во все шаблоны сайта (перезаписывает их). Требует confirm=true; перед записью — валидация и автобэкап. | код каркаса, confirm=true |
skeleton_publish — безопасность и откат$POWERED_BY$ каркас отклоняется локально.confirm=true публикация не выполняется — инструмент только объясняет последствия.templates_tool → delete_backup.templates_tool → list_backups / restore_backup.pda=1 публикует каркас как мобильную (PDA) версию вместо десктопной.patch_template / update_template после skeleton_publish затираются; обратной синхронизации в каркас нет.Рекомендуемый порядок: skeleton_guide → skeleton_rules → design_get / project_get → skeleton_validate → project_save → skeleton_publish.
ftp_tool
— файлы сайта по FTP и управление FTP-паролем через uAPI. Для ftp_password_* нужно право «Доступ к панели управления» у токена.
| Action | Что делает | Обязательные параметры |
|---|---|---|
list | Показывает файлы и папки по указанному пути. | path |
read | Читает содержимое файла. | path |
write | Записывает текстовый контент в файл. | path, content |
mkdir | Создаёт директорию. | path |
delete | Удаляет файл или папку. | path |
rename | Переименовывает или перемещает файл/папку. | path, new_path |
upload | Загружает локальный файл на FTP. | local_path, remote_path |
ftp_password_get | Настройки FTP-подключения без пароля. | — |
ftp_password_set | Устанавливает пароль впервые (если ещё не задан). | password |
ftp_password_change | Меняет существующий пароль. | password |
ftp_password_reset | Сбрасывает пароль. | — |
modules_tool
— установка модулей, доступ к uAPI, карантин. Большинство действий требуют права «Доступ к панели управления»; исключение — active_mods.
| Action | Что делает | Обязательные параметры |
|---|---|---|
modules_list | Полный каталог модулей с флагами active и api_enabled. | — |
module_status | Статус одного модуля. | module_code |
module_install | Устанавливает модуль. | module_code |
module_uninstall | Удаляет модуль (системные модули защищены). | module_code |
active_mods | Упрощённый список активных модулей. | — |
module_enable_uapi | Включает uAPI-методы модуля. | module_code |
module_disable_uapi | Отключает uAPI-методы модуля. | module_code |
quarantine_status | Проверяет карантин (locked=true — карантин активен). | — |
quarantine_unlock | Снимает карантин с сайта. | — |
skills_tool
— учёт использования официальных скиллов из каталога. В SKILL.md вызов уже прописан — отдельно подключать ничего не нужно.
| Action | Что делает | Параметры |
|---|---|---|
register_usage | Фиксирует, что скилл отработал на текущем сайте. Вызывать один раз после основной работы скилла. | skill_id или skill_path |
read_template (module_id=2, template_id=1) -> читаем текущий шаблон главнойmenu_list -> проверяем существующие менюmenu_create / menu_update_items -> создаём или обновляем навигацию с якорными ссылкамиftp_tool: write /css/style.css -> загружаем стили лендингаftp_tool: write /js/script.js -> загружаем скриптыvalidate_template -> проверяем HTML без сохраненияpatch_template -> сохраняем финальный шаблон (бэкап создаётся автоматически)mail_list_forms -> получаем список форм и e-mail получателейmail_create_form (name, email) -> создаём новую формуmail_add_field × N -> добавляем поля: имя, телефон, сообщениеmail_list_fields -> проверяем порядок и системные имена полей (f1, f2…)mail_get_template -> читаем HTML письмаmail_save_template -> сохраняем обновлённый шаблон письмаpatch_template -> вставляем $MFORM_<ID>$ в нужное место шаблонаftp_tool: list (path="/") -> проверяем наличие папок /css и /jsftp_tool: mkdir /css, /js -> создаём папки если их нетftp_tool: write /css/style.css -> записываем CSSftp_tool: write /js/script.js -> записываем JSread_template -> открываем шаблон для правки подключенийupdate_template -> обновляем версию ?v= в ссылках на файлыlist_backups (module_id, template_id) -> получаем список бэкапов с датамиrestore_backup (backup_id) -> восстанавливаем нужную версию шаблонаread_template -> проверяем, что шаблон восстановлен корректноmenu_list -> получаем ID нужного менюmenu_get (menu_id) -> смотрим текущую структуру пунктовmenu_update_items (menu_id, items) -> заменяем дерево пунктов с новыми URL и вложенностьюpatch_template -> вставляем $SMENU_<ID>$ или $NMENU_<ID>$ в шаблонread_template -> читаем код и копируем фрагмент для заменыvalidate_template (опционально) -> проверяем новый фрагментpatch_template (code_search, code_paste) -> заменяем только нужный блокpage_list -> проверяем существующие страницыpage_add (page_name, page_tmpl) -> создаём страницу с личным HTML ($POWERED_BY$ обязателен в page_tmpl)page_get (page_id) -> проверяем результатquarantine_status -> при необходимости снимаем карантин через quarantine_unlockmodules_list -> смотрим каталог модулейmodule_install (module_code) -> устанавливаем нужные модулиmodule_enable_uapi -> включаем uAPI для модулейftp_password_get -> проверяем FTP; при отсутствии пароля — ftp_password_setquarantine_unlock -> снимаем карантин для индексацииskeleton_guide + skeleton_rules -> читаем правила служебных блоков и переменныхdesign_get / project_get -> берём стартовый каркас, а не пишем вслепуюtemplates_tool: update_template (3/3) -> загружаем CSS в /_st/my.css, в каркасе только ссылкаskeleton_validate -> проверяем каркас без публикацииproject_save -> сохраняем снимок для откатаskeleton_publish (confirm=true) -> публикуем во все шаблоны (автобэкап)templates_tool / ftp_tool / другие toolsskills_tool: register_usage -> фиксирует использование (обычно вызывается самим скиллом)