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
- Apri Claude Code e digita
/mcp. - Scegli memberfy e l'opzione per autenticarti.
- Il browser apre la schermata di Memberfy. Accedi, scegli la community e clicca Consenti.
- Torna al terminale: il server risulta collegato, con gli strumenti.
- 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
- Apri Cursor Settings › MCP e aggiungi un server, oppure modifica direttamente il file:
~/.cursor/mcp.jsonper tutti i progetti;.cursor/mcp.jsonnella cartella del progetto, solo per quello.
- Incolla:
{
"mcpServers": {
"memberfy": {
"url": "https://api.memberfy.net/mcp"
}
}
}
- Salva. In Cursor Settings › MCP, il server memberfy compare chiedendo l'accesso: clicca per autenticarti.
- Nel browser, accedi a Memberfy, scegli la community e clicca Consenti.
- Tornato in Cursor, il server diventa verde, con l'elenco degli strumenti.
- 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.
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.
Correlati
- Panoramica dell'MCP
- Strumenti
- API: per integrare con il codice, senza assistente