Problemi comuni

I problemi più comuni con l'MCP, con la causa e come risolverli. Per il passo per passo di ogni assistente, vedi Collegare Claude, Collegare ChatGPT e Collegare Claude Code e Cursor.

#Il collegamento

#"Non autorizzato", 401 o "token scaduto"

L'assistente non ha una chiave valida.

La chiave di accesso dura 1 ora e si rinnova da sola; se l'assistente chiede spesso di ricollegarsi, rimuovi il connettore e aggiungilo di nuovo.

#"Questa richiesta di accesso non è valida"

La schermata di autorizzazione ha ricevuto una richiesta incompleta, o da un indirizzo di ritorno che non corrisponde. Rimuovi il connettore nell'assistente, aggiungilo di nuovo e collegati.

#La community non compare nella schermata di autorizzazione

L'account con cui hai effettuato l'accesso non ne fa parte. Esci da Memberfy nel browser e accedi con l'account giusto prima di collegarti.

#Gli strumenti

#Uno strumento non compare

L'assistente vede solo gli strumenti che il tuo ruolo può usare. Un moderatore non vede create_plan; un membro non vede list_members; il ruolo Finanza non vede request_payout. Verifica il tuo ruolo con "a quale community e con quale ruolo sei collegato?" e confronta con Strumenti.

Altre cause:

• Il collegamento è stato autorizzato solo in lettura: quelli di creazione e di denaro non compaiono. Collegati di nuovo con lettura e scrittura.
• Il connettore è disattivato nella conversazione (Claude) o non è stato selezionato (ChatGPT).

#L'assistente usa nomi vecchi, come criar_post

Il 6 ottobre 2026 gli strumenti hanno preso nomi in inglese (create_post, list_spaces, issue_certificate). Una conversazione aperta prima può restare con l'elenco vecchio, e la chiamata fallisce perché lo strumento non esiste più. Apri una nuova conversazione; se non basta, ricollega il connettore. I nomi attuali sono in Strumenti.

#Manca uno strumento, o l'assistente dice che non esiste

Alcuni assistenti tengono l'elenco degli strumenti di Memberfy dall'inizio della conversazione. Se Memberfy ha aggiornato il server dopo, l'assistente resta con l'elenco vecchio: non vede uno strumento nuovo, o prova a usarne uno che ha cambiato nome.

1. Apri una nuova conversazione.
2. Se non basta, scollega e ricollega il connettore di Memberfy nell'assistente.

Quando l'assistente prova a usare uno strumento che ha cambiato nome o che non è nel suo elenco, Memberfy lo segnala nella risposta stessa: indica il nome nuovo, oppure chiede di aprire una nuova conversazione o di ricollegarsi.

Il proprietario e gli amministratori della community possono vedere quale versione dell'elenco ha ricevuto ogni connessione e se è aggiornata. Per ora si trova nell'API, nella diagnostica della connessione, ancora senza una schermata nel pannello. Vedi Versione del server e dell'elenco.

#"Il tuo ruolo (…) non consente questa azione in questa community."

Lo strumento compare, ma quell'azione specifica viene rifiutata. Esempi:

• un membro che pubblica in uno spazio con Chi può pubblicare = Staff;
• un moderatore che usa create_event con biglietto, o senza indicare uno spazio esistente;
• un'azione in uno spazio che il tuo ruolo non vede.

#"L'API ha rifiutato (400): …"

Un valore non valido: un prezzo a zero, un titolo troppo corto, una data senza fuso orario, l'id di un'altra cosa. Il messaggio indica quale campo. Chiedi all'assistente di correggere e riprovare.

#Un composto è fallito a metà

La risposta indica quale passaggio è fallito e che tutto è stato annullato. Correggi la causa (per esempio, usa uno spazio del modulo giusto) e chiedi di nuovo. Se la risposta dice che qualcosa non è stato possibile annullarlo, controlla l'elemento elencato nel pannello ed eliminalo a mano.

#"Troppe chiamate in poco tempo"

Il limite è di 120 chiamate di strumenti al minuto per collegamento. Succede nelle richieste grandi (rispondere a 200 commenti in una volta). Aspetta un minuto, o chiedi a pezzi.

#La community sbagliata

L'assistente ha creato qualcosa nella community sbagliata perché era collegato a quella. Ogni collegamento è di una sola community.

1. Chiedi: "a quale community sei collegato?".
2. Disattiva nella conversazione il connettore della community sbagliata e attiva quello giusto. Se non c'è, crea un collegamento per l'altra community.
3. Elimina dal pannello ciò che è stato creato nel posto sbagliato (non esiste uno strumento per eliminare).

Per evitarlo: dai nomi chiari ai connettori (Memberfy · Scuola, Memberfy · Coworking) e lascia attivo solo uno per conversazione.

#La conferma di denaro ed eliminazioni

#"Conferma non valida, scaduta, già usata o con argomenti diversi"

#L'assistente ha eseguito senza chiedere

Gli strumenti che toccano il denaro o eliminano restituiscono sempre prima un riepilogo. Se l'assistente è andato avanti senza mostrarlo, non ha seguito le istruzioni. Controlla nel pannello cosa è stato fatto, scollegalo e ricollegalo, e di' esplicitamente all'inizio della conversazione: "mostrami sempre il riepilogo prima di confermare qualsiasi cosa che riguardi denaro o eliminazioni".

Inviti, cambio di ruolo, impostazioni e rilascio di certificati non chiedono la conferma di Memberfy: vengono eseguiti alla prima chiamata. Se vuoi rivederli prima, chiedi "mostrami prima di farlo", e lascia questi strumenti su "chiedi prima" nei permessi dell'assistente.

#Cosa non si può ancora fare

L'MCP non copre ancora tutto ciò che fa il pannello. Queste cose arriveranno più avanti, e per ora restano nel pannello:

#Correlati

• Panoramica dell'MCP
• Sicurezza e limiti
• Strumenti