# 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.

> [!TIP]
> 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:

```bash
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:

```json
{
  "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ú](/mcp/conectar-o-claude#recetas-listas-en-el-menu). 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:

```json
{
  "mcpServers": {
    "memberfy": {
      "url": "https://api.memberfy.net/mcp"
    }
  }
}
```

3. Guarda. En **Cursor Settings › MCP**, el servidor **memberfy** aparece pidiendo inicio de sesión: haz clic para autenticar.
4. En el navegador, inicia sesión en Memberfy, elige la **comunidad** y haz clic en **Permitir**.
5. De vuelta en Cursor, el servidor se pone en verde, con la lista de herramientas.
6. 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](/mcp/seguranca).

## 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](/mcp/problemas-comuns).

## Relacionados

- [Visión general del MCP](/mcp/o-que-e-o-mcp)
- [Herramientas](/mcp/ferramentas)
- [API](/api/introducao): para integrar con código, sin asistente