# Collegare Claude Code e Cursor

> Come aggiungere il server MCP di Memberfy in Claude Code (con il comando o con .mcp.json) e in Cursor (con mcp.json), autorizzare nel browser e verificare il collegamento. Per chi lavora nel terminale o nell'editor.

Claude Code e Cursor parlano MCP via HTTP, come Claude e ChatGPT: basta puntarli a **`https://api.memberfy.net/mcp`**. Alla prima chiamata aprono il browser per farti autorizzare con il tuo account Memberfy. Non c'è nessuna chiave da copiare né segreto da conservare nel progetto.

> [!TIP]
> L'indirizzo e questi passaggi si trovano anche nella stessa Memberfy. In **Il Mio Account › Assistenti IA** (`/account?tab=assistants`), o in **Impostazioni › Assistenti IA** (proprietario e admin), il blocco **Collega un assistente** mostra l'**Indirizzo del server MCP** con il pulsante **Copia**, e i passaggi di ogni assistente: **Claude**, **ChatGPT** e **Claude Code / Cursor** (con il comando e il frammento del file, in **Copia il frammento**).

## Claude Code

### Con il comando

Nel terminale, nella cartella del progetto:

```bash
claude mcp add --transport http memberfy https://api.memberfy.net/mcp
```

Perché valga in tutti i tuoi progetti, e non solo in questo, aggiungi `--scope user`.

### Con il file

Oppure crea (o modifica) il `.mcp.json` nella radice del progetto:

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

Il `.mcp.json` può finire nel repository: non contiene nessun segreto. Ogni persona del team autorizza con il proprio account e il proprio ruolo.

### Autorizzare

1. Apri Claude Code e digita `/mcp`.
2. Scegli **memberfy** e l'opzione per autenticarti.
3. Il browser apre la schermata di Memberfy. Accedi, scegli la **community** e clicca **Consenti**.
4. Torna al terminale: il server risulta collegato, con gli strumenti.
5. Fai una prova: *"usa memberfy e dimmi a quale community sei collegato"*.

### Ricette pronte

In Claude Code, le otto ricette di Memberfy diventano comandi: digita `/` e scegli, per esempio, `/mcp__memberfy__monthly_report` (il report del mese) o `/mcp__memberfy__create_course`. L'elenco, e chi vede ciascuna, è in [Ricette pronte nel menu](/mcp/conectar-o-claude#ricette-pronte-nel-menu). Una sessione aperta prima del 6 ottobre 2026 può ancora mostrare i nomi vecchi degli strumenti: apri una nuova sessione.

## Cursor

1. Apri **Cursor Settings › MCP** e aggiungi un server, oppure modifica direttamente il file:
   - `~/.cursor/mcp.json` per tutti i progetti;
   - `.cursor/mcp.json` nella cartella del progetto, solo per quello.
2. Incolla:

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

3. Salva. In **Cursor Settings › MCP**, il server **memberfy** compare chiedendo l'accesso: clicca per autenticarti.
4. Nel browser, accedi a Memberfy, scegli la **community** e clicca **Consenti**.
5. Tornato in Cursor, il server diventa verde, con l'elenco degli strumenti.
6. Nella chat di Cursor (modalità agente), chiedi qualcosa a Memberfy.

## Altri client

Qualsiasi client MCP che supporti il trasporto **HTTP** (*streamable HTTP*) e **OAuth** con rilevamento automatico funziona con lo stesso indirizzo. Il server pubblica tutto ciò che serve al client in `https://api.memberfy.net/.well-known/oauth-protected-resource/mcp`, e il client si registra da solo. I client che parlano solo il trasporto locale (*stdio*) hanno bisogno di un ponte verso HTTP.

## Dettagli tecnici

| | |
|---|---|
| Indirizzo | `https://api.memberfy.net/mcp` (solo `POST`) |
| Trasporto | HTTP, senza sessione: ogni chiamata è indipendente |
| Autorizzazione | OAuth 2.1 con PKCE (`S256`), registrazione dinamica del client |
| Ritorno dell'autorizzazione | qualsiasi `https://`, oppure `http://localhost` / `http://127.0.0.1` per i client locali |
| Scope | `read` e `write` (predefinito: entrambi). Con solo `read`, gli strumenti di creazione e di denaro non compaiono |
| Token di accesso | 1 ora, rinnovato da solo dal client |
| Token di rinnovo | 30 giorni, sostituito a ogni uso |

Altro in [Sicurezza e limiti](/mcp/seguranca).

## Problemi di collegamento

| Cosa succede | Cosa fare |
|---|---|
| `401` in tutte le chiamate | L'autorizzazione non è terminata oppure è stata scollegata. Esegui di nuovo `/mcp` (Claude Code) o clicca di nuovo per autenticarti (Cursor) |
| Il browser non si apre | Copia il link che mostra il client e aprilo a mano |
| *"Questa richiesta di accesso non è valida."* | Rimuovi il server e aggiungilo di nuovo; la registrazione del client potrebbe essere rimasta con un altro indirizzo di ritorno |
| Molte chiamate di fila cominciano a fallire | Il limite è di 120 chiamate di strumenti al minuto per collegamento. Aspetta un minuto |

Altri casi in [Problemi comuni](/mcp/problemas-comuns).

## Correlati

- [Panoramica dell'MCP](/mcp/o-que-e-o-mcp)
- [Strumenti](/mcp/ferramentas)
- [API](/api/introducao): per integrare con il codice, senza assistente