Saltar al contenido

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

  1. Abre Claude Code y escribe /mcp.
  2. Elige memberfy y la opción de autenticar.
  3. El navegador abre la pantalla de Memberfy. Inicia sesión, elige la comunidad y haz clic en Permitir.
  4. Vuelve al terminal: el servidor aparece como conectado, con las herramientas.
  5. 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

  1. Abre Cursor Settings › MCP y añade un servidor, o edita directamente el archivo:
    • ~/.cursor/mcp.json para todos los proyectos;
    • .cursor/mcp.json en la carpeta del proyecto, solo para él.
  2. Pega:
{
  "mcpServers": {
    "memberfy": {
      "url": "https://api.memberfy.net/mcp"
    }
  }
}
  1. Guarda. En Cursor Settings › MCP, el servidor memberfy aparece pidiendo inicio de sesión: haz clic para autenticar.
  2. En el navegador, inicia sesión en Memberfy, elige la comunidad y haz clic en Permitir.
  3. De vuelta en Cursor, el servidor se pone en verde, con la lista de herramientas.
  4. 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ónhttps://api.memberfy.net/mcp (solo POST)
TransporteHTTP, sin sesión: cada llamada es independiente
AutorizaciónOAuth 2.1 con PKCE (S256), registro dinámico de cliente
Retorno de la autorizaciónCualquier https://, o http://localhost / http://127.0.0.1 para clientes locales
Ámbitosread y write (por defecto: los dos). Solo con read, las herramientas de creación y de dinero no aparecen
Token de acceso1 hora, renovado solo por el cliente
Token de renovación30 días, sustituido en cada uso

Más en Seguridad y límites.

Problemas de conexión

Qué pasaQué hacer
401 en todas las llamadasLa autorización no terminó o fue desconectada. Ejecuta /mcp (Claude Code) o haz clic para autenticar (Cursor) de nuevo
El navegador no se abreCopia 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 fallarEl límite es de 120 llamadas de herramienta por minuto por conexión. Espera un minuto

Más casos en Problemas comunes.

Relacionados