Respira for WordPress

Was dieses Repository ist und was nicht

Dieses Repository ist die öffentliche Auflistung für den Respira WordPress MCP-Server. Der Server-Quellcode wird auf npm als @respira/wordpress-mcp-server ausgeliefert. Dieser Wrapper-Code ist MIT-lizenziert und Sie können ihn gerne lesen, forken oder übernehmen.

Der Server ist ein Client für das Respira WordPress-Plugin, kein eigenständiges Produkt. Für echte Arbeit benötigt er:

• Das Respira for WordPress-Plugin, das auf Ihrer Website installiert ist

• Einen gültigen Respira-API-Schlüssel, der an eine Lizenz gebunden ist

Das Plugin ist nicht Open Source. Es wird unter einer kommerziellen Lizenz vertrieben. Kostenlose Testversion unter respira.press, keine Karte erforderlich. Bezahlte Pläne beginnen bei 9 EUR pro Monat.

Kurz gesagt: Der Wrapper, den Sie mit npx -y ausführen, ist offen. Das Produkt dahinter ist es nicht, und das ist beabsichtigt. Wenn Sie einen eigenständigen Stack „AI bearbeitet WordPress“ ohne kommerzielle Abhängigkeit möchten, ist dies nicht der richtige. Das Plugin wird von einer Person in Vollzeit entwickelt und gepflegt, und die Lizenzgebühren sind der Weg, wie das funktioniert.

Für Sicherheitsmeldungen siehe SECURITY.md.

Related MCP server: elementor-mcp-agent

Was Respira anders macht

Die meisten WordPress-MCP-Server kapseln die REST-API. Sie können Beiträge und Seiten erstellen, aber sie können nicht auf Page-Builder-Inhalte zugreifen, wo die eigentliche Website lebt.

Respira liefert ein WordPress-Plugin, das einem KI-Agenten nativen Zugriff auf die eigenen Datenstrukturen des Builders sowie die Sicherheitsvorkehrungen bietet, die das Schreiben auf einer Live-Website überlebensfähig machen.

Schnellstart

1. WordPress-Plugin installieren

Laden Sie es von respira.press/plugin herunter, laden Sie es in WordPress hoch, aktivieren Sie es und gehen Sie dann zu Respira > API-Schlüssel und generieren Sie einen Schlüssel.

2. Verbinden Sie Ihr KI-Tool

Der schnellste Weg ist der generierte Befehl unter respira.press/dashboard/mcp, der Ihre Website und Ihren Schlüssel für Sie ausfüllt. Manuelle Konfigurationen unten.

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

Fügen Sie zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

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

Erstellen Sie .cursor/mcp.json in Ihrem Projekt:

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

Gleiche Form wie oben. Codex verwendet TOML in ~/.codex/config.toml:

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

Oder lassen Sie add-mcp Ihr Tool erkennen:

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

Respira läuft auch als gehosteter Remote-MCP-Server mit OAuth, sodass kein lokaler Node-Prozess erforderlich ist. Einrichtungsanweisungen pro Client finden Sie unter respira.press/mcp.

3. Fügen Sie Ihre Website hinzu

Führen Sie den Assistenten aus:

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

Oder schreiben Sie ~/.respira/config.json selbst:

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

Starten Sie Ihr KI-Tool neu und beginnen Sie mit der Bearbeitung.

Stoßen Sie an ein Client-Tool-Limit?

Einige MCP-Clients begrenzen die Anzahl der aktiven Tools, oft auf 100. Respira bewirbt weit mehr als das. Fügen Sie daher enabledTools zu Ihrer Konfiguration hinzu, und nur diese erscheinen in der Auflistung:

{
  "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"
    ]
  }
}

Site-Verwaltungstools (respira_list_sites, respira_switch_site, respira_get_active_site) sind immer enthalten. Nicht aufgeführte Tools funktionieren weiterhin, wenn sie direkt aufgerufen werden. Der Filter steuert nur, was beworben wird.

Darüber hinaus filtert der Server die Tool-Liste nach dem, was Ihre Website tatsächlich ausführt. Eine Divi-Website ohne WooCommerce sieht die Commerce-Tools nicht. Die Erkennung schlägt offen fehl: Wenn sie es nicht feststellen kann, erhalten Sie die vollständige Liste.

17 unterstützte Page-Builder

level ist Respiras Schreibtiefe, nicht die Qualität des Builders.

Websites mit gemischten Buildern werden pro Seite behandelt, nicht pro Website.

Was die Tools abdecken

Die vollständige Referenz finden Sie in der Dokumentation. Die Familien:

Alle Tools verwenden respira_*-Namen. Die veralteten wordpress_*-Aliasse sind veraltet und werden entfernt.

Was die Zahlen bedeuten

Die Zahlen auf dieser Seite beschreiben den Katalog auf einer vollständig aktivierten Site, nicht das, was Ihr Kunde auflisten wird.

Ein live tools/list gibt weniger als 319 zurück, und das ist korrektes Verhalten und keine fehlende Funktion. Der Server filtert den Katalog kontextabhängig pro Site, sodass Bricks-Tools eine Elementor-Site nie erreichen und die Commerce-Tools ohne WooCommerce verborgen bleiben. Eine Block-Theme-Site ohne Page Builder sieht etwa 28 weniger Kern-Tools.

Das Abilities-Register ist nicht kontextgefiltert, daher übersteigt die Abilities-Gesamtzahl auf derselben Site legitimerweise die Tool-Gesamtzahl. Die beiden sind nicht direkt vergleichbar.

Gebündelte Skills

