MemberPress AI Foundation – Überblick und Einrichtungsanleitung

MemberPress AI Foundation erweitert MemberPress-Websites um eine KI-Integrationsschicht. Das Plugin stellt MemberPress-Funktionen über das Model Context Protocol (MCP) bereit. KI-Clients wie Claude Desktop und Cursor verwalten daraufhin Mitgliedschaften, Mitglieder, Transaktionen und Inhalte mithilfe natürlicher Sprache.

Dieser Leitfaden behandelt die Funktionen von AI Foundation, ihre Einordnung in die MemberPress AI Suite, die Voraussetzungen, die Installationsschritte sowie einen kurzen Überblick über den MCP-Setup-Assistenten.

Anmerkung zur Terminologie: Das Plugin heißt “AI Foundation” und nicht “MCP”. MCP ist eine von vier Funktionen, die das Plugin bereitstellt. In der Dokumentation wird das Plugin als “AI Foundation” und das Protokoll als “MCP” bezeichnet. Zukünftige Plugins der MemberPress AI Suite werden die Infrastruktur von AI Foundation gemeinsam nutzen, ohne dabei selbst unbedingt MCP bereitzustellen.

Was die AI Foundation bietet

Die AI Foundation bietet vier für den Kunden sichtbare Funktionen sowie eine unterstützende Infrastrukturebene.

Komponenten im Überblick

Komponente	Was es bewirkt	Endpunkt oder Standort
MCP-Server	Stellt den MCP-Toolkatalog über JSON-RPC 2.0 bereit – 41 Kern-Tools, weitere mit Add-ons	/wp-json/mp-mcp/v1/mcp
Öffentlicher MCP-Endpunkt	Deckt 4 schreibgeschützte Katalog-Tools ohne Authentifizierung auf	/wp-json/mp-mcp/v1/public-mcp
AI-Punktesystem	Stromerzeugung mit Meters Mastermind (nicht MCP)	WordPress-Adminleiste + Dashboard-Widget
Sicherheitsschicht für Agenten	Vier Maßnahmen zur Regelung destruktiver Vorgänge	In den MCP-Server integriert
Authentifizierungssystem	OAuth 2.1 PKCE, Bearer-Token, Anwendungskennwörter	/wp-json/mp-mcp/v1/authorize + /token
Gemeinsam genutzte PHP-Service-Schicht	Grundlegende Dienste für Plugin-Entwickler	mpai() global + MemberPressAI\Grundlagen Fassade
Integration der „Abilities“-API	Tools werden auch über den WordPress.org-MCP-Adapter bereitgestellt	Funktioniert nur unter WordPress 6.9 und höher
Admin-Benutzeroberfläche	Einrichtung, Kunden, Einstellungen, Guthaben	MemberPress > KI-Einstellungen

MCP-Server

Der MCP-Server stellt seinen Werkzeugkatalog über JSON-RPC 2.0 unter folgender Adresse bereit: /wp-json/mp-mcp/v1/mcp:

• 41 Kernwerkzeuge — Mitglieder, Mitgliedschaften, Abonnements, Transaktionen, Regeln, Gutscheine, Berichte, Inhalte, Webhooks, Erinnerungen, Importe, Systeminformationen, KI-Datenanalyse;
• 13 zusätzliche bedingte Werkzeuge — Registrierung, wenn das entsprechende Add-on aktiv ist: Kurse (8), Unternehmenskonten (3), Downloads (2);
• 4 öffentlich zugängliche Tools, die nur zum Lesen bestimmt sind — dies wird durch den unten aufgeführten separaten öffentlichen Endpunkt abgedeckt.

Der authentifizierte Katalog variiert daher je nach Standort: 41 Tools bei einer reinen Core-Installation, bis zu 54 wobei alle unterstützten Add-ons aktiviert sind. Eine geringere Anzahl auf einer bestimmten Website spiegelt deren Add-ons wider und deutet nicht auf eine fehlerhafte Installation hin.

Jedes Tool gibt einen erforderlichen Geltungsbereich und eine erforderliche WordPress-Berechtigung an. Der Server überprüft beides vor der Ausführung. Schreibvorgänge erfolgen standardmäßig als Vorschau. Destruktive Schreibvorgänge erfordern ein Bestätigungstoken. Siehe die MCP-Tools-Referenz für die vollständige Bestandsliste.

Öffentlicher MCP-Endpunkt

Der öffentliche Endpunkt unter /wp-json/mp-mcp/v1/public-mcp macht bis zu 4 schreibgeschützte Tools ohne Authentifizierung zugänglich: memberpress_list_memberships und memberpress_get_membership bei jeder Installation, außerdem memberpress_list_courses und memberpress_get_course solange „MemberPress-Kurse“ aktiv ist.

