Подключение MCP uCoz

Управление сайтом uCoz через AI: шаблоны, материалы, магазин, пользователи и файлы

Библиотека MCP скиллов для твоих AI-агентов

Готовые сценарии для Cursor, Claude Code и VS Code: лендинги, магазин, перевод сайта и другие задачи. Подключи скилл — агент сам разберётся, как работать с вашим сайтом.

Открыть каталог

Что такое MCP для uCoz

MCP — способ подключить AI в редакторе к вашему сайту на uCoz. Вместо ручной работы в панели управления вы пишете обычным языком: «обнови шапку», «добавь новость», «создай товар с размерами». Сервер ucoz-mcp открывает десять инструментов: редактирование шаблонов и страниц, публикация материалов, интернет-магазин, подписки, пользователи, FTP и официальные скиллы.

Нужен Node.js 18+. Подключение одной командой: npx ucoz-mcp@latest. Ниже — возможности MCP простыми словами; точные параметры AI увидит сам в Cursor, Claude или ChatGPT (Codex).

Возможности MCP

⚡ Редактирование шаблонов

Изменение HTML шаблонов сайта по частям: правка блоков, проверка кода, автоматическая копия перед сохранением и быстрый откат.

🏗️ Дизайн всего сайта

Сборка общего каркаса дизайна и публикация сразу во все шаблоны — шапка, подвал, страницы модулей и глобальные блоки.

📰 Добавление материалов

Публикация и редактирование новостей, записей блога, статей, объявлений, фото и видео; работа с категориями, комментариями и форумом.

🛒 Интернет-магазин

Создание категорий и товаров, варианты размера и цвета, склад, корзина, оформление заказа, статусы заказов и баланс покупателя.

💳 Платные подписки

Настройка тарифов, выдача и отмена доступа, учёт платежей и проверка, открыт ли платный контент конкретному пользователю.

👥 Управление пользователями

Регистрация и правка аккаунтов, группы доступа, права, звания и дополнительные поля анкеты.

📁 Файлы и FTP

Загрузка и обновление CSS, JavaScript и изображений на сайте, создание папок и смена FTP-пароля без ручного входа в панель.

📦 Модули сайта

Установка нужных модулей uCoz, включение API для модуля и снятие карантина индексации после запуска сайта.

🎯 Готовые AI-скиллы

Подбор сценария из каталога uCoz — лендинг, магазин, перевод и другие задачи — установка в редактор и выполнение по инструкции.

📚 Справка по API

Если деталей не хватает, AI находит нужный раздел в официальной документации OpenAPI на api.ucoz.net.

📬 Меню, формы и страницы

Создание навигации, форм обратной связи с письмами и отдельных страниц сайта — с общим дизайном или личным шаблоном.

🧩 Работа в AI-редакторах

Подключение к сайту uCoz из Cursor, Claude Desktop, ChatGPT (Codex), Google Antigravity и других приложений с поддержкой MCP.

Перед настройкой

1

Установка Node.js

MCP-сервер запускается через npx.

  • Установите Node.js 18+
  • Проверьте: node -v и npx -v
Скачать Node.js
2

Создание uAPI-токена

Панель управления → Сайт → uAPI.

  • Создайте токен и сохраните его
  • Для полноценной работы MCP рекомендуется ключ с правом «Доступ к панели управления» — иначе недоступны конструктор дизайна, установка модулей, смена FTP-пароля и часть действий с подписками
Инструкция по uAPI-токену
3

FTP-доступ

Нужен для файловых действий ftp_tool.

  • Панель → FTP: хост, логин, пароль
  • Активация пароля может занять до 15 минут
  • Пароль также можно задать через ftp_password_set / ftp_password_change
Инструкция по FTP

Подключение по платформам

Cursor
  1. Откройте Customize → MCPs (или Settings → Tools & MCP).
  2. Добавьте сервер через UI либо отредактируйте mcp.json: проект — .cursor/mcp.json, глобально — ~/.cursor/mcp.json.
  3. Вставьте конфиг:
{
	"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-пароль"
			}
		}
	}
}

Опционально: UCOZ_WORKSPACE — корень проекта для установки скиллов. Сохраните и перезапустите MCP в Cursor.

ChatGPT (Codex)

MCP подключается в Codex CLI / агенте ChatGPT через файл ~/.codex/config.toml (или проектный .codex/config.toml). Формат — TOML, не JSON.

  1. Быстрый способ: codex mcp add ucoz-mcp --env UCOZ_API_TOKEN=… --env UCOZ_SITE_URL=… --env UCOZ_FTP_HOST=… --env UCOZ_FTP_USER=… --env UCOZ_FTP_PASS=… -- npx -y ucoz-mcp@latest
  2. Или добавьте блок вручную:
