Respira for WordPress

Что это за репозиторий и чем он не является

Этот репозиторий — публичный листинг для MCP-сервера Respira для WordPress. Исходный код сервера поставляется на npm как @respira/wordpress-mcp-server. Этот код-обёртка распространяется по лицензии MIT, и вы можете читать, форкать или использовать его.

Сервер — это клиент для плагина Respira для WordPress, а не самостоятельный продукт. Для реальной работы ему нужны:

• Плагин Respira for WordPress, установленный на вашем сайте

• Действительный API-ключ Respira, привязанный к лицензии

Плагин не является открытым исходным кодом. Он распространяется по коммерческой лицензии. Бесплатная пробная версия на respira.press, без необходимости вводить карту. Платные тарифы начинаются от 9 евро в месяц.

Короче говоря: обёртка, которую вы запускаете через npx -y, открыта. Продукт за ней — нет, и это осознанное решение. Если вам нужен автономный стек «ИИ редактирует WordPress» без коммерческой зависимости, это не он. Плагин разрабатывается и поддерживается одним человеком на полную ставку, и лицензионные сборы — это то, как это происходит.

Для сообщений об уязвимостях см. SECURITY.md.

Related MCP server: elementor-mcp-agent

Что делает Respira особенным

Большинство MCP-серверов для WordPress оборачивают REST API. Они могут создавать записи и страницы, но не могут касаться контента конструкторов страниц, где на самом деле живёт сайт.

Respira поставляет плагин WordPress, который даёт ИИ-агенту нативный доступ к собственным структурам данных конструктора, а также защитные механизмы, которые делают запись на живой сайт безопасной.

Быстрый старт

1. Установите плагин WordPress

Скачайте с respira.press/plugin, загрузите в WordPress, активируйте, затем перейдите в Respira > API Keys и создайте ключ.

2. Подключите ваш ИИ-инструмент

Самый быстрый путь — сгенерированная команда на respira.press/dashboard/mcp, которая автоматически заполняет ваш сайт и ключ. Ручные настройки ниже.

claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

Создайте .cursor/mcp.json в вашем проекте:

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

Та же структура, что и выше. Codex использует TOML в ~/.codex/config.toml:

[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]

Или позвольте add-mcp определить ваш инструмент:

npx add-mcp "npx -y @respira/wordpress-mcp-server"

Respira также работает как размещённый удалённый MCP-сервер с OAuth, поэтому локальный процесс Node не требуется. Инструкции по настройке для каждого клиента находятся на respira.press/mcp.

3. Добавьте ваш сайт

Запустите мастер:

npx @respira/wordpress-mcp-server --setup

Или напишите ~/.respira/config.json самостоятельно:

{
  "sites": [
    {
      "id": "my-site",
      "name": "My WordPress Site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true
    }
  ]
}

Перезапустите ваш ИИ-инструмент и начинайте редактирование.

Достигнут лимит инструментов клиента?

Некоторые MCP-клиенты ограничивают количество активных инструментов, часто до 100. Respira рекламирует гораздо больше, поэтому добавьте enabledTools в вашу конфигурацию, и в списке появятся только они:

{
  "sites": [{ "...": "..." }],
  "preferences": {
    "enabledTools": [
      "respira_read_page",
      "respira_update_page",
      "respira_list_pages",
      "respira_find_element",
      "respira_update_element",
      "respira_build_page",
      "respira_get_site_context",
      "respira_get_builder_info"
    ]
  }
}

Инструменты управления сайтом (respira_list_sites, respira_switch_site, respira_get_active_site) всегда включены. Неперечисленные инструменты по-прежнему работают при прямом вызове. Фильтр управляет только тем, что рекламируется.

Кроме того, сервер фильтрует список инструментов по тому, что реально запущено на вашем сайте. Сайт на Divi без WooCommerce не видит инструменты коммерции. Определение работает по принципу «открытого сбоя»: если не удаётся определить, вы получаете полный список.

17 поддерживаемых конструкторов страниц

level — это глубина записи Respira, а не качество конструктора.

Сайты со смешанными конструкторами обрабатываются постранично, а не по сайту.

Что охватывают инструменты

Полный справочник находится в документации. Семейства:

Все инструменты используют имена respira_*. Устаревшие псевдонимы wordpress_* объявлены устаревшими и будут удалены.

Что означают числа

Числа на этой странице описывают каталог на полностью включённом сайте, а не то, что увидит ваш клиент.

Живой tools/list возвращает меньше 319, и это правильное поведение, а не отсутствующая функция. Сервер фильтрует каталог по контексту для каждого сайта, поэтому инструменты Bricks никогда не попадают на сайт Elementor, а коммерческие инструменты остаются скрытыми без WooCommerce. Сайт с блочной темой без конструктора страниц видит примерно на 28 меньше основных инструментов.

Реестр возможностей не фильтруется по контексту, поэтому на одном и том же сайте общее количество возможностей законно превышает общее количество инструментов. Они не сопоставимы напрямую.

