MCP Adapter

Changelog

0.7.1 – 2026-10-15

Behoben

• Bound stored session initialization parameters to 4 KiB and automatically recover oversized session data, preventing repeated database failures and excessive logging. Affected clients need to reconnect once. Client icons are excluded from storage so large inline icons do not prevent connections.
• Register the installed plugin’s autoloader before checking for bundled copies, allowing version selection before an older bundled class is loaded.
• Unknown ability names from MCP clients no longer generate WordPress developer notices.

Geändert

• Unavailable abilities return clearer errors with relevant available ability names or a pointer to discovery. Abilities not exposed through MCP return the same ability_not_found error as unknown names.

Hinzugefügt

• A site-owner guide covers connecting an AI client, Application Passwords, and troubleshooting.

0.7.0 – 2026-10-02

Breaking Changes

• Der Adapter bedient genau zwei MCP-Schema-Revisionen, 2025-11-25 und 2026-07-28. Clients, die 2025-06-18 oder 2024-11-05 vorschlagen, können sich weiterhin verbinden und werden über das Schema 2025-11-25 bedient.
• Die generierten DTO-Klassen, die Klassen McpToolValidator, McpResourceValidator und McpPromptValidator sowie der Filter mcp_adapter_validation_enabled wurden entfernt. Die Validierung auf Protokollebene läuft immer über das gewählte Schema.
• Ungültige Protokollfelder werden nicht mehr stillschweigend verworfen oder repariert. Komponenten, die keine unterstützte Revision abbilden kann, werden abgelehnt.
• Individuelle Transporte müssen an HttpRequestHandler oder McpWireOrchestrator delegieren. JSON-RPC-Batch-Anfragen werden abgelehnt.
• Die WP\MCP\Cli-Klassen sind final.

Hinzugefügt

• Unterstützung für MCP 2026-07-28, einschliesslich des sitzungslosen server/discover-Lebenszyklus und der neuen HTTP-Header.
• Direkt aufrufbare Tools können unter 2026-07-28 Elicitation-Eingaben anfordern, indem sie McpInputRequired zurückgeben.
• McpRequestContext, ein unveränderlicher Kontext pro Anfrage mit dem gewählten Schema, dem Transport und den Sitzungsdaten.

Geändert

• Die Verwendung von MCP Adapter als gebündelte Bibliothek ist veraltet. Installieren Sie stattdessen das MCP-Adapter-Plugin.

Behoben

• mcp-adapter/get-ability-info serialisiert ein leeres input_schema als {} statt als [].
• Standard-Fähigkeiten werden auch dann registriert, wenn ein anderes Plugin die Abilities API initialisiert, bevor der MCP-Server initialisiert wird.

Die vollständige Liste der Änderungen steht im Migrationsleitfaden für 0.7.0 und in der CHANGELOG.md.

0.6.1 – 2026-08-13

Behoben

• Die Release-ZIP-Datei enthält keine Jetpack-Autoloader-Klassenzuordnung mehr, die auf Dateien verweist, die in der ZIP-Datei fehlen. In 0.6.0 führte die Klassenzuordnung nur für Tests benötigte globale Klassen auf, darunter WP_CLI und WP_CLI_Command, und verwies sie auf Dateien unter tests/phpunit/, die das Release-Artefakt nicht enthält. Jedes Plugin, das bei einer normalen Web-Anfrage class_exists( 'WP_CLI' ) aufrief, konnte dadurch einen nicht abgefangenen fatalen Fehler auslösen. class_exists( 'WP_CLI' ) gibt jetzt false zurück, wenn WP-CLI nicht verfügbar ist (#283).

Kein API-, Hook- oder Protokollverhalten hat sich geändert. Das Upgrade von 0.6.0 erfordert keine Migration. Installationen, die aus dem Quellcode gebaut oder über Composer eingebunden wurden, waren nicht betroffen.

0.6.0 – 2026-08-12

Breaking Changes

• WordPress 6.9 oder neuer ist jetzt erforderlich. Das eigenständige Abilities-API-Plugin ist kein unterstützter Installationsweg mehr.
• Fähigkeiten mit meta.public: true werden jetzt über den Standard-MCP-Server bereitgestellt, sofern meta.mcp.public dies nicht ausdrücklich ausschliesst. Bestehende Berechtigungs-Callbacks und -Prüfungen gelten weiterhin.
• Nur in Multisite-Installationen müssen aktive Streamable-HTTP-Sitzungen nach dem Upgrade einmal neu verbinden, weil der Sitzungsspeicher von einem netzwerkweiten Schlüssel zu separaten Schlüsseln pro Website wechselt. Einzelne Websites sind nicht betroffen.
• Die bisher von McpValidator bereitgestellten Hilfsfunktionen zur MIME-Validierung wurden entfernt. Integrationen, die sie direkt aufrufen, sollten eine eigene, anwendungsspezifische MIME-Validierung durchführen.

Hinzugefügt

• Unterstützung für resources/templates/list, das eine leere Template-Liste zurückgibt, wenn keine Templates verfügbar sind.
• Direkter Aufruf der PHP-Dateien des Plugins wird blockiert.
• Erweiterte automatisierte Prüfungen für Kompatibilität, Abhängigkeiten und Plugin Check.

Geändert

• Der Jetpack Autoloader wird jetzt verwendet, damit die neuesten verfügbaren WP\MCP-Klassen Vorrang haben, wenn der eigenständige Adapter und ein anderes Plugin unterschiedliche Versionen mitliefern.
• In WordPress-Multisite wird der Sitzungsspeicher pro Website getrennt.
• Gleichzeitige Änderungen an Sitzungen werden durch eine begrenzte Zahl von Wiederholungsversuchen abgesichert, was das Risiko verringert, dass eine Anfrage eine andere Sitzung überschreibt.
• Die Dokumentation stellt klar, dass die Abilities API ab WordPress 6.9 enthalten ist, beschreibt das erforderliche Feld category von Fähigkeiten und verbessert die Beispiele durchgehend.

Behoben

• _meta bleibt bei Ressourceninhalten, eingebetteten Ressourcen, Inhaltsblöcken und Prompt-Nachrichten erhalten.
• Fehlerhaftes _meta wird weggelassen, ohne die zugehörigen Nutzdaten zu verwerfen.
• mimeType wird genau so ausgegeben wie deklariert, einschliesslich Werten mit Parametern wie text/html;profile=mcp-app.
• Ressourceninhalte, die nur aus einem Blob bestehen, werden korrekt verarbeitet.
• Schemata von Ressourcen-URIs werden ohne Berücksichtigung der Gross-/Kleinschreibung abgeglichen, sodass Clients Ressourcen auch dann lesen können, wenn sie das Schema in Kleinbuchstaben normalisieren.
• Leere Argumente werden für Fähigkeiten mit Schema normalisiert, sodass gültige Tool-Aufrufe ohne Argumente ausgeführt werden können.
• wp mcp-adapter serve hält die JSON-RPC-Ausgabe auf stdout sauber, wenn der Standard-Server ausgewählt wird.
• Das globale WP-CLI-Argument --user wird verwendet, statt eine damit kollidierende lokale Option zu registrieren.

Ältere Versionen sind in der CHANGELOG.md aufgeführt.