MoveMentors espone un server Model Context Protocol (MCP). Se usi Claude, ChatGPT (con integrazioni Claude API), Cursor o qualsiasi altro assistente AI compatibile con MCP, puoi collegarli al tuo account per chiedere cose come:
- "Quali sono le mie prenotazioni della prossima settimana?"
- "Cancella la mia lezione di sabato e manda un'email a tutti quelli che l'hanno prenotata."
- "Aggiungi una lezione di yoga il martedì mattina allo stesso prezzo di quella del giovedì."
- "Manda un messaggio di ringraziamento ai clienti che hanno partecipato negli ultimi 30 giorni."
Il server MCP è disponibile in modo generale per gli account Pro e Premium.
Cos'è MCP
Il Model Context Protocol è uno standard aperto che permette agli assistenti AI di comunicare con strumenti esterni. Originariamente creato da Anthropic (la società di Claude); ora adottato da ChatGPT, Cursor e altri.
Per MoveMentors, MCP significa che il tuo assistente AI può:
- Vedere le tue prenotazioni, lezioni, clienti (accesso in lettura).
- Creare nuove prenotazioni, modificare lezioni, inviare messaggi (accesso in scrittura).
- Tutto controllato dalle autorizzazioni OAuth che concedi.
Come funziona
- Vai nelle impostazioni del tuo assistente AI (Claude Desktop, ChatGPT, ecc.) e aggiungi MoveMentors come server MCP.
- L'assistente apre un flusso OAuth nel tuo browser.
- Accedi a MoveMentors e concedi autorizzazioni specifiche (leggere prenotazioni, scrivere lezioni, ecc.).
- L'assistente ottiene un token che include nelle richieste.
- Ora puoi chiedere all'assistente di fare cose sul tuo account.
Nessuna chiave API, nessuna credenziale in chiaro. OAuth gestisce l'autenticazione.
Collegare Claude Desktop
Apri Claude Desktop
L'app desktop di Claude.
Vai in Impostazioni → Sviluppatore
Cerca la sezione "MCP servers".
Aggiungi un nuovo server MCP
Clicca "Add server" e scegli "Connect via OAuth".
Inserisci l'URL MCP di MoveMentors
https://movementors.com/api/mcpAutorizza
Claude apre una finestra del browser. Accedi a MoveMentors e vedi una schermata di consenso che elenca le autorizzazioni richieste.
Scegli quali autorizzazioni concedere
Puoi negare scope specifici se vuoi limitare cosa può fare Claude. Per esempio, puoi concedere "read bookings" ma negare "write classes" se vuoi che Claude consulti senza modificare.
Clicca 'Approva'
Torni a Claude. Il server è ora collegato.
Inizia a usarlo
Parla a Claude come al solito. Ora ha gli strumenti per consultare e modificare il tuo account MoveMentors.
Collegare ChatGPT
ChatGPT supporta server MCP tramite l'API Anthropic con Claude come modello. L'interfaccia esatta è diversa da Claude Desktop ma il flusso OAuth è lo stesso.
Se il tuo assistente AI supporta MCP, avrà un'opzione analoga "Add MCP server" da qualche parte. L'URL è sempre https://movementors.com/api/mcp.
Strumenti disponibili (cosa può fare l'AI)
Il server MCP espone circa 20 strumenti. Alcuni dei principali:
whoami: chi è l'utente corrente (restituisce le info del tuo account).search_mentors,search_studios,search_classes: consulta la directory pubblica.get_mentor: ottieni il profilo completo di un mentor specifico.list_my_bookings: le tue prenotazioni (come studente o host).book_class: crea una prenotazione.cancel_booking: cancella una prenotazione.list_my_classes: le tue lezioni ospitate.update_class,delete_class: modifica le lezioni ospitate.add_class_schedule: aggiungi una sessione a una lezione esistente.list_class_bookings: chi è prenotato a una sessione specifica.financials_summary: riepilogo dei tuoi guadagni.list_expenses,create_expense,update_expense,delete_expense: tracking delle spese.send_mentor_inquiry: invia un messaggio diretto.list_received_mentor_inquiries: vedi i messaggi in arrivo.
L'assistente sceglierà lo strumento giusto per la tua richiesta. Non devi conoscere i nomi degli strumenti.
Autorizzazioni e scope
Le autorizzazioni sono granulari. Puoi concedere o negare ogni scope individualmente durante il flusso OAuth. Vedi OAuth scopes per la lista completa e cosa permette ciascuno.
Raggruppamenti comuni di scope:
- Sola lettura: vedi tutto, non cambi niente. Utile per testare.
- Gestione prenotazioni: vedi e modifichi prenotazioni, ma non le lezioni.
- Controllo completo: tutto.
Puoi revocare le autorizzazioni in qualsiasi momento da /settings/connected-apps.
Casi d'uso
"Mostrami la mia prossima settimana"
L'assistente usa list_my_bookings e list_my_classes per recuperare una settimana di eventi, organizzati per giorno. Tu fai domande di follow-up come "quali sono ancora in attesa di pagamento?".
"Cancella sabato e rimborsa tutti"
L'assistente usa list_class_bookings per ottenere le prenotazioni interessate, poi cancel_booking su ciascuna. I rimborsi per i pagamenti Stripe sono processati automaticamente.
"Aggiungi una nuova lezione simile a quella del martedì ma il giovedì"
L'assistente usa get_class per recuperare i dettagli della lezione del martedì, poi create_class con gli stessi campi ma un calendario diverso.
"Qual è stato il mio mese migliore di guadagni?"
L'assistente usa financials_summary per recuperare i totali mese per mese e riporta i risultati.
"Manda un messaggio di ringraziamento a tutti quelli che hanno partecipato lo scorso weekend"
L'assistente usa list_my_bookings filtrato all'ultimo weekend con stato COMPLETED, poi send_mentor_inquiry o simile per inviare note personalizzate a ciascuno.
Sicurezza
Alcune cose da sapere:
Gli scope OAuth sono il limite
L'assistente non può fare nulla al di fuori degli scope che hai concesso. Se hai concesso solo accesso in lettura, i tentativi di scrittura restituiscono errori di autorizzazione.
Ogni richiesta viene registrata
Registriamo ogni richiesta MCP: quale strumento, quali argomenti, il risultato. Visibile in /settings/audit-log. Utile se vuoi sapere cosa ha fatto l'assistente.
I token possono essere revocati
/settings/connected-apps mostra ogni client OAuth collegato. Revoca in qualsiasi momento; l'assistente perde immediatamente l'accesso.
Limiti di velocità
Limitiamo la velocità per token. Un assistente normale che fa richieste conversazionali resta ben al di sotto. Un assistente che cerca di recuperare tutto il tuo storico prenotazioni in una volta potrebbe colpire i limiti; riprova con backoff.
Sandboxing
La maggior parte dei client MCP (Claude Desktop, ecc.) gira come processo separato. Non possono leggere altri tuoi file o dirottare il tuo browser. La connessione a noi è su HTTPS con autenticazione tramite token.
Limiti
Alcuni strumenti sono limitati:
book_class: richiede il piano Pro. Il piano free espone solo la lettura.update_class,delete_class,add_class_schedule: piano Pro.financials_summarye gli strumenti spese: piano Pro.
Se sei su free e provi a usare uno strumento limitato, ricevi un errore chiaro dall'assistente.
Domande frequenti
L'assistente condividerà i miei dati con altri? L'assistente gira in locale (Claude Desktop) o nell'ambiente del tuo provider (Claude.ai web). I dati che legge da MoveMentors restano nella tua conversazione; non vengono condivisi con altri utenti.
La privacy policy di Anthropic si applica a ciò che fa con i dati della tua conversazione. Noi non controlliamo questo.
L'assistente può vedere la mia password? No. OAuth significa che l'assistente non vede mai la tua password. Ha un token che può essere revocato.
L'assistente può fare cose alle mie spalle? L'assistente agisce solo quando glielo dici (in conversazione). Non gira in background a meno che tu non imposti un'automazione. Ogni azione è registrata.
E se l'assistente fa un errore? Puoi rivedere l'audit log e annullare la maggior parte delle azioni:
- Le prenotazioni cancellate possono essere riprenotate (se i posti sono ancora disponibili).
- Le lezioni eliminate possono essere ricreate (l'assistente ha i dati).
- I messaggi inviati non possono essere ritirati.
Tratta l'assistente come un dipendente junior con accesso. Fidati ma verifica.
Il supporto MCP migliorerà nel tempo? Sì. Aggiungiamo nuovi strumenti man mano che MCP stesso evolve. Iscriviti alla nostra newsletter o controlla il changelog per gli aggiornamenti.
Prossimi passi
- OAuth scopes: il modello delle autorizzazioni.
- Provalo: collega Claude Desktop e chiedi "mostrami la mia prossima settimana".