Das Paket enthält Respiras Claude-Code-Skills, die Rezepte, die die Tools sinnvoll zusammenarbeiten lassen: Page-Builder-Migrationen (Divi zu Bricks, Elementor zu Gutenberg, WPBakery zu Bricks und andere), Figma-zu-Builder-Konvertierung, Site-Audits, SEO- und AEO-Durchläufe sowie WooCommerce-Workflows.

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

Durchsuchen Sie den Katalog unter respira.press/skills.

Sicherheit

Das Schreiben auf eine Live-Produktionssite ist das eigentliche Problem. Die Leitplanken:

1. Schnappschuss vor jeder Mutation. Wiederherstellen mit respira_restore_snapshot, vergleichen mit respira_diff_snapshots.

2. Vor dem Bearbeiten duplizieren. Das Original bleibt unberührt, während der Agent an einer Kopie arbeitet.

3. Governance pro Tool. Administratoren aktivieren oder deaktivieren einzelne Tools über wp-admin. Governance gilt gleichermaßen für den REST-Pfad, den Abilities-API-Pfad und WebMCP.

4. Nur-Lese-Modus. Einen Agenten auf eine Site richten und ihn schauen lassen, ohne schreiben zu lassen.

5. Aktivitätsprotokoll. Jeder Aufruf wird aufgezeichnet und ist über wp-admin und über respira_list_activity lesbar.

WordPress-KI-Ökosystem

Respira arbeitet mit dem offiziellen WordPress-KI-Stack, nicht daran vorbei.

Inhale ist das kostenlose Begleit-Plugin, das eine kleine Reihe von Abilities ganz ohne Respira-Konto registriert, falls Sie den Abilities-Pfad zuerst ausprobieren möchten.

Installationsoptionen

npx

npx -y @respira/wordpress-mcp-server

Null-Installation, gut zum Ausprobieren. Der Nachteil: Der npx-Cache kann sich nach einer unterbrochenen Installation, einer getrennten externen Festplatte oder einer Antiviren-Quarantäne selbst beschädigen, und die daraus resultierenden ENOENT-Fehler sind verwirrend. Siehe Fehlerbehebung.

Globale Installation (am stabilsten)

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

Umgeht den npx-Cache vollständig. Die bessere Wahl für den täglichen Gebrauch.

CLI-Optionen

Umgebungsvariablen

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

RESPIRA_CONFIG_FILE und RESPIRA_CONFIG_B64 sind die Multi-Site-Alternativen.

Gesundheitscheck

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

Prüft Node-Version, Konfigurationsdatei, Site-Konnektivität, Plugin-Version, API-Kompatibilität und verfügbare Updates und meldet pro Prüfung bestanden oder nicht bestanden, mit etwas, auf das Sie reagieren können. Fügen Sie --json für CI-Pipelines hinzu.

Fehlerbehebung

Verwenden Sie den vollständigen Pfad:

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

Oder installieren Sie global mit npm install -g @respira/wordpress-mcp-server und verwenden Sie { "command": "respira-wordpress-mcp" }.

1. Prüfen Sie den API-Schlüssel unter WordPress > Respira > API Keys

2. Die URL muss https:// enthalten

3. Das Plugin muss aktiviert sein

4. Prüfen Sie, ob Ihr Host die REST-API blockiert

respira_diagnose_connection meldet alle vier in einem Aufruf.

Einige Sites haben Plugin- oder Theme-Rewrite-Regeln, die /wp-json/[beliebiges] abfangen und den Pfad ohne die ?rest_route=-Query-Variable auf index.php umschreiben. WordPress leitet dann per 301 auf die Homepage weiter (Sie sehen x-redirect-by: WordPress in der Kette) und der MCP-Server erhält HTML, wo er JSON erwartet hat.

Der Server erkennt dies automatisch, wiederholt den Aufruf als ?rest_route=... gegen die Site-Root, und wenn das JSON zurückgibt, leitet er jeden weiteren Aufruf für den Rest der Sitzung auf dieselbe Weise, mit einer stderr-Warnung bei der ersten Aktivierung.

Wenn Sie bereits wissen, dass das Rewrite-Shadowing im Spiel ist, überspringen Sie die Prüfung mit forceRestRoute:

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

respira_diagnose_connection prüft beide Formen und meldet rest_route_fallback_worked, rest_route_fallback_active und force_rest_route_configured.

1. Starten Sie das KI-Tool vollständig neu, nicht nur das Fenster

2. Validieren Sie die JSON-Syntax in der Konfigurationsdatei

3. Bestätigen Sie den Speicherort der Konfigurationsdatei für Ihren Client

4. Führen Sie npx @respira/wordpress-mcp-server --test aus

Wenn der Client aktive Tools begrenzt, siehe enabledTools oben.

Der npx-Cache ist beschädigt. Häufige Ursachen: unterbrochene Installation, während der Installation getrennte externe Festplatte, Antiviren-Quarantäne oder npm cache clean, das ausgeführt wurde, während npx aktiv war.

# 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

Sicherheit

Die API-Schlüsselvalidierung erfolgt serverseitig im WordPress-Plugin. Der MCP-Server reicht die Anmeldedaten durch und speichert oder validiert sie nicht.

Melden Sie Schwachstellen an security@respira.press. Vollständige Richtlinie in SECURITY.md.

Links

• Website

• Dokumentation

• Plugin herunterladen

• MCP-Einrichtung

• Skills-Katalog

• Abilities

• WooCommerce-Add-on

• Barrierefreiheits-Scanner-Add-on

• Support

Wo Sie Respira finden

Lizenz

MIT © Respira