Vai al contenuto

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.

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:

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:

{
  "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. 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:
{
  "mcpServers": {
    "memberfy": {
      "url": "https://api.memberfy.net/mcp"
    }
  }
}
  1. Salva. In Cursor Settings › MCP, il server memberfy compare chiedendo l'accesso: clicca per autenticarti.
  2. Nel browser, accedi a Memberfy, scegli la community e clicca Consenti.
  3. Tornato in Cursor, il server diventa verde, con l'elenco degli strumenti.
  4. 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

Indirizzohttps://api.memberfy.net/mcp (solo POST)
TrasportoHTTP, senza sessione: ogni chiamata è indipendente
AutorizzazioneOAuth 2.1 con PKCE (S256), registrazione dinamica del client
Ritorno dell'autorizzazionequalsiasi https://, oppure http://localhost / http://127.0.0.1 per i client locali
Scoperead e write (predefinito: entrambi). Con solo read, gli strumenti di creazione e di denaro non compaiono
Token di accesso1 ora, rinnovato da solo dal client
Token di rinnovo30 giorni, sostituito a ogni uso

Altro in Sicurezza e limiti.

Problemi di collegamento

Cosa succedeCosa fare
401 in tutte le chiamateL'autorizzazione non è terminata oppure è stata scollegata. Esegui di nuovo /mcp (Claude Code) o clicca di nuovo per autenticarti (Cursor)
Il browser non si apreCopia 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 fallireIl limite è di 120 chiamate di strumenti al minuto per collegamento. Aspetta un minuto

Altri casi in Problemi comuni.

Correlati