Guía general y de configuración de MemberPress AI Foundation

MemberPress AI Foundation añade una capa de integración de IA a los sitios de MemberPress. El complemento expone la funcionalidad de MemberPress a través del Protocolo de Contexto de Modelos (MCP). A continuación, los clientes de IA, como Claude Desktop y Cursor, gestionan las suscripciones, los miembros, las transacciones y el contenido mediante lenguaje natural.

Esta guía describe qué ofrece AI Foundation, cuál es su lugar dentro de la suite de IA MemberPress, los requisitos previos, los pasos de instalación y una breve descripción general del asistente de configuración de MCP.

Nota terminológica: El complemento se llama “AI Foundation”, no “MCP”. MCP es una de las cuatro funcionalidades que ofrece el complemento. En la documentación, el complemento se denomina “AI Foundation” y el protocolo, “MCP”. Los futuros complementos de la suite MemberPress AI compartirán la infraestructura de AI Foundation sin que ello implique necesariamente que ellos mismos expongan MCP.

Qué ofrece AI Foundation

AI Foundation ofrece cuatro funcionalidades visibles para el cliente, además de una capa de infraestructura de apoyo.

Resumen de los componentes

Componente	Para qué sirve	Punto final o ubicación
Servidor MCP	Pone a disposición el catálogo de herramientas de MCP a través de JSON-RPC 2.0: 41 herramientas básicas y muchas más con los complementos	/wp-json/mp-mcp/v1/mcp
Punto final público de MCP	Revela 4 herramientas de catálogo de solo lectura sin autenticación	/wp-json/mp-mcp/v1/public-mcp
Sistema de créditos de IA	Generación gestionada por Meters Mastermind (no MCP)	Barra de administración de WordPress + widget del panel de control
Capa de seguridad del agente	Cuatro medidas que regulan las operaciones destructivas	Integrado en el servidor MCP
Sistema de autenticación	OAuth 2.1 PKCE, tokens «Bearer», contraseñas de aplicación	/wp-json/mp-mcp/v1/authorize + /token
Capa de servicio PHP compartida	Servicios básicos para desarrolladores de plugins	mpai() global + MemberPressAI\Fundación fachada
Integración de la API de habilidades	Las herramientas también están disponibles a través del adaptador MCP de WordPress.org	Solo funciona en WordPress 6.9 y versiones posteriores
Interfaz de usuario de administración	Configuración, clientes, ajustes, créditos	MemberPress > Ajustes de IA

Servidor MCP

El servidor MCP pone a disposición su catálogo de herramientas a través de JSON-RPC 2.0 en /wp-json/mp-mcp/v1/mcp:

• 41 herramientas básicas — miembros, afiliaciones, suscripciones, transacciones, normas, cupones, informes, contenido, webhooks, recordatorios, importaciones, información del sistema, análisis de datos mediante IA;
• 13 herramientas condicionales complementarias — registrarse cuando el complemento correspondiente esté activo: Cursos (8), Cuentas corporativas (3), Descargas (2);
• 4 herramientas públicas de solo lectura — que se trata en el punto de acceso público independiente que figura a continuación.

Por lo tanto, el catálogo autenticado varía según el sitio: 41 herramientas en una instalación solo con el núcleo, hasta 54 con todos los complementos compatibles activados. Un número menor en una página web concreta se debe a sus complementos, no a un fallo en la instalación.

Cada herramienta declara un ámbito de aplicación y una capacidad de WordPress necesarios. El servidor comprueba ambos antes de ejecutar la operación. Las herramientas de escritura se ejecutan por defecto en modo de vista previa. Las operaciones de escritura destructivas requieren un token de confirmación. Consulta el Referencia de herramientas MCP para ver el inventario completo.

Punto de conexión público de MCP

El punto de acceso público en /wp-json/mp-mcp/v1/public-mcp deja expuestas hasta 4 herramientas de solo lectura sin necesidad de autenticación: lista_de_miembros_afiliaciones y memberpress_get_membership en cada instalación, además de lista_de_cursos_para_miembros y memberpress_get_course mientras el curso «MemberPress Courses» esté activo.

Comportamiento clave:

• Desactivado por defecto. Los administradores del sitio pueden activarlo a través de la página de configuración de IA;
• Devoluciones 404 cuando está desactivado. El /.well-known/mcp.json el documento de investigación también permanece oculto;
• Solo muestra las afiliaciones y los cursos publicados que el administrador haya decidido mostrar. Nunca muestra los datos de los miembros;
• Opción de exclusión voluntaria por producto disponible en cada pantalla de edición de suscripciones y cursos.

Caso de uso: los clientes potenciales preguntan a un asistente de IA sobre los planes de suscripción disponibles sin necesidad de introducir credenciales.

Sistema de créditos AI

Contador de créditos de IA: generación de IA impulsada por Mastermind. Course Copilot consume créditos al generar contenido para los cursos.

Las llamadas a la herramienta MCP no consumen créditos. Todas las herramientas de ambos terminales MCP funcionan de forma gratuita, independientemente del saldo de crédito.

El panel de créditos aparece en dos sitios:

• Un indicador de saldo en la barra de administración de WordPress;
• Un widget en el panel de control principal de WordPress.

Las compras utilizan el mismo proceso de pago basado en Stripe que Course Copilot.

Capa de seguridad del agente

Hay cuatro medidas que evitan que las operaciones destructivas se ejecuten sin control.

Medida	Nombre	Para qué sirve
A	Tokens de confirmación	Las herramientas de escritura destructiva requieren un proceso de dos llamadas: la primera llamada devuelve una vista previa y un token de un solo uso; la segunda llamada debe incluir el token.
B	Valores predeterminados de la simulación	Las herramientas de escritura muestran la vista previa de forma predeterminada. El cliente de IA opta por ejecutarse a través de ejecutar: true (no destructivo) o el flujo de tokens de confirmación (destructivo)
C	Ámbitos granulares	Los tokens de conexión tienen ámbitos específicos (leer, escribir:miembros, escribir:facturación, escribir:importaciones, escribir:webhooks, escribir:contenido, escribir:cursos) en lugar de un acceso generalizado
D	Interruptor de emergencia	Los administradores pueden pausar cualquier operación de escritura destructiva desde la página de administración de «Clientes conectados». Las llamadas destructivas pausadas vuelven a ESCRITURA_EN_PAUSA

Herramientas destructivas que requieren la Medida A: eliminar_miembro, transacción_de_reembolso, eliminar_webhook, restablecer_progreso_del_curso, gestionar_subcuenta, gestionar_suscripción.

Véase el Referencia sobre medidas de seguridad para agentes para obtener información detallada sobre cada medida.

Infraestructura de apoyo

Superficie	Objetivo
Autenticación	OAuth 2.1 PKCE (S256) como método principal; tokens «Bearer» a través del asistente; contraseñas de aplicación como alternativa
Capa de servicio	mpai() a nivel mundial y MemberPressAI\Fundación interfaz para desarrolladores de complementos
Integración de la API de habilidades	Funciona con WordPress 6.9 y versiones posteriores; las herramientas también están disponibles a través del adaptador MCP de WordPress.org
Interfaz de usuario de administración	Cuatro pestañas en MemberPress > Ajustes de IA: Asistente de configuración de MCP, Clientes conectados a MCP, Ajustes de MCP, Créditos de IA

Configuración de MCP

En Configuración de MCP La pestaña contiene los controles de configuración del servidor:

Configuración	Por defecto	Objetivo
Techo de acceso	Solo lectura	Limita el ámbito de acceso que puede recibir cualquier nueva conexión. Los ámbitos de escritura solo están disponibles cuando se establece en «Acceso completo». El asistente de configuración oculta las opciones de escritura mientras esté en modo «Solo lectura». Consulta el Referencia sobre medidas de seguridad para agentes
Caducidad del token	Nunca	Vigencia de los tokens de conexión emitidos. “Nunca” emite tokens sin fecha de caducidad.
Conservación de registros	30 días	Durante cuánto tiempo se conservan las entradas en el registro de actividad del MCP
Roles de acceso a MCP	Administrador	¿Qué roles de usuario de WordPress pueden conectar clientes de IA a través de MCP? El rol de administrador siempre está habilitado; los demás roles se activan de forma opcional. Se pueden aplicar configuraciones específicas por usuario con el plugin Members.
Limitación de la tasa	Activado, 120 solicitudes por minuto	Limita el número de solicitudes MCP por token y por minuto en el punto final autenticado. El límite es configurable y la limitación de tasa se puede desactivar por completo.
Habilitar el punto final del catálogo público de IA	Apagado	Muestra el catálogo público sin autenticación (véase Punto de conexión público de MCP (arriba)

El límite de acceso es el control más importante: es la puerta de control que determina si una conexión puede escribir o no. Modificarlo no afecta a las conexiones existentes; el ámbito de una conexión queda fijado en el momento de su creación, por lo que para aumentar el límite y permitir la escritura es necesario establecer una nueva conexión.

La suite de IA MemberPress

AI Foundation es el primer complemento de la Paquete de IA MemberPress — una familia de complementos basados en inteligencia artificial que abarca todo el ciclo de vida del contenido de MemberPress.

Plugin	Estado
Generador de cursos de IA MemberPress (Course Copilot)	Lanzamiento previsto para el primer trimestre de 2026 — utiliza AI Foundation
Fundación MemberPress AI	Publicado en julio de 2026 (esta documentación)
Co-Pilot V2	Alcance definido, desarrollo posterior al lanzamiento
Inteligencia de contenidos	Revisión de la propuesta
Mentor de IA	Revisión de la propuesta
Reutilización de contenidos	Fase de idea

Los futuros productos de AI Suite utilizarán AI Foundation desde el primer día. Para los administradores del sitio, la instalación posterior de complementos adicionales de AI Suite requiere:

• No se permiten conexiones duplicadas;
• No se admiten compras a crédito duplicadas;
• No hay ninguna configuración duplicada del cliente de IA.

Requisitos previos

Requisito	Mínimo	Notas
WordPress	6.5	La integración de la API de habilidades requiere la versión 6.9 o superior. En versiones anteriores, el servidor MCP sigue funcionando plenamente, aunque sin registros de habilidades.
PHP	8.0	Cumple con el requisito básico de PHP MemberPress
Núcleo MemberPress	Instalación activa	AI Foundation se basa en MemberPress para el modelo de datos
HTTPS	Imprescindible para la producción	OAuth 2.1 requiere HTTPS. En el desarrollo local se puede utilizar HTTP únicamente con fines de prueba.
Enlaces permanentes	Nombre de la entrada o más detallado	Los puntos finales de MCP utilizan la API REST de WordPress, lo que requiere enlaces permanentes no predeterminados

Los complementos opcionales desbloquean herramientas adicionales cuando están activos:

Complemento	Herramientas añadidas
Cursos MemberPress	8 herramientas: get_course, lista_de_cursos, get_lesson, lista_de_lecciones, get_student_progress, lista_de_alumnos_del_curso, lección completa, restablecer_progreso_del_curso
MemberPress Cuentas de empresa	3 herramientas: obtener_cuenta_corporativa, lista_de_subcuentas, gestionar_subcuenta
MemberPress Descargas	2 herramientas: lista_descargas, get_download_stats

El registro de herramientas de AI Foundation utiliza un class_exists() Comprueba cada complemento. Cuando un complemento está inactivo, sus herramientas no aparecen en el herramientas/lista respuesta.

Instalación

AI Foundation se instala mediante el flujo de trabajo estándar de complementos MemberPress: abrir MemberPress > Complementos, busca el Fundación de IA tarjeta y haz clic en Instalar complemento. Si el sitio web no puede conectarse a los servidores de descarga, sube el archivo ZIP del complemento desde el portal de la cuenta de MemberPress a través de Plugins > Añadir nuevo > Subir plugin.

El slug del plugin es memberpress-ai-foundation. El archivo principal del complemento es memberpress-ai-foundation/memberpress-ai-foundation.php.

Después de la activación, MemberPress > Ajustes de IA aparece en la barra lateral de administración con Asistente de configuración de MCP como primera pestaña. Para comprobar que el punto final está operativo, envía una solicitud al servidor MCP en https://[site-url]/wp-json/mp-mcp/v1/mcp sin autenticación; un punto final activo devuelve un 401 Respuesta no autorizada. Si la activación falla, consulta Errores del MCP y resolución de problemas para los pasos del diagnóstico.

Para consultar la guía completa para el usuario final con capturas de pantalla —instalación, nivel de acceso y conexión a Claude Desktop—, consulta Configuración de Claude Desktop con MemberPress.

Asistente de configuración de MCP (breve descripción general)

El asistente de configuración de MCP en MemberPress > Ajustes de IA > Asistente de configuración de MCP guía cada conexión a través de cuatro pasos. El nivel de acceso se configura por separado en Configuración de MCP y determina qué ámbitos ofrece el asistente.

Paso	Objetivo	Medidas clave
1. Bienvenidos	Mostrar los detalles de la configuración actual	Haga clic en Comenzar
2. Acceso	Reflejar el nivel de acceso establecido en la configuración de MCP	El acceso de lectura siempre está permitido; los ámbitos de escritura solo aparecen cuando el nivel de acceso es Acceso completo; Haz clic en Continúe en
3. Conectar	Copia la URL del servidor y conecta el cliente	Copia la URL del servidor MCP; completa la conexión en el cliente (Claude Desktop utiliza su panel «Connectors»); aprueba la autorización OAuth
4. Listo	Confirma la conexión	Revisa el resumen de la conexión; haz clic en Hecho

Para obtener instrucciones paso a paso con capturas de pantalla, consulta Configuración de Claude Desktop con MemberPress. Los desarrolladores que configuren Cursor, VS Code, Windsurf o Claude Code deben seguir las instrucciones de Conexión de clientes de IA a MemberPress consulta, en su lugar, la guía de referencia para desarrolladores.

¿A dónde ir ahora?

Documentos de referencia para desarrolladores:

Documento	Cobertura
Conexión de clientes de IA a MemberPress: Referencia para desarrolladores	Flujo PKCE de OAuth 2.1, tokens «Bearer», opción alternativa de contraseña de aplicación, configuración específica para cada cliente compatible
Referencia de herramientas MCP	Inventario completo de herramientas por tipo (lectura, escritura y escritura destructiva), ámbitos de aplicación, capacidades y ejemplos de código
Referencia sobre medidas de seguridad para agentes	Análisis detallado de las cuatro medidas de seguridad, el proceso de ejecución de tres etapas y la sección «Capacidades relacionadas»
Errores del MCP y resolución de problemas	Referencia de códigos de error (ESCRITURA_EN_PAUSA, CAPACIDAD_INSUFICIENTE, créditos insuficientes, errores de OAuth, errores de límite de rate), resolución de problemas durante la semana de lanzamiento

Guías de configuración para el usuario final:

Documento	Cobertura
Configuración de Claude Desktop con MemberPress	Instalación de AI Foundation, configuración del nivel de acceso y flujo completo de conexión de los conectores con capturas de pantalla