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

Управление шаблонами и FTP через AI-инструменты

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

MCP (Model Context Protocol) для uCoz — сервер инструментов, который подключается к AI-ассистенту и даёт ему прямой доступ к сайту. Через обычные текстовые запросы можно редактировать шаблоны, управлять меню и глобальными блоками, создавать почтовые формы и работать с FTP-файлами.

Сейчас MCP uCoz находится в стадии альфа-тестирования. Для работы требуется установленный Node.js 20+, так как сервер запускается через npx ucoz-mcp@latest.

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

⚡ Быстрее в разы

Обновляйте шаблоны сайта за минуты — без ручного редактирования в панели управления.

🛡️ Встроенный бэкап

Автоматический бэкап перед каждым сохранением и быстрый откат к предыдущей версии.

✅ Валидация кода

Проверка HTML-кода шаблона перед сохранением без риска сломать отображение сайта.

📁 Загрузка файлов по FTP

Загружайте CSS, JS и изображения с локального проекта или прямо из чата агента.

🗂️ Меню через API

Создавайте и обновляйте меню через AI — горизонтальные и вертикальные, с вложенностью.

📬 Почтовые формы

Создание форм обратной связи с нужными полями и шаблоном письма прямо из чата.

🧩 Любой MCP-клиент

Поддержка Cursor, Codex, Antigravity и любых других stdio-совместимых MCP-клиентов.

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

1

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

Для работы MCP требуется установленный Node.js, так как сервер запускается через npx.

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

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

Для работы с API необходимо создать персональный токен доступа.

  • Перейдите в панель управления сайта -> Сайт -> uAPI
  • Создайте новый токен и сохраните его
  • Используйте этот токен в настройках MCP
Инструкция по созданию uAPI-токена
3

Получение FTP-доступа

Для работы с файлами сайта через MCP потребуется FTP-доступ.

  • Перейдите в панель управления -> FTP
  • Создайте FTP-пароль (если ещё не создан)
  • Сохраните данные: хост, логин и пароль
  • Активация пароля может занять до 15 минут
Инструкция по подключению FTP

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

Cursor
  1. Откройте Settings -> MCP -> Add new MCP server.
  2. Вставьте в конфиг следующий блок:
{
  "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-сервер в настройках.

Codex
  1. Откройте Settings -> MCP -> Add new MCP server.
  2. Тип сервера: STDIO.
  3. Команда: npx.
  4. Аргументы: -y, ucoz-mcp@latest.
  5. Добавьте переменные окружения:
  • UCOZ_API_TOKEN — ваш uAPI-токен.
  • UCOZ_SITE_URL — адрес сайта.
  • UCOZ_FTP_HOST — FTP-хост.
  • UCOZ_FTP_USER — FTP-логин.
  • UCOZ_FTP_PASS — FTP-пароль.

Сохраните настройки и перезапустите MCP-сервер.

Antigravity
  1. Откройте Agent Manager -> меню ... в правом верхнем углу.
  2. Выберите MCP Servers -> Manage MCP Servers -> View raw config.
  3. Откроется файл 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

Добавьте тот же блок в claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %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-пароль"
      }
    }
  }
}

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

templates_tool — основной инструмент для работы с шаблонами страниц, глобальными блоками, меню сайта, почтовыми формами и бэкапами. Все изменения шаблонов проходят через него с автоматическим созданием бэкапа.
Action Что делает Обязательные параметры
list_modulesВозвращает список модулей и ID шаблонов.—
get_variablesПоказывает переменные для выбранного модуля/шаблона.module_id, template_id
read_templateЧитает текущий HTML-код шаблона.module_id, template_id
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
get_referenceСправочник переменных языка шаблонов.—
get_guideРуководство по архитектуре шаблонов.—
get_backup_guideРуководство по безопасной работе с бэкапами.—
ftp_tool — инструмент для работы с файлами сайта по FTP: загрузка CSS, JS, изображений и других ресурсов, создание папок, чтение и перезапись файлов напрямую из чата агента.
Action Что делает Обязательные параметры
listПоказывает файлы и папки по указанному пути.path
readЧитает содержимое файла.path
writeЗаписывает текстовый контент в файл.path, content
mkdirСоздаёт директорию.path
deleteУдаляет файл или папку.path
renameПереименовывает или перемещает файл/папку.path, new_path
uploadЗагружает локальный файл на FTP.local_path, remote_path

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

1. Создание лендинга на главной странице

  1. read_template (module_id=2, template_id=1) -> читаем текущий шаблон главной
  2. menu_list -> проверяем существующие меню
  3. menu_create / menu_update_items -> создаём или обновляем навигацию с якорными ссылками
  4. ftp_tool: write /css/style.css -> загружаем стили лендинга
  5. ftp_tool: write /js/script.js -> загружаем скрипты
  6. validate_template -> проверяем HTML без сохранения
  7. update_template -> сохраняем финальный шаблон (бэкап создаётся автоматически)

2. Добавление почтовой формы на сайт

  1. mail_list_forms -> получаем список форм и e-mail получателей
  2. mail_create_form (name, email) -> создаём новую форму
  3. mail_add_field × N -> добавляем поля: имя, телефон, сообщение
  4. mail_list_fields -> проверяем порядок и системные имена полей (f1, f2…)
  5. mail_get_template -> читаем HTML письма
  6. mail_save_template -> сохраняем обновлённый шаблон письма
  7. update_template -> вставляем $MFORM_<ID>$ в нужное место шаблона

3. Загрузка и обновление CSS/JS через FTP

  1. ftp_tool: list (path="/") -> проверяем наличие папок /css и /js
  2. ftp_tool: mkdir /css, /js -> создаём папки если их нет
  3. ftp_tool: write /css/style.css -> записываем CSS
  4. ftp_tool: write /js/script.js -> записываем JS
  5. read_template -> открываем шаблон для правки подключений
  6. update_template -> обновляем версию ?v= в ссылках на файлы

4. Откат шаблона к предыдущей версии

  1. list_backups (module_id, template_id) -> получаем список бэкапов с датами
  2. restore_backup (backup_id) -> восстанавливаем нужную версию шаблона
  3. read_template -> проверяем, что шаблон восстановлен корректно

5. Обновление навигационного меню

  1. menu_list -> получаем ID нужного меню
  2. menu_get (menu_id) -> смотрим текущую структуру пунктов
  3. menu_update_items (menu_id, items) -> заменяем дерево пунктов с новыми URL и вложенностью