Présentation et guide d'installation de MemberPress AI Foundation

MemberPress AI Foundation ajoute une couche d'intégration IA aux sites MemberPress. Le plugin rend accessibles les fonctionnalités de MemberPress via le Model Context Protocol (MCP). Les clients IA tels que Claude Desktop et Cursor gèrent alors les adhésions, les membres, les transactions et le contenu via le langage naturel.

Ce guide présente les fonctionnalités d'AI Foundation, sa place au sein de la suite MemberPress AI, les prérequis, les étapes d'installation, ainsi qu'un bref aperçu de l'assistant de configuration MCP.

Note terminologique : Le plugin s'appelle “ AI Foundation ”, et non “ MCP ”. MCP est l'une des quatre fonctionnalités offertes par le plugin. La documentation désigne le plugin sous le nom d“” AI Foundation “ et le protocole sous celui de ” MCP ». Les futurs plugins de la suite MemberPress AI partageront l'infrastructure d'AI Foundation sans pour autant exposer eux-mêmes le protocole MCP.

Ce qu'offre AI Foundation

AI Foundation propose quatre fonctionnalités accessibles aux clients, ainsi qu'une couche d'infrastructure de soutien.

Aperçu des composants

Composant	Fonctionnalités	Terminal ou emplacement
Serveur MCP	Expose le catalogue d'outils MCP via JSON-RPC 2.0 — 41 outils de base, et bien d'autres encore grâce aux modules complémentaires	/wp-json/mp-mcp/v1/mcp
Point de terminaison MCP public	Expose 4 outils de catalogue en lecture seule sans authentification	/wp-json/mp-mcp/v1/public-mcp
Système de crédits IA	Production alimentée par Meters Mastermind (et non par MCP)	Barre d'administration WordPress + widget du tableau de bord
Couche de sécurité des agents	Quatre mesures régissant les opérations destructrices	Intégré au serveur MCP
Système d'authentification	OAuth 2.1 PKCE, jetons « Bearer », mots de passe d'application	/wp-json/mp-mcp/v1/authorize + /token
Couche de service PHP partagée	Services de base pour les développeurs de plugins	mpai() global + MemberPressAI\Fondation façade
Intégration de l'API « Abilities »	Les outils sont également accessibles via l'adaptateur MCP de WordPress.org	Fonctionne uniquement avec WordPress 6.9 et versions ultérieures
Interface utilisateur d'administration	Configuration, clients, paramètres, crédits	MemberPress > Paramètres IA

Serveur MCP

Le serveur MCP met à disposition son catalogue d'outils via JSON-RPC 2.0 à l'adresse /wp-json/mp-mcp/v1/mcp:

• 41 outils essentiels — membres, adhésions, abonnements, transactions, règles, bons de réduction, rapports, contenu, webhooks, rappels, importations, informations système, analyse de données par IA ;
• 13 outils conditionnels complémentaires — s'enregistrer lorsque l'extension correspondante est active : Cours (8), Comptes d'entreprise (3), Téléchargements (2) ;
• 4 outils publics en lecture seule — traitées par le point de terminaison public distinct indiqué ci-dessous.

Le catalogue authentifié varie donc selon le site : 41 outils dans une installation « core-only », jusqu'à 54 avec tous les modules complémentaires pris en charge activés. Un nombre inférieur sur un site donné correspond au nombre de ses modules complémentaires, et non à une installation défectueuse.

Chaque outil déclare une portée requise et une capacité WordPress requise. Le serveur vérifie ces deux éléments avant d'exécuter l'opération. Les outils d'écriture sont configurés par défaut en mode « aperçu ». Les opérations d'écriture destructives nécessitent un jeton de confirmation. Voir la Référence des outils MCP pour consulter l'inventaire complet.

Point de terminaison MCP public

Le point de terminaison public à l'adresse /wp-json/mp-mcp/v1/public-mcp expose jusqu'à 4 outils en lecture seule sans authentification : liste_des_adhésions_memberpress et memberpress_get_membership à chaque installation, ainsi que liste_des_cours_pour_les_membres et memberpress_get_course tant que le programme « MemberPress Courses » est actif.

Comportement clé :

• Désactivée par défaut. Les administrateurs du site peuvent l'activer via la page « Paramètres IA » ;
• Retours 404 lorsqu'elle est désactivée. La /.well-known/mcp.json le document de divulgation reste également confidentiel ;
• N'affiche que les adhésions et les cours publiés pour lesquels l'administrateur a donné son accord. Ne divulgue jamais les données des membres ;
• Possibilité de désactiver l'option produit par produit sur chaque écran de modification d'abonnement et de formation.

Cas d'utilisation : des clients potentiels interrogent un assistant IA sur les formules d'abonnement disponibles sans fournir d'identifiants.

Système de crédits AI

Compteur de crédits IA : génération d'IA optimisée par Mastermind. Course Copilot utilise des crédits lors de la génération de contenu de cours.

Les appels à l'outil MCP ne consomment pas de crédits. Tous les outils disponibles sur les deux terminaux MCP fonctionnent gratuitement, quel que soit le solde de crédits.

Le tableau de bord des crédits s'affiche à deux endroits :

• Un indicateur de solde dans la barre d'administration de WordPress ;
• Un widget sur le tableau de bord principal de WordPress.

Les achats s'effectuent via le même système de paiement basé sur Stripe que celui de Course Copilot.

Couche de sécurité des agents

Quatre mesures empêchent les opérations destructrices de s'exécuter sans contrôle.

Mesure	Nom	Fonctionnalités
A	Jetons de confirmation	Les outils d'écriture destructive nécessitent un processus en deux étapes : le premier appel renvoie un aperçu ainsi qu'un jeton à usage unique ; le deuxième appel doit inclure ce jeton.
B	Paramètres par défaut du test à blanc	Les outils d'écriture s'affichent par défaut en mode aperçu. Le client IA doit activer l'exécution via exécuter : true (non destructif) ou le flux de jetons de confirmation (destructif)
C	Portées granulaires	Les jetons de connexion ont des portées spécifiques (lire, écrire : membres, écrire : facturation, écrire : importations, écrire : webhooks, écrire : contenu, écrire : cours) plutôt qu'un accès généralisé
D	Interrupteur d'arrêt d'urgence	Les administrateurs peuvent suspendre toute opération d'écriture destructive depuis la page d'administration « Clients connectés ». Les appels destructifs suspendus reviennent ÉCRITURE_SUSPENDUE

Outils destructeurs nécessitant la mesure A : supprimer_membre, transaction_de_remboursement, supprimer_webhook, réinitialiser_la_progression_du_cours, gérer_un_sous-compte, gérer_l'abonnement.

Voir le Guide des mesures de sécurité pour les agents pour une présentation détaillée de chaque mesure.

Infrastructures de soutien

Surface	Objectif
Authentification	OAuth 2.1 PKCE (S256) comme méthode principale ; jetons « Bearer » via l'assistant ; recours aux mots de passe d'application en cas de besoin
Couche de service	mpai() au niveau mondial et MemberPressAI\Fondation interface pour les développeurs de plugins
Intégration de l'API « Abilities »	Fonctionne sous WordPress 6.9 et versions ultérieures ; les outils sont également accessibles via l'adaptateur MCP de WordPress.org
Interface utilisateur d'administration	Quatre onglets à MemberPress > Paramètres IA: Assistant de configuration MCP, Clients connectés à MCP, Paramètres MCP, Crédits IA

Paramètres MCP

Les Paramètres MCP L'onglet contient les paramètres de configuration du serveur :

Paramètres	Défaut	Objectif
Plafond d'accès	Lecture seule	Limite les droits d'accès dont peut bénéficier toute nouvelle connexion. Les droits d'écriture ne sont disponibles que lorsque l'option est définie sur « Accès complet ». L'assistant de configuration masque les options d'écriture tant que cette option est définie sur « Lecture seule ». Voir la section Guide des mesures de sécurité pour les agents
Expiration du jeton	Jamais	Durée de validité des jetons de connexion émis. L’option “ Jamais ” émet des jetons sans date d’expiration.
Conservation des journaux	30 jours	Pendant combien de temps le journal d'activité MCP conserve-t-il les entrées ?
Rôles d'accès MCP	Administrateur	Quels rôles d'utilisateur WordPress permettent de connecter des clients IA via MCP ? Le rôle « Administrateur » est toujours activé ; les autres rôles sont optionnels. Des règles de dérogation par utilisateur sont disponibles avec le plugin Members.
Limitation du débit	Activé, 120 requêtes par minute	Limite le nombre de requêtes MCP par jeton et par minute sur le point de terminaison authentifié. Cette limite est configurable, et la limitation de débit peut être entièrement désactivée.
Activer le point de terminaison du catalogue d'IA public	Désactivé	Expose le catalogue public sans authentification (voir Point de terminaison MCP public (ci-dessus)

Le plafond d'accès est le mécanisme de contrôle le plus déterminant : c'est lui qui détermine si une connexion est autorisée à écrire ou non. Sa modification n'affecte pas les connexions existantes — la portée d'une connexion est fixée lors de sa création ; par conséquent, pour relever ce plafond et autoriser les écritures, il faut établir une nouvelle connexion.

La suite MemberPress AI

AI Foundation est le premier plugin de la Suite MemberPress AI — une gamme prévue de modules complémentaires basés sur l'IA couvrant l'ensemble du cycle de vie du contenu MemberPress.

Plugin	Statut
Générateur de cours d'IA MemberPress (Course Copilot)	Lancement prévu au 1er trimestre 2026 — utilise AI Foundation
Fondation MemberPress pour l'IA	Publié en juillet 2026 (la présente documentation)
Co-Pilot V2	Définition du périmètre, développement après le lancement
Intelligence du contenu	Analyse du pitch
Mentor en IA	Analyse du pitch
Réutilisation de contenu	Phase de conception

Les futurs produits de la gamme AI Suite utiliseront AI Foundation dès leur lancement. Pour les administrateurs de site, l'installation ultérieure de plugins AI Suite supplémentaires nécessite :

• Pas de connexions en double ;
• Pas d'achats à crédit en double ;
• Pas de configuration en double du client IA.

Conditions préalables

Exigence	Minimum	Notes
WordPress	6.5	L'intégration de l'API « Abilities » nécessite la version 6.9 ou supérieure. Sur les versions antérieures, le serveur MCP continue de fonctionner pleinement, mais sans prise en charge de l'enregistrement des capacités.
PHP	8.0	Répond à l'exigence PHP de base MemberPress
Noyau MemberPress	Installation active	AI Foundation s'appuie sur MemberPress pour son modèle de données
HTTPS	Indispensable pour la production	OAuth 2.1 nécessite l'utilisation du protocole HTTPS. En développement local, le protocole HTTP peut être utilisé uniquement à des fins de test.
Liens permanents	Nom de l'article ou plus détaillé	Les points de terminaison MCP utilisent l'API REST de WordPress, qui nécessite des permaliens non par défaut

Les modules complémentaires facultatifs permettent d'accéder à des outils supplémentaires lorsqu'ils sont activés :

Complément	Outils ajoutés
Cours sur MemberPress	8 outils : get_course, liste_des_cours, get_lesson, liste_des_leçons, get_student_progress, liste_des_étudiants_par_cours, leçon complète, réinitialiser_la_progression_du_cours
MemberPress Comptes d'entreprise	3 outils : obtenir_un_compte_d'entreprise, liste_des_sous-comptes, gérer_un_sous-compte
MemberPress Téléchargements	2 outils : liste_des_téléchargements, get_download_stats

Le registre des outils de l'AI Foundation utilise un class_exists() Vérifiez chaque module complémentaire. Lorsqu'un module complémentaire est désactivé, ses outils n'apparaissent pas dans le outils/liste réponse.

Installation

AI Foundation s'installe via le processus standard d'installation des modules complémentaires MemberPress : ouvrir MemberPress > Modules complémentaires, repérez le Fondation pour l'IA carte, puis cliquez sur Installer le module complémentaire. Si votre site ne parvient pas à se connecter aux serveurs de téléchargement, téléversez le fichier ZIP du plugin depuis le portail de votre compte MemberPress via Plugins > Ajouter un nouveau plugin > Upload Plugin.

Le slug du plugin est memberpress-ai-foundation. Le fichier principal du plugin est memberpress-ai-foundation/memberpress-ai-foundation.php.

Après l'activation, MemberPress > Paramètres IA apparaît dans la barre latérale d'administration avec Assistant de configuration MCP comme premier onglet. Pour vérifier que le point de terminaison est opérationnel, envoyez une requête au serveur MCP à l'adresse https://[site-url]/wp-json/mp-mcp/v1/mcp sans authentification ; un point de terminaison actif renvoie un 401 Réponse non autorisée. Si l'activation échoue, consultez Erreurs MCP et dépannage pour les étapes du diagnostic.

Pour consulter le guide complet destiné aux utilisateurs finaux, illustré de captures d'écran (installation, niveau d'accès et connexion à Claude Desktop), rendez-vous sur Configuration de Claude Desktop avec MemberPress.

Assistant de configuration MCP (brève présentation)

L'assistant de configuration MCP disponible à l'adresse MemberPress > Paramètres IA > Assistant de configuration MCP guide chaque connexion à travers quatre étapes. Le niveau d'accès est défini séparément dans Paramètres MCP et détermine les portées proposées par l'assistant.

Étape	Objectif	Mesures clés
1. Bienvenue	Afficher les détails de la configuration actuelle	Cliquez sur Commencer
2. Accès	Refléter le niveau d'accès défini dans les paramètres MCP	Les droits de lecture sont toujours accordés ; les droits d'écriture n'apparaissent que lorsque le niveau d'accès est Accès complet; Cliquez sur Continuer
3. Se connecter	Copiez l'URL du serveur et connectez le client	Copiez l'URL du serveur MCP ; effectuez la connexion dans le client (Claude Desktop utilise son panneau « Connectors ») ; validez l'autorisation OAuth
4. Terminé	Vérifiez la connexion	Consultez le récapitulatif de la connexion ; cliquez sur Terminé

Pour obtenir des instructions détaillées accompagnées de captures d'écran, consultez Configuration de Claude Desktop avec MemberPress. Les développeurs qui configurent Cursor, VS Code, Windsurf ou Claude Code doivent suivre les instructions suivantes : Connexion des clients IA à MemberPress consultez plutôt le guide de référence pour les développeurs.

Où aller ensuite ?

Documents de référence pour les développeurs :

Document	Couverture
Connexion des clients IA à MemberPress : Guide de référence pour les développeurs	Flux PKCE OAuth 2.1, jetons « Bearer », solution de secours via le mot de passe d'application, configuration spécifique à chaque client pris en charge
Référence des outils MCP	Inventaire complet des outils classés par type (lecture, écriture, écriture destructive), domaines d'application, fonctionnalités et exemples de code
Guide des mesures de sécurité pour les agents	Présentation détaillée des quatre mesures de sécurité, du pipeline d'exécution à trois étapes et de la section « Fonctionnalités associées »
Erreurs MCP et dépannage	Référence des codes d'erreur (ÉCRITURE_SUSPENDUE, CAPACITÉ_INSUFFISANTE, crédits insuffisants, erreurs OAuth, erreurs de limitation de débit), dépannage pendant la semaine de lancement

Guides d'installation destinés aux utilisateurs finaux :

Document	Couverture
Configuration de Claude Desktop avec MemberPress	Installation d'AI Foundation, configuration du niveau d'accès et procédure complète de connexion aux connecteurs, avec captures d'écran