[mcp_servers.ucoz-mcp]
command = "npx"
args = ["-y", "ucoz-mcp@latest"]
startup_timeout_sec = 20

[mcp_servers.ucoz-mcp.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-пароль"

Проверка: codex mcp list. Опционально в env можно добавить UCOZ_WORKSPACE.

Google Antigravity
  1. В панели агента: … → MCP Servers → Manage MCP Servers → View raw config.
  2. Либо откройте файл напрямую: глобально ~/.gemini/config/mcp_config.json, в проекте — .agents/mcp_config.json.
  3. Добавьте блок:
{
	"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 (Refresh). В Antigravity 2.0 серверы также видны в Settings → Customizations → Installed MCP Servers.

Claude Desktop

Добавьте конфиг в claude_desktop_config.json. Удобнее открыть файл через Developer → Edit Config в самом приложении.

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: обычно %APPDATA%\Claude\claude_desktop_config.json (если MCP не подхватывается — откройте конфиг через Edit Config в приложении)
{
	"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-пароль"
			}
		}
	}
}

Сохраните файл и полностью перезапустите Claude Desktop.

Инструменты MCP

Десять инструментов под разные задачи. Нажмите карточку — ниже коротко, за что отвечает каждый. Имена вроде templates_tool нужны AI; вам достаточно понимать смысл.

templates_tool

Правки одного шаблона, меню, формы и страницы

Повседневный дизайн tmaker_tool

Новый дизайн сразу на весь сайт

Конструктор content_tool

Новости, блог, форум, фото и другие разделы

Контент shop_tool

Товары, варианты, склад, корзина и заказы

Магазин subscriptions_tool

Платные тарифы, доступ и платежи

Подписки users_tool

Пользователи, группы и права

Аккаунты ftp_tool

Файлы на сервере и FTP-пароль

Файлы modules_tool

Установить модуль сайта и открыть к нему API

Модули skills_tool

Подобрать и поставить готовый сценарий из каталога

Скиллы docs_tool

Заглянуть в официальную документацию API

Справка
templates_tool Один шаблон за раз. Перед сохранением делается запасная копия. В шаблоне можно вывести меню и форму: $NMENU_<ID>$, $SMENU_<ID>$, $MFORM_<ID>$.
Группа actions Что покрывает
list_modules, get_variables, read_template, patch_template, update_template, validate_templateЧтение и правки. Для существующего кода — только patch_template; update_template — полная перезапись. Переменные берите из API, не выдумывайте.
list_backups, create_backup, delete_backup, restore_backupИстория версий шаблона и откат.
gblock_create, gblock_deleteГлобальные блоки. Удаление: gblock_id + confirm=true.
menu_*Список, CRUD меню и дерево пунктов (menu_update_items).
mail_*Формы, поля, HTML-шаблон письма.
page_*Страницы сайта; в личном page_tmpl обязателен $POWERED_BY$.
get_reference, get_guide, get_backup_guideВстроенные гайды по языку шаблонов и бэкапам.
patch_template — точечные правки
ПараметрОписание
code_searchТочный фрагмент из read_template (побайтно, ровно одно вхождение).
code_pasteЗамена; "" — удалить фрагмент. Нельзя убирать/скрывать $POWERED_BY$.
tmaker_tool Уровень всего дизайна. Один каркас разворачивается во все шаблоны. Нужно право «Доступ к панели управления».
Actions Смысл
skeleton_guide, skeleton_rulesСначала правила служебных блоков и переменных каркаса.
designs_list, design_get, project_*Штатные дизайны и ваши снимки каркаса.
skeleton_validate, skeleton_archiveПроверка без публикации; ZIP-архив каркаса.
skeleton_publishПубликация во все шаблоны. Только с confirm=true после фразы «Да, подтверждаю.»; без $POWERED_BY$ отклоняется.
content_tool Контент модулей сайта. Сначала выбирается модуль (новости, блог…), затем действие: список, создать, изменить и т.д.
Группа Типичные actions
Материалыlist, get, add, update, delete, fields, tags, rate
Категории / альбомы / каналыcategory_*, album_list, channel_*, channel_category_*
Комментарии и фильтрыcomments_*, comments_all, filter_*, smiles
Форумsection_*, topic_*, post_*, poll_*
shop_tool Интернет-магазин: каталог, вариации, склад по опциям, корзина, оформление, заказы, баланс.
Группа Типичные actions
Каталогcategory_*, list/get/add/update/delete/hide, img_*
Вариацииvariation_dict (справочник свойств) → variation_gen (fields с var_*, confirm) → variations_list / variation_*
Склад / корзинаstock_*, basket_*, checkout_*
Заказы и балансinvoices_*, order_*, currencies, balance_*, comments_*
subscriptions_tool Платные подписки и доступ. Admin-действия требуют права «Доступ к панели управления».
Группа Типичные actions
Тарифыplans_*, legacy_item*
Подпискиsubscription_*, user_subscriptions, subscribers_list, access_check
Платежиpayments_*, payment_* (в т.ч. confirm / refund с confirm=true)
users_tool Пользователи сайта, группы и права, ранги, поля профиля.
Группа Типичные actions
Пользователиlist, get, add, register, update, delete, chlogin, chgroup, chpass
Группыgroups / groups_list, group_add/update/delete, groups_rights, group_permissions
Справочникиranks, fields
ftp_tool Файлы через FTP-учётку из env; пароль FTP — через uAPI (нужно право ПУ).
Action Что делает Ключевые параметры
list / mkdir / deleteКаталог, создание папки, удалениеpath; delete — ещё confirm
read / writeЧтение и запись текстового файлаfilepath; write — ещё content
renameПереименование / перемещениеsource, destination
uploadЛокальный файл → FTPlocal_path, remote_path
ftp_password_getПараметры FTP без пароля—
ftp_password_set / changeЗадать или сменить парольftp_password
ftp_password_resetСброс пароляconfirm=true
modules_tool Установка и удаление модулей сайта, включение uAPI и карантин индексации. Для большинства действий нужен доступ к панели управления.
Action Что делает
modules_list / module_status / active_modsКаталог и статусы модулей
module_install / module_uninstallУстановка и удаление (confirm на uninstall)
module_enable_uapi / module_disable_uapiВкл/выкл uAPI-методов модуля
quarantine_status / quarantine_unlockКарантин индексации; unlock с confirm
skills_tool Готовые сценарии из каталога uCoz: AI находит подходящий, ставит его в редактор и выполняет задачу по инструкции.
Что делает Простыми словами
resolveПо вашему запросу подсказывает, какой скилл подойдёт
catalogПоказывает список официальных скиллов
statusПроверяет, установлен ли скилл уже у вас
installСтавит скилл в Cursor, Claude, ChatGPT (Codex) и т.п.
register_usageОтмечает, что скилл успешно отработал на сайте (обычно делает сам скилл)
docs_tool Если AI не хватает деталей, он может поискать ответ в официальной документации API на api.ucoz.net.
Действие Зачем
searchНайти раздел документации по словам запроса
listСписок модулей, по которым есть описание
fetch_specОткрыть конкретный файл документации модуля

