# Problemi comuni

> Cosa fare quando l'assistente non si collega, perde il collegamento, non mostra uno strumento, agisce nella community sbagliata o rifiuta una conferma di denaro o di eliminazione, e cosa l'MCP non fa ancora.

I problemi più comuni con l'MCP, con la causa e come risolverli. Per il passo per passo di ogni assistente, vedi [Collegare Claude](/mcp/conectar-o-claude), [Collegare ChatGPT](/mcp/conectar-o-chatgpt) e [Collegare Claude Code e Cursor](/mcp/conectar-claude-code-e-cursor).

## Il collegamento

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

L'assistente non ha una chiave valida.

| Causa | Cosa fare |
|---|---|
| L'autorizzazione non è terminata (la finestra è stata chiusa prima di **Consenti**) | Collegati di nuovo dall'assistente |
| Hai scollegato in **Il Mio Account › Assistenti IA**, oppure un admin ha scollegato in **Impostazioni** | Collegati di nuovo, se ha senso |
| Il collegamento è rimasto inutilizzato per più di 30 giorni | Collegati di nuovo |
| Sei uscito dalla community | Il collegamento non serve più; chiedi di rientrare nella community |
| Memberfy ha fatto cadere il collegamento per sicurezza (è ricomparsa una chiave già usata) | Collegati di nuovo. Se succede ancora, rimuovi il connettore e aggiungilo da zero |

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](/mcp/ferramentas#quanti-strumenti-vede-ogni-ruolo).

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](/mcp/ferramentas).

### 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](/api/referencia/mcp/get-oauth-connections-by-id-diagnostics), ancora senza una schermata nel pannello. Vedi [Versione del server e dell'elenco](/mcp/ferramentas#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](/mcp/autorizar-e-desconectar#cambiare-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"*

| Causa | Cosa fare |
|---|---|
| Sono passati più di 10 minuti tra il riepilogo e il tuo sì | Chiedi di nuovo: l'assistente genera un nuovo riepilogo |
| L'assistente ha cambiato qualche valore nella seconda chiamata | Chiedi di nuovo; controlla che il nuovo riepilogo abbia i valori giusti |
| Il codice è già stato usato (l'azione è già avvenuta) | Controlla nel pannello prima di chiedere di nuovo, per non duplicare |

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

| Non si può ancora | Per ora |
|---|---|
| Salvare il contenuto di una lezione (testo, video) | L'assistente crea la lezione con titolo, tipo e durata; il contenuto si inserisce dal pannello |
| Modificare o eliminare moduli e lezioni | Dal pannello |
| Programmare un post | Il post esce subito |
| Iscrivere chi ha comprato il biglietto alla lista dei partecipanti | L'acquisto sblocca lo spazio; la presenza la conferma la persona |
| Rimborsare | Dal pannello |
| Cambiare il piano di un altro abbonato | Solo chi è abbonato cambia il proprio piano, dalla [Fatturazione](/pagamentos/faturamento-do-membro#cambiare-piano) o con `change_my_plan` |
| Moderare più elementi in una sola chiamata | L'assistente modera un elemento alla volta, con `moderate_item` |
| Cambiare il dominio, la lingua e le integrazioni della community | Dal pannello |
| Eliminare qualsiasi cosa | Dal pannello |

## Correlati

- [Panoramica dell'MCP](/mcp/o-que-e-o-mcp)
- [Sicurezza e limiti](/mcp/seguranca)
- [Strumenti](/mcp/ferramentas)