Cos'è un'app fitness MCP?

Cos'è MCP, in parole semplici

Il Model Context Protocol (MCP) è un protocollo aperto introdotto da Anthropic nel 2024. Definisce un modo standard per un assistente AI di scoprire, collegarsi e usare strumenti e fonti di dati esterni — cose come il tuo calendario, un editor di codice o un'app fitness. Invece di far inventare a ogni strumento il proprio formato di integrazione, MCP dà agli sviluppatori un'unica interfaccia comune e dà ai client AI un unico modo comune per usarla.

Pensalo come un adattatore universale. Prima di MCP, collegare un'AI a una nuova fonte di dati significava codice su misura su entrambi i lati. Con MCP, un server compatibile (il "connettore MCP") e un client compatibile (Claude, ChatGPT o qualsiasi AI che supporti il protocollo) possono comunicare tra loro senza configurazioni.

Perché MCP esiste

Gli assistenti AI sono più utili quando hanno un contesto accurato e aggiornato su di te e sulla tua situazione. Senza un modo standard per recuperare quel contesto, ogni integrazione doveva essere costruita da zero dallo sviluppatore dell'app e dal fornitore dell'AI, poi mantenuta separatamente su entrambi i lati.

MCP risolve il problema permettendo a un'applicazione esterna di esporre un insieme di strumenti — operazioni di lettura, operazioni di ricerca e, facoltativamente, operazioni di scrittura o proposta — tramite un'interfaccia standard. L'AI può quindi scoprire quegli strumenti automaticamente e richiamarli per tuo conto quando le affidi un compito.

Il principio di design chiave è che il controllo resta a te. L'AI non ottiene una chiave universale del tuo account. Ottiene esattamente i permessi che concedi quando autorizzi la connessione, e puoi revocarli in qualsiasi momento.

MCP vs una normale API

Una normale API è un'interfaccia grezza pensata per gli sviluppatori. Per usare l'API di un'app fitness dovresti leggere la sua documentazione, scrivere codice di autenticazione, costruire richieste HTTP, interpretare le risposte e gestire gli errori. È potente ma richiede conoscenze tecniche e manutenzione continua.

MCP è uno strato sopra tutto questo. Impacchetta le capacità di un'API in un formato scopribile e auto-descrittivo che un assistente AI può comprendere e usare per tuo conto — senza che tu scriva una sola riga di codice. Colleghi semplicemente l'app nelle impostazioni del tuo client AI e inizi a porre domande in linguaggio naturale.

MCP vs incollare i dati di allenamento in chat

Molte persone attualmente aggirano la mancanza di integrazione esportando i dati dalla propria app e incollandoli in una finestra di chat. Funziona, ma ha limiti concreti.

• Manuale e ripetitivo. Devi esportare e incollare ogni volta che vuoi un'analisi aggiornata.
• Statico. L'AI vede un'istantanea. Se hai registrato una sessione due ore fa, quel dato non c'è a meno che tu non incolli di nuovo.
• Parziale. Puoi incollare solo ciò che ti ricordi di includere. Un connettore MCP permette all'AI di recuperare esattamente i dati aggiornati che le servono, in tempo reale, quando lo chiedi.
• Senza struttura. Le esportazioni in testo libero perdono le relazioni precise tra serie, ripetizioni, carichi e date. Uno strumento MCP restituisce dati strutturati su cui l'AI può ragionare accuratamente.

Una connessione MCP non è magia — dipende comunque dalla qualità dei dati nell'app. Ma elimina l'attrito del ciclo manuale di esportazione e dà all'AI una vista coerente e strutturata del tuo storico di allenamento ogni singola volta.

Cosa ti permette di fare un'app fitness MCP

Una volta collegata un'app fitness tramite MCP, puoi porre al tuo assistente AI domande e affidargli compiti che prima avrebbero richiesto o un'integrazione su misura o molto copia-incolla. L'AI può recuperare dati in tempo reale dall'app, ragionarci sopra e darti una risposta fondata e specifica.

Con il connettore MCP di SammaGym, un'AI collegata può leggere:

• Il tuo riepilogo allenamento: sessioni registrate, volume totale, volume per gruppo muscolare, costanza settimanale.
• Il tuo programma attivo: giornate, esercizi, serie, ripetizioni, obiettivi di intensità.
• I tuoi progressi di forza: 1RM stimato nel tempo, migliori serie per esercizio, andamento del peso corporeo.
• Il dettaglio di una giornata specifica: ogni serie registrata con carico e ripetizioni.
• Le metriche di cardio e corsa: distanza, passo, velocità, calorie, flag indoor o outdoor.
• I risultati degli allenamenti a tempo: round e punteggi di AMRAP, EMOM, Tabata e For Time.

L'AI può anche proporre un programma nuovo o modificato — incluse serie di riscaldamento, tecniche di intensità come drop set o pause, schemi di ripetizioni a piramide, giornate a tempo ed esercizi personalizzati. La proposta ha effetto solo dopo che la rivedi e l'approvi con un singolo tocco nella schermata Proposte dell'app. Nulla cambia nel tuo programma senza la tua conferma esplicita.

È sicuro?

Sicurezza e privacy sono preoccupazioni legittime ogni volta che colleghi un servizio di terze parti ai tuoi dati personali. Ecco come il modello MCP le affronta.

• Flusso di consenso OAuth. Autorizzi l'accesso tramite un flusso OAuth standard — lo stesso meccanismo usato da "Accedi con Google" o "Collega a Strava". Il client AI non vede mai la tua password.
• Revocabile in qualsiasi momento. Puoi scollegare il connettore dalle impostazioni del tuo client AI. L'accesso viene revocato immediatamente.
• Minimizzazione dei dati. Le coordinate GPS del percorso non lasciano mai il tuo dispositivo. Il connettore espone metriche aggregate (distanza, passo, calorie) ma non la traccia GPS grezza, in linea con i principi di minimizzazione dei dati del GDPR.
• Solo HTTPS. Tutte le comunicazioni tra il client AI e il server MCP viaggiano su HTTPS cifrato.
• Scritture supervisionate. Il connettore non modifica silenziosamente il tuo programma. Qualsiasi modifica proposta emerge come una Proposta che devi approvare.

Come SammaGym implementa MCP

SammaGym espone un connettore MCP remoto su https://app.sammagym.com/api/mcp. Il server implementa la specifica MCP e descrive gli strumenti disponibili così che qualsiasi client AI compatibile possa scoprirli e usarli senza configurazioni aggiuntive.

Per collegarti, ti serve un piano AI che supporti i connettori MCP personalizzati — per esempio Claude Pro, Claude Max o Claude Team; oppure ChatGPT con la modalità sviluppatore abilitata. La configurazione è un'autorizzazione OAuth con un clic, una tantum. Dopodiché, puoi chiedere al tuo assistente AI del tuo allenamento in linguaggio naturale e lui richiamerà automaticamente gli strumenti rilevanti.

SammaGym è gratis — disponibile come PWA web, su iOS e su Android, senza abbonamento richiesto per usare l'app in sé. Il connettore MCP fa parte della stessa app gratuita.

Il connettore è stato costruito con una netta separazione tra operazioni di lettura e operazioni di scrittura. Gli strumenti di lettura restituiscono i dati attuali all'istante. Le operazioni di scrittura — proporre un nuovo programma o una modifica a quello attuale — sono progettate in modo che l'AI rediga la proposta ma l'app la applichi solo dopo il tuo tocco esplicito. Questo mantiene la persona nel ciclo per qualsiasi modifica che riguardi il tuo allenamento reale.