Типичные сценарии

1. Лендинг на главной

  1. Прочитать текущий шаблон главной
  2. Настроить меню с якорными ссылками
  3. Загрузить CSS и JS
  4. Внести правки в шаблон (копия сохранится автоматически)

2. Форма обратной связи

  1. Создать форму и добавить поля
  2. Настроить текст письма
  3. Вставить форму в нужное место шаблона

3. Новость или статья

  1. Убедиться, что модуль включён и доступен через API
  2. Создать или отредактировать материал через чат
  3. При необходимости обновить дату изменения материала

4. Товар с размерами и цветами

  1. Задать свойства в справочнике (Размер, Цвет…)
  2. Сгенерировать комбинации для товара
  3. Проверить список вариантов и при необходимости поправить цену или остаток

5. Новый дизайн на весь сайт

  1. Прочитать правила каркаса
  2. Проверить каркас без публикации
  3. Сохранить снимок и опубликовать (после явного подтверждения)

6. Подготовка нового сайта

  1. Включить нужные модули и открыть к ним API
  2. Проверить или задать FTP-пароль
  3. Снять карантин индексации, если сайт готов к поиску

7. Работа через скилл из каталога

  1. Попросить AI подобрать скилл под задачу
  2. Установить его, если ещё не стоит
  3. Выполнить задачу по инструкции скилла

8. Откат шаблона

  1. Посмотреть сохранённые копии
  2. Восстановить нужную версию
  3. Проверить, что на сайте всё выглядит как раньше

9. Создание страницы со своим шаблоном

  1. Посмотреть список существующих страниц
  2. Создать страницу с названием, текстом и личным HTML-шаблоном
  3. Проверить страницу на сайте и при необходимости снять карантин индексации

10. Создание меню сайта

  1. Посмотреть, какие меню уже есть
  2. Создать горизонтальное или вертикальное меню и заполнить пункты со ссылками
  3. Вставить вывод меню в шаблон (шапка, подвал или боковая колонка)

11. Правка шаблона раздела

  1. Открыть нужный шаблон модуля и список допустимых переменных
  2. Скопировать фрагмент для замены и внести точечную правку
  3. Проверить результат; при ошибке — откатиться к сохранённой копии

12. Тариф подписки и доступ

  1. Создать или обновить тарифный план
  2. Выдать подписку пользователю на нужный срок
  3. Проверить, что доступ к платному контенту открыт