Wichtiges Verhalten:

• Standardmäßig deaktiviert. Website-Administratoren können diese Funktion über die Seite „KI-Einstellungen“ aktivieren;
• Rücksendungen 404 wenn deaktiviert. Die /.well-known/mcp.json Auch das Dokument zur Beweisaufnahme bleibt verborgen;
• Zeigt nur veröffentlichte Mitgliedschaften und Kurse an, für die sich der Administrator angemeldet hat. Es werden niemals Mitgliederdaten offengelegt;
• Auf jedem Bearbeitungsbildschirm für Mitgliedschaften und Kurse besteht die Möglichkeit, einzelne Produkte auszuschließen.

Anwendungsfall: Potenzielle Kunden erkundigen sich bei einem KI-Client nach verfügbaren Mitgliedschaftsplänen, ohne sich anzumelden.

AI-Kreditsystem

AI-Credits-Anzeige: Von Mastermind unterstützte KI-Generierung. Course Copilot verbraucht Credits bei der Erstellung von Kursinhalten.

MCP-Tool-Aufrufe verbrauchen keine Credits. Jedes Tool auf beiden MCP-Endpunkten läuft kostenlos, unabhängig vom Guthaben.

Das Credits-Dashboard wird an zwei Stellen angezeigt:

• Eine Kontostandsanzeige in der WordPress-Adminleiste;
• Ein Widget auf dem WordPress-Haupt-Dashboard.

Für Einkäufe wird derselbe von Stripe betriebene Bezahlvorgang verwendet wie bei Course Copilot.

Agent-Sicherheitsschicht

Vier Maßnahmen verhindern, dass zerstörerische Vorgänge ungehindert ablaufen.

Maßnahme	Name	Was es bewirkt
A	Bestätigungstoken	Tools zum zerstörerischen Schreiben erfordern einen Ablauf mit zwei Aufrufen: Der erste Aufruf gibt eine Vorschau sowie ein Einmal-Token zurück; der zweite Aufruf muss das Token enthalten.
B	Standardwerte für Testläufe	Schreibwerkzeuge sind standardmäßig auf die Vorschau eingestellt. Der KI-Client wählt die Ausführung über ausführen: true (zerstörungsfrei) oder der Bestätigungs-Token-Ablauf (zerstörend)
C	Detaillierte Geltungsbereiche	Verbindungstoken sind mit bestimmten Gültigkeitsbereichen verbunden (lesen, Schreibe: Mitglieder, Schreiben: Rechnungsstellung, write:imports, Schreiben: Webhooks, write:content, Schreiben: Kurse) statt eines pauschalen Zugangs
D	Not-Aus-Schalter	Administratoren können jeden destruktiven Schreibvorgang über die Administrationsseite „Verbundene Clients“ unterbrechen. Unterbrochene destruktive Aufrufe kehren zurück WRITES_PAUSED

Zerstörende Werkzeuge, für die Maßnahme A erforderlich ist: delete_member, Rückerstattungstransaktion, delete_webhook, Kursfortschritt zurücksetzen, Unterkonto verwalten, Abonnement verwalten.

Siehe die Leitfaden zu Sicherheitsmaßnahmen für Mitarbeiter für eine umfassende Darstellung der einzelnen Maßnahmen.

Unterstützende Infrastruktur

Oberfläche	Zweck
Authentifizierung	OAuth 2.1 PKCE (S256) als Standard; Bearer-Token über den Assistenten; Fallback auf Anwendungspasswörter
Service-Ebene	mpai() global und MemberPressAI\Grundlagen Schnittstelle für Plugin-Entwickler
Integration der „Abilities“-API	Wird ab WordPress 6.9+ registriert; die Tools werden auch über den WordPress.org-MCP-Adapter bereitgestellt
Admin-Benutzeroberfläche	Vier Registerkarten unter MemberPress > KI-Einstellungen: MCP-Einrichtungsassistent, Mit MCP verbundene Clients, MCP-Einstellungen, KI-Credits

MCP-Einstellungen

Die MCP-Einstellungen Auf der Registerkarte „Konfiguration“ befinden sich die Einstellungsoptionen für den Server:

Einstellung	Standard	Zweck
Zugangsdecke	Nur Lesen	Begrenzt den Umfang, den eine neue Verbindung erhalten kann. Schreibzugriff ist nur verfügbar, wenn „Vollzugriff“ eingestellt ist. Der Einrichtungsassistent blendet die Schreiboptionen aus, solange „Nur Lesen“ eingestellt ist. Siehe den Leitfaden zu Sicherheitsmaßnahmen für Mitarbeiter
Ablauf des Tokens	Niemals	Gültigkeitsdauer der ausgegebenen Verbindungstoken. “Never” gibt Token ohne Ablaufdatum aus.
Aufbewahrung von Protokollen	30 Tage	Wie lange werden Einträge im MCP-Aktivitätsprotokoll aufbewahrt?
MCP-Zugriffsrollen	Verwalter	Welche WordPress-Benutzerrollen dürfen KI-Clients über MCP verbinden? Die Rolle „Administrator“ ist immer aktiviert; bei anderen Rollen ist die Freigabe erforderlich. Mit dem „Members“-Plugin sind benutzerspezifische Ausnahmen möglich.
Ratenbegrenzung	Aktiviert, 120 Anfragen pro Minute	Begrenzt die Anzahl der MCP-Anfragen pro Token und Minute am authentifizierten Endpunkt. Das Limit ist konfigurierbar, und die Ratenbegrenzung kann vollständig deaktiviert werden.
Öffentlichen KI-Katalog-Endpunkt aktivieren	Aus	Stellt den nicht authentifizierten öffentlichen Katalog bereit (siehe Öffentlicher MCP-Endpunkt (oben)

Die Zugriffsobergrenze ist die entscheidende Kontrollmaßnahme: Sie ist das Tor, das darüber entscheidet, ob eine Verbindung überhaupt Schreibzugriffe vornehmen darf. Eine Änderung dieser Grenze hat keine Auswirkungen auf bestehende Verbindungen – der Geltungsbereich einer Verbindung wird bei ihrer Erstellung festgelegt; um die Obergrenze anzuheben und Schreibzugriffe zu gewähren, muss daher eine neue Verbindung hergestellt werden.

Die MemberPress AI Suite

AI Foundation ist das erste Plugin in der MemberPress AI Suite — eine geplante Produktfamilie von KI-gestützten Add-ons, die den gesamten MemberPress-Inhaltslebenszyklus abdecken.

Plugin	Status
MemberPress KI-Kursgenerator (Course Copilot)	Auslieferung im 1. Quartal 2026 – nutzt AI Foundation
MemberPress AI Foundation	Versandt im Juli 2026 (diese Dokumentation)
Co-Pilot V2	Festgelegter Umfang, Weiterentwicklung nach der Markteinführung
Content Intelligence	Bewertung des Pitches
KI-Mentor	Bewertung des Pitches
Wiederverwendung von Inhalten	Ideenphase

Zukünftige AI Suite-Produkte werden von Anfang an AI Foundation nutzen. Für Site-Administratoren gilt: Die nachträgliche Installation zusätzlicher AI Suite-Plugins erfordert:

• Keine doppelten Verbindungen;
• Keine doppelten Kreditkäufe;
• Keine doppelte AI-Client-Konfiguration.

Voraussetzungen

Anforderung	Mindestwert	Anmerkungen
WordPress	6.5	Für die Integration der Abilities-API ist Version 6.9 oder höher erforderlich. Bei älteren Versionen funktioniert der MCP-Server weiterhin uneingeschränkt, allerdings ohne die Registrierung von Fähigkeiten.
PHP	8.0	Erfüllt die PHP-Kernanforderung MemberPress
MemberPress-Kern	Aktive Installation	AI Foundation stützt sich beim Datenmodell auf MemberPress
HTTPS	Für die Produktion erforderlich	OAuth 2.1 erfordert HTTPS. Bei der lokalen Entwicklung kann HTTP ausschließlich zu Testzwecken verwendet werden.
Permalinks	Beitragsname oder ausführlicher	Die MCP-Endpunkte nutzen die WordPress-REST-API, für die nicht standardmäßige Permalinks erforderlich sind

Optionale Add-ons schalten bei Aktivierung zusätzliche Tools frei:

Add-on	Werkzeuge hinzugefügt
MemberPress-Kurse	8 Werkzeuge: get_course, list_courses, get_lesson, Liste_der_Lektionen, get_student_progress, Liste der Kursteilnehmer, Lektion abschließen, Kursfortschritt zurücksetzen
MemberPress Firmenkonten	3 Werkzeuge: get_corporate_account, Unterkonten auflisten, Unterkonto verwalten
MemberPress Downloads	2 Werkzeuge: list_downloads, get_download_stats

Das Tool-Register der AI Foundation verwendet ein class_exists() Überprüfen Sie jedes Add-on. Wenn ein Add-on inaktiv ist, werden die Werkzeuge des Add-ons nicht in der Tools/Liste Antwort.

Einrichtung

Die Installation von AI Foundation erfolgt über den Standard-Workflow für MemberPress-Add-ons: Öffnen MemberPress > Add-ons, suchen Sie die KI-Stiftung Karte und klicken Sie auf Add-on installieren. Wenn die Website keinen Zugriff auf die Download-Server hat, laden Sie die ZIP-Datei des Plugins über das MemberPress-Benutzerportal hoch, und zwar über Plugins > Neu hinzufügen > Plugin hochladen.

Der Plugin-Slug lautet memberpress-ai-stiftung. Die Hauptdatei des Plugins ist memberpress-ai-foundation/memberpress-ai-foundation.php.

Nach der Aktivierung, MemberPress > KI-Einstellungen wird in der Admin-Seitenleiste mit MCP-Einrichtungsassistent als erste Registerkarte. Um zu überprüfen, ob der Endpunkt aktiv ist, senden Sie eine Anfrage an den MCP-Server unter https://[site-url]/wp-json/mp-mcp/v1/mcp ohne Authentifizierung; ein aktiver Endpunkt gibt einen 401 Unzulässige Antwort. Falls die Aktivierung fehlschlägt, siehe MCP-Fehler und Fehlerbehebung für die Diagnoseschritte.

Eine vollständige Schritt-für-Schritt-Anleitung für Endbenutzer mit Screenshots – Installation, Zugriffsebene und Verbindung mit Claude Desktop – finden Sie unter Einrichtung von Claude Desktop mit MemberPress.

MCP-Einrichtungsassistent (kurzer Überblick)

Der MCP-Setup-Assistent unter MemberPress > KI-Einstellungen > MCP-Einrichtungsassistent führt jede Verbindung durch vier Schritte. Die Zugriffsebene wird separat festgelegt in MCP-Einstellungen und legt fest, welche Bereiche der Assistent anbietet.

Schritt	Zweck	Wichtige Maßnahmen
1. Willkommen	Details zur bestehenden Konfiguration anzeigen	Klicken Sie auf Los geht's
2. Zugriff	Die in den MCP-Einstellungen festgelegte Zugriffsebene übernehmen	Lesezugriff wird immer gewährt; Schreibbereiche erscheinen nur, wenn die Zugriffsebene Voller Zugriff; Klicken Sie auf Weiter
3. Verbinden	Kopieren Sie die Server-URL und stellen Sie eine Verbindung zum Client her	Kopieren Sie die URL des MCP-Servers; stellen Sie die Verbindung im Client her (in Claude Desktop über das Fenster „Connectors“); bestätigen Sie die OAuth-Autorisierung
4. Fertig	Verbindung bestätigen	Überprüfen Sie die Verbindungsübersicht; Klicken Sie auf Erledigt

Eine Schritt-für-Schritt-Anleitung mit Screenshots finden Sie unter Einrichtung von Claude Desktop mit MemberPress. Entwickler, die Cursor, VS Code, Windsurf oder Claude Code konfigurieren, befolgen die AI-Clients mit MemberPress verbinden stattdessen die Entwickler-Referenz.

Was als Nächstes?

Referenzdokumente für Entwickler:

Dokument	Umfang
Anbindung von KI-Clients an MemberPress: Entwicklerhandbuch	OAuth 2.1-PKCE-Ablauf, Bearer-Token, Fallback auf Anwendungskennwort, clientbezogene Konfiguration für jeden unterstützten Client
MCP-Tools-Referenz	Vollständiges Tool-Verzeichnis nach Lese-/Schreib-/destruktiven Schreib-Typen, Anwendungsbereichen, Funktionen und Code-Beispielen
Leitfaden zu Sicherheitsmaßnahmen für Mitarbeiter	Ausführliche Darstellung der vier Sicherheitsmaßnahmen, der Drei-Gate-Ausführungspipeline sowie des Abschnitts „Verwandte Funktionen“
MCP-Fehler und Fehlerbehebung	Fehlercode-Übersicht (WRITES_PAUSED, FÄHIGKEIT_UNZUREICHEND, nicht genügend_Credits, OAuth-Fehler, Fehler bei der Ratenbegrenzung), Fehlerbehebung in der Einführungswoche

Anleitungen zur Einrichtung für Endbenutzer:

Dokument	Umfang
Einrichtung von Claude Desktop mit MemberPress	Installation von AI Foundation, Festlegen der Zugriffsebene und der gesamte Verbindungsablauf für Connectors mit Screenshots