Встроенные навыки

Пакет включает навыки Respira для Claude Code — это рецепты, которые делают инструменты полезными вместе: миграции конструкторов страниц (Divi в Bricks, Elementor в Gutenberg, WPBakery в Bricks и другие), конвертация Figma в конструктор, аудиты сайтов, проходы SEO и AEO, а также рабочие процессы WooCommerce.

npx @respira/wordpress-mcp-server install-skills

Просмотрите каталог на respira.press/skills.

Безопасность

Запись на живой производственный сайт — это вся проблема. Ограничения:

1. Снимок перед каждой мутацией. Восстановление с помощью respira_restore_snapshot, сравнение с помощью respira_diff_snapshots.

2. Дублирование перед редактированием. Оригинал остаётся нетронутым, пока агент работает с копией.

3. Управление по каждому инструменту. Администраторы могут включать или отключать отдельные инструменты из wp-admin. Управление применяется одинаково к REST-пути, пути API возможностей и WebMCP.

4. Режим только для чтения. Направьте агента на сайт и позвольте ему смотреть, не позволяя писать.

5. Журнал активности. Каждый вызов записывается и доступен для чтения из wp-admin и из respira_list_activity.

Экосистема ИИ WordPress

Respira работает с официальным стеком ИИ WordPress, а не в обход него.

Inhale — это бесплатный сопутствующий плагин, который регистрирует небольшой набор возможностей вообще без учётной записи Respira, если вы хотите попробовать путь возможностей раньше всего остального.

Варианты установки

npx

npx -y @respira/wordpress-mcp-server

Нулевая установка, хорошо для ознакомления. Недостаток в том, что кэш npx может повредиться после прерванной установки, отключённого внешнего диска или карантина антивируса, и возникающие ошибки ENOENT сбивают с толку. См. раздел «Устранение неполадок».

Глобальная установка (самая стабильная)

npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp

Полностью избегает кэша npx. Лучший выбор для повседневного использования.

Параметры командной строки

Переменные окружения

export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"

RESPIRA_CONFIG_FILE и RESPIRA_CONFIG_B64 — это альтернативы для мультисайта.

Проверка состояния

npx @respira/wordpress-mcp-server --doctor

Проверяет версию Node, файл конфигурации, связь с сайтом, версию плагина, совместимость API и доступные обновления, и сообщает о прохождении или провале каждой проверки с указанием, что можно предпринять. Добавьте --json для конвейеров CI.

Устранение неполадок

Используйте полный путь:

{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }

Или установите глобально с помощью npm install -g @respira/wordpress-mcp-server и используйте { "command": "respira-wordpress-mcp" }.

1. Проверьте API-ключ в WordPress > Respira > API Keys

2. URL должен содержать https://

3. Плагин должен быть активирован

4. Проверьте, не блокирует ли ваш хостинг REST API

respira_diagnose_connection сообщает обо всех четырёх за один вызов.

На некоторых сайтах есть правила перезаписи плагина или темы, которые перехватывают /wp-json/[anything] и переписывают путь на index.php без переменной запроса ?rest_route=. Затем WordPress выполняет 301-редирект на главную страницу (вы увидите x-redirect-by: WordPress в цепочке), и MCP-сервер получает HTML там, где ожидал JSON.

Сервер автоматически обнаруживает это, повторяет вызов как ?rest_route=... к корню сайта, и если это возвращает JSON, он направляет все последующие вызовы тем же способом до конца сеанса, с одним предупреждением в stderr при первой активации.

Если вы уже знаете, что действует перезапись, пропустите проверку с помощью forceRestRoute:

{
  "sites": [
    {
      "id": "my-site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true,
      "forceRestRoute": true
    }
  ]
}

respira_diagnose_connection проверяет обе формы и сообщает rest_route_fallback_worked, rest_route_fallback_active и force_rest_route_configured.

1. Полностью перезапустите ИИ-инструмент, а не только окно

2. Проверьте синтаксис JSON в файле конфигурации

3. Подтвердите расположение файла конфигурации для вашего клиента

4. Запустите npx @respira/wordpress-mcp-server --test

Если клиент ограничивает активные инструменты, см. enabledTools выше.

Кэш npx повреждён. Распространённые причины: прерванная установка, отключение внешнего диска во время установки, карантин антивируса или npm cache clean, запущенный во время активности npx.

# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper

# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server

# 3. Or clear the whole npm cache
npm cache clean --force

Безопасность

Проверка API-ключа происходит на стороне сервера в плагине WordPress. MCP-сервер передаёт учётные данные и не хранит и не проверяет их.

Сообщайте об уязвимостях на security@respira.press. Полная политика в SECURITY.md.

Ссылки

• Веб-сайт

• Документация

• Скачать плагин

• Настройка MCP

• Каталог навыков

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

• Дополнение WooCommerce

• Дополнение сканера доступности

• Поддержка

Где найти Respira

Лицензия

MIT © Respira