Conectar Claude Code y Cursor
Cómo añadir el servidor MCP de Memberfy en Claude Code (con el comando o con el .mcp.json) y en Cursor (con el mcp.json), autorizar en el navegador y comprobar la conexión. Para quien trabaja en el terminal o en el editor.
Claude Code y Cursor hablan MCP por HTTP, como Claude y ChatGPT: basta con apuntar a https://api.memberfy.net/mcp. En la primera llamada, abren el navegador para que autorices con tu cuenta de Memberfy. No hay ninguna clave que copiar ni ningún secreto que guardar en el proyecto.
La dirección y estos pasos también están en la propia Memberfy. En Mi Cuenta › Asistentes de IA (
/account?tab=assistants), o en Configuración › Asistentes de IA (propietario y administrador), el bloque Conectar un asistente muestra la Dirección del servidor MCP con el botón Copiar, y los pasos de cada asistente: Claude, ChatGPT y Claude Code / Cursor (con el comando y el fragmento del archivo, en Copiar el fragmento).
Claude Code
Con el comando
En el terminal, en la carpeta del proyecto:
claude mcp add --transport http memberfy https://api.memberfy.net/mcp
Para que valga en todos tus proyectos, y no solo en este, añade --scope user.
Con el archivo
O crea (o edita) el .mcp.json en la raíz del proyecto:
{
"mcpServers": {
"memberfy": {
"type": "http",
"url": "https://api.memberfy.net/mcp"
}
}
}
El .mcp.json puede ir al repositorio: no contiene ningún secreto. Cada persona del equipo autoriza con su propia cuenta y su propio rol.
Autorizar
- Abre Claude Code y escribe
/mcp. - Elige memberfy y la opción de autenticar.
- El navegador abre la pantalla de Memberfy. Inicia sesión, elige la comunidad y haz clic en Permitir.
- Vuelve al terminal: el servidor aparece como conectado, con las herramientas.
- Prueba: "usa memberfy y dime a qué comunidad estás conectado".
Recetas listas
En Claude Code, las ocho recetas de Memberfy se convierten en comandos: escribe / y elige, por ejemplo, /mcp__memberfy__monthly_report (el informe del mes) o /mcp__memberfy__create_course. La lista, y quién ve cada una, está en Recetas listas en el menú. Una sesión abierta antes del 6 de octubre de 2026 todavía puede mostrar los nombres antiguos de las herramientas: abre una sesión nueva.
Cursor
- Abre Cursor Settings › MCP y añade un servidor, o edita directamente el archivo:
~/.cursor/mcp.jsonpara todos los proyectos;.cursor/mcp.jsonen la carpeta del proyecto, solo para él.
- Pega:
{
"mcpServers": {
"memberfy": {
"url": "https://api.memberfy.net/mcp"
}
}
}
- Guarda. En Cursor Settings › MCP, el servidor memberfy aparece pidiendo inicio de sesión: haz clic para autenticar.
- En el navegador, inicia sesión en Memberfy, elige la comunidad y haz clic en Permitir.
- De vuelta en Cursor, el servidor se pone en verde, con la lista de herramientas.
- En el chat de Cursor (modo agente), pide algo a Memberfy.
Otros clientes
Cualquier cliente MCP que admita el transporte HTTP (streamable HTTP) y OAuth con descubrimiento automático funciona con la misma dirección. El servidor anuncia todo lo que el cliente necesita en https://api.memberfy.net/.well-known/oauth-protected-resource/mcp, y el cliente se registra solo. Los clientes que solo hablan por el transporte local (stdio) necesitan un puente a HTTP.
Detalles técnicos
| Dirección | https://api.memberfy.net/mcp (solo POST) |
| Transporte | HTTP, sin sesión: cada llamada es independiente |
| Autorización | OAuth 2.1 con PKCE (S256), registro dinámico de cliente |
| Retorno de la autorización | Cualquier https://, o http://localhost / http://127.0.0.1 para clientes locales |
| Ámbitos | read y write (por defecto: los dos). Solo con read, las herramientas de creación y de dinero no aparecen |
| Token de acceso | 1 hora, renovado solo por el cliente |
| Token de renovación | 30 días, sustituido en cada uso |
Más en Seguridad y límites.
Problemas de conexión
| Qué pasa | Qué hacer |
|---|---|
401 en todas las llamadas | La autorización no terminó o fue desconectada. Ejecuta /mcp (Claude Code) o haz clic para autenticar (Cursor) de nuevo |
| El navegador no se abre | Copia el enlace que muestra el cliente y ábrelo a mano |
| "Esta solicitud de acceso no es válida." | Quita el servidor y añádelo de nuevo; puede que el registro del cliente se quedara con otra dirección de retorno |
| Muchas llamadas seguidas empiezan a fallar | El límite es de 120 llamadas de herramienta por minuto por conexión. Espera un minuto |
Más casos en Problemas comunes.
Relacionados
- Visión general del MCP
- Herramientas
- API: para integrar con código, sin asistente