Royal MCP

Безопасный в первую очередь MCP-сервер для WordPress. Подключите Claude, ChatGPT и Gemini к вашему сайту на WordPress с аутентификацией по API-ключу + OAuth 2.1, полным журналом активности и доступом, ограниченным по правам.

Скачать на WordPress.org · Документация · Royal Plugins

Плагин для WordPress, который превращает ваш сайт в сервер Model Context Protocol. ИИ-агенты — Claude.ai web, Claude Desktop, ChatGPT, пользовательские клиенты — могут читать и записывать записи, страницы, медиафайлы, пользователей, меню, заказы WooCommerce и страницы Elementor, при этом каждый вызов проходит через ограничение прав, ограничение частоты запросов и журнал аудита. Распространяется через официальный каталог плагинов WordPress.org.

Краткие факты

Related MCP server: wp-mcp

Возможности

Ядро WordPress (84 инструмента, всегда доступны)

• Контент — Записи, страницы, произвольные типы записей (полный CRUD + ревизии + изображения записей)

• Таксономии — Рубрики, метки, произвольные таксономии, метаданные терминов, связывание записей с терминами

• Медиафайлы — Просмотр, загрузка (по URL или base64), обновление метаданных, удаление

• Комментарии — Создание, модерация (одобрить / спам / корзина)

• Пользователи — Чтение отображаемых имён + ролей (адреса электронной почты и имена пользователей не раскрываются)

• Меню — Чтение, создание элементов, изменение порядка, обновление с защитой от деструктивных записей

• Тема — Пользовательский CSS, параметры темы, определение активной темы

• Сайт — Структура постоянных ссылок, параметры (из белого списка), информация о сайте

• Поиск — Поиск по всему контенту по запросу

• SEO — Чтение/запись метаданных Yoast / Rank Math / AIOSEO, если соответствующий плагин активен

• Диагностика — Статус сайта (WP/PHP/MySQL/плагины/темы/cron одним вызовом), хвост журнала ошибок PHP, расписание WP cron и MCP royal_mcp_connection_health (возвращает маршрут, метод аутентификации, ID сессии, версию плагина и активные версии конструкторов страниц для Divi + Elementor + Gutenberg)

Интеграции с плагинами (80 инструментов, условные)

Автоматически регистрируются только когда интегрированный плагин активен.

Мост WordPress Abilities API (WP 6.9+)

WordPress 6.9 выпустил Abilities API — примитив, позволяющий плагинам регистрировать типизированные возможности, которые могут вызывать ИИ-агенты. Начиная с версии 1.4.38, каждый инструмент Royal MCP также регистрируется как способность WordPress, что даёт вам три способа доступа к одним и тем же обработчикам:

1. Нативный — конечная точка Streamable HTTP /wp-json/royal-mcp/v1/mcp от Royal MCP (без изменений, всегда доступна).

2. WP MCP Adapter — если установлен пакет wordpress/mcp-adapter, Royal MCP регистрирует именованный royal-mcp-server на хуке mcp_adapter_init рядом с сервером адаптера по умолчанию.

3. Ядро WP REST — прямой вызов возможности по адресу /wp-json/wp-abilities/v1/abilities/{name}/run для клиентов, предпочитающих конечную точку ядра WP.

Одни и те же обработчики, три транспорта, один набор ограничений прав для каждого инструмента. Мост можно отключить с помощью опции royal_mcp_abilities_registration_enabled (по умолчанию: включено).

Что мы не делаем

Явные границы области действия — модель интеграции — это «узкие инструменты, которые работают надёжно», а не «раскрыть всю поверхность API».

• Никакой генерации виджетов Elementor с нуля. Атомарные виджеты (Editor V4) проходят как непрозрачные; мы никогда не декодируем атомарные схемы, потому что Elementor сам может их менять.

• Никакой записи JSON конструкторов страниц Beaver Builder / Bricks. Стандартный контент записей доступен для чтения и записи; JSON-хранилище конструкторов страниц непрозрачно, если не покрыто специальным инструментом. (Для Elementor и Divi есть специальные инструменты — см. таблицу интеграций выше.)

• Никакого создания шаблонов конструктора тем (Elementor или иного).

• Никаких изменений файлов ядра — Royal MCP никогда не записывает в wp-content/themes, wp-includes или wp-admin.

• Никакой установки или обновления плагинов через MCP. Обнаружение — да; установка/активация/деактивация — нет.

• Никакого сырого SQL. Запросы проходят только через WP_Query и $wpdb->prepare().

Royal MCP Pro (платный)

Бесплатный плагин полностью функционален для отдельных владельцев сайтов. Royal MCP Pro расширяет его для агентств и операторов многосайтовых установок:

• Пакет Divi Pro — клонирование страниц, замена изображений, импорт шаблонов, полный CRUD библиотеки, мигратор D4→D5, массовое применение глобальных пресетов (8 инструментов)

• Глубина Elementor Pro — дополнительные инструменты Elementor помимо интеграции Free

• Универсальный журнал аудита — каждая операция ИИ записывается с атрибуцией + экспортом

• Отмена на 72 часа для каждой записи — каждый деструктивный инструмент Pro возвращает токен отмены; отмените любую операцию в течение этого окна

• Обновления, ограниченные лицензией через стандартный обновлятор WordPress — без зависимостей от внешних лицензионных серверов во время выполнения

Узнайте больше на royalplugins.com/royal-mcp-pro

Подключение

Установка

1. Установите с WordPress.org (рекомендуется — автообновления через админ-панель WP) или загрузите ZIP-архив релиза с GitHub.

2. Royal MCP → Настройки → нажмите Сгенерировать API-ключ.

3. Выберите клиент ниже.

Claude.ai web (OAuth — рекомендуется)

Самый простой путь — без правки файлов конфигурации, без API-ключа в вашем клиенте.

1. В Claude.ai → Настройки → Коннекторы → Добавить пользовательский коннектор.

2. URL: https://yoursite.com/wp-json/royal-mcp/v1/mcp

3. Подтвердите экран согласия OAuth при появлении запроса. Claude.ai обрабатывает динамическую регистрацию клиента + поток PKCE на вашем сайте.

Claude Desktop (однокликовый пакет .mcpb — новинка в 1.4.38)

Самый простой путь для Claude Desktop — без mcp-remote, без npx, без правки файлов конфигурации.

1. Скачайте royal-mcp-1.4.38.mcpb из последнего релиза на GitHub.

2. Дважды щёлкните файл .mcpb — Claude Desktop откроет запрос на установку.

3. Введите URL вашего сайта + API-ключ при появлении запроса. Соединение установлено.

Пакет включает мост stdio-to-HTTPS без зависимостей на Node ≥18, который уже входит в состав Claude Desktop. См. Claude Desktop MCP Bundles для спецификации .mcpb.

Claude Desktop (OAuth через mcp-remote)

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://yoursite.com/wp-json/royal-mcp/v1/mcp"]
    }
  }
}

Config path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Claude Desktop (API-ключ)

Пропустите OAuth и аутентифицируйтесь через заголовок:

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://yoursite.com/wp-json/royal-mcp/v1/mcp",
        "--header", "X-Royal-MCP-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

ChatGPT

Пользовательский MCP-коннектор ChatGPT использует тот же URL, что и Claude.ai web. Следуйте процессу коннектора ChatGPT и вставьте https://yoursite.com/wp-json/royal-mcp/v1/mcp.

Сырой HTTP (пользовательские клиенты)

# 1. Initialize a session. -i prints headers so you can grab Mcp-Session-Id.
curl -i -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "id": 1,
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "my-app", "version": "1.0"}
    }
  }'

# 2. List available tools using the session id from the response header.
curl -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Mcp-Session-Id: <session_id>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 2}'

Модель безопасности

Полная архитектура безопасности: royalplugins.com/support/royal-mcp/

Статус проекта

• Активная поддержка — релизы примерно еженедельно. См. релизы для журнала изменений.

• Соответствие спецификации MCP — реализует Streamable HTTP transport (2025-11-25).

• Проблемы — github.com/royalplugins/royal-mcp/issues. Проблемы, влияющие на клиентов, обычно подтверждаются в течение 24 часов и обрабатываются с указанием целевых версий.

• Вклад — приветствуются PR. Исходный код плагина размещён как в этом репозитории, так и в SVN-стволе wp.org; релизы координируются через процесс рецензирования wp.org.

Дополнительное чтение

• Редактирование Elementor с помощью Claude: четыре рабочих процесса, которые работают сегодня — четыре реальные архитектуры для ИИ-редактирования страниц Elementor и когда какую использовать. Версия для пользователей с подсказками, примерами и видеодемонстрацией процесса клонирования и настройки.

• Редактирование Elementor с помощью Claude: 4 архитектуры MCP — инженерная версия на Hashnode. PHP под капотом elementor_clone_page, шесть сигнатур инструментов и компромисс между моделями аутентификации HTTP-Basic и OAuth-2.1.

Связанные проекты

• GuardPress — укрепление безопасности WordPress

• SiteVault — резервное копирование и миграция WordPress

• ForgeCache — кэширование и производительность

• FormForge — конструктор форм с генерацией PDF

• SEObolt — SEO-инструментарий для WordPress

Лицензия

GPLv2 или более поздняя версия — см. LICENSE или сайт GNU.

Royal MCP предоставляется как есть. API-ключи защищают ваши конечные точки; берегите их как любые другие учётные данные. Вы несёте ответственность за контент, команды и действия, которые любой ИИ-платформе разрешено выполнять на вашем сайте WordPress.