Collega agente IA

Collega Claude, ChatGPT, Grok, Gemini, Cursor o un altro assistente compatibile MCP per gestire la palestra fuori dall'app Sessy — passo dopo passo per il personale non tecnico.

Introduzione

Collega un assistente IA esterno alla tua palestra per chiedergli di controllare il calendario, pianificare sessioni, contattare i membri e altro — con le stesse regole di business dell’app Sessy.

Importante: Quando colleghi uno strumento IA esterno, i dati della palestra e dei membri vengono inviati a quel fornitore IA. Leggi 4. Privacy e sicurezza dei dati prima di iniziare e scegli Limitato — nessun dato iscritti sul token quando l’assistente non ha bisogno dei flussi membri.

Una volta collegato, consulta competenze dell’agente IA per esempi di richieste — pianificazione, messaggi, prenotazioni, programming e altro.

L’assistente IA integrato Sessy (nell’app Sessy) è diverso. Non usa token. Questa pagina riguarda il collegamento di strumenti esterni come Claude o ChatGPT.

In questa pagina

1. Scegliere uno strumento IA adatto

Sessy si collega tramite MCP (Model Context Protocol) — un modo standard per le app IA di integrarsi con altri servizi. Non serve capire MCP; ti basta un’app con un’impostazione MCP, connettore o integrazione dove incollare indirizzo del server e token.

Strumenti IA adatti

Scegli il tipo adatto al tuo team, poi uno strumento che usi già:

Tipo	Ideale per	Esempi
Assistenti chat	La maggior parte del personale — fare domande e delegare compiti in una chat semplice (browser o desktop)	Claude, ChatGPT, Grok, Gemini
Editor con IA	Titolari o coach che lavorano in un’app IA desktop sul computer	Cursor, VS Code + estensione MCP, Windsurf, Zed, Raycast
Agenti di automazione	Configurazioni avanzate — attività programmate, workflow in più passaggi o computer use (l’agente controlla le app sul desktop)	OpenClaw, Hermes Agent, Grok bot — configurazione tecnica; vedi la documentazione MCP di ciascun prodotto

Se uno strumento non è in elenco, funziona solo se la documentazione menziona MCP o Model Context Protocol e consente di aggiungere un URL server personalizzato (https://mcp.sessy.app).

Cosa non funziona

Chat senza connessione — chiedere a ChatGPT o Claude di «accedere alla mia palestra» senza configurare Sessy prima. Senza connessione non vedono i dati Sessy.
WhatsApp, SMS, email o bot sui social — Sessy non si collega così.
La chat IA nell’app Sessy — usa l’app direttamente; nessun token necessario.

2. Creare un token di accesso in Sessy

Accedi come Admin
Apri Configurazione → Token agente IA
Nomina il token, scegli il dipendente, l’accesso token (Admin o Dipendente) e l’accesso ai dati
Copia il token subito — viene mostrato una sola volta
Consegnalo a quel dipendente per il suo strumento IA
Revocalo dalla stessa schermata se perso o non più necessario

Ogni token è per la tua palestra e un dipendente che scegli.

Ti servirà questo token nel passo 3. Indirizzo server per ogni strumento: https://mcp.sessy.app

Preset di accesso ai dati

Quando crei un token, scegli l’accesso ai dati oltre all’accesso token (Admin o Dipendente):

Preset	Quando
Accesso completo	L’assistente deve cercare iscritti, prenotarli, inviare push mirato, vedere presenze o fatturato, o modificare note e tag dei membri
Limitato — nessun dato iscritti	Calendario, programming, catalogo shop, banner palestra, newsletter e configurazione palestra — senza inviare dati personali dei membri all’IA esterna

Limitato è un controllo privacy. Gli strumenti IA esterni ricevono ciò che Sessy restituisce per ogni azione. Con limitato attivo, Sessy blocca strumenti che espongono nomi, email, liste prenotazioni, cronologia presenze, note dello staff, tag, audience push mirato o fatturato — e rimuove gli identificativi iscritti dalle letture calendario.

L’accesso Dipendente non può modificare la configurazione globale della palestra. L’accesso Admin è disponibile solo quando il dipendente selezionato è Admin in Sessy. L’accesso token non può superare il ruolo di quella persona.

Cosa limitato consente ancora

Area	Esempi
Calendario	Vedere il calendario (solo conteggi prenotazioni, non chi è iscritto), creare/aggiornare/eliminare sessioni, riempire una settimana da modelli ricorrenti, assegnare un coach
Programming	Cercare benchmark globali (Fran, Murph, …) e workout propri, collegare `workoutId` alle sessioni per il log risultati, creare workout custom
Banner palestra	`setGeneralMessage` — banner in-app per tutti (nessuna lista membri nella risposta)
Newsletter	Creare, aggiornare, pubblicare o eliminare bozze newsletter (iscritti opt-in; la pubblicazione richiede ancora attenzione)
Catalogo shop	Leggere prodotti e categorie
Riepilogo palestra	Solo conteggio membri tramite `getBoxStats` (nessun nome)
Configurazione	Solo token Admin: sedi, tipi sessione, abbonamenti, articoli/categorie shop, definizioni tag

Cosa limitato non consente

L’assistente non può usare queste capacità finché limitato è attivo:

Non disponibile	Perché
Cercare iscritti per nome o email	Espone dati personali dei membri
Prenotare o disdire un iscritto	Richiede l’identità del membro
Cronologia presenze o report «chi ha allenato insieme»	Dati personali di presenza
Report fatturato	Report finanziari o collegati ai membri
Push mirato (`notifyMembers` a oggi/domani/membri/dipendenti/tutti)	Usa liste membri o outreach personale ampio
Note dello staff e tag membri su singoli	Dati personali dei membri

Usa accesso completo quando il personale ha bisogno di quei flussi. Usa limitato per assistenti che gestiscono solo calendario, programming, banner, newsletter o configurazione palestra — soprattutto collegandosi a un fornitore IA esterno.

Quattro combinazioni (accesso token × accesso dati)

	Dati completi	Limitato — nessun dato iscritti
Token Dipendente	Calendario, programming, comunicazione, ricerca/prenotazione/note membri, report	Calendario, programming, banner, newsletter, lettura shop — nessuna ricerca membri, prenotazione, note, push mirato o fatturato
Token Admin	Tutto ciò che un token Dipendente può fare, più configurazione palestra	Come Dipendente limitato, più configurazione palestra (sedi, tipi sessione, abbonamenti, setup shop)

Quando l’IA si collega, Sessy fornisce una guida integrata access-profile (sessy://skills/access-profile) che elenca gli strumenti esatti consentiti per quel token.

Guide integrate per l’assistente

Sessy fornisce guide di workflow che insegnano all’assistente come funziona la tua palestra. I client compatibili le caricano automaticamente alla connessione.

Guida	Per chi	Scopo
Access profile	Tutti	Inizia qui — strumenti esatti per questo token (ruolo + accesso dati)
Overview	Tutti	Regole d’oro e ordine di lettura
Data model	Dipendente+	Membri, sessioni, abbonamenti, shop
Tools reference	Dipendente+	Tutto ciò che l’assistente può fare
Limits and safety	Dipendente+	Limiti di frequenza, validazione, azioni sensibili
Schedule week	Dipendente+	Pianificare una settimana — programma ricorrente o lezioni singole
Manage sessions	Dipendente+	Modificare, eliminare, ricorrente, riempire settimana da modello
Book member	Dipendente+ · solo dati completi	Prenotare o disdire un iscritto
Program WOD	Dipendente+	Collegare workout tramite `workoutId` — benchmark via ricerca, custom via upsert
Notify members	Dipendente+ · solo dati completi	Notifiche push mirate
Newsletters	Dipendente+	Bozza e pubblicazione
Member notes & tags	Dipendente+ · solo dati completi	Note dello staff e tag
Query and reports	Dipendente+ · solo dati completi	Presenze, fatturato, shop
Configuration	Solo Admin	Configurazione palestra

I token Dipendente vedono tutte le guide tranne Configuration. I token Admin vedono l’insieme completo. I token limitati non ricevono guide per ricerca membri, prenotazione, push mirato, note o report personali — l’access profile elenca cosa si applica.

3. Collegare il tuo strumento IA

Il modo più semplice: incolla questo prompt

Dopo aver creato il token nel passo 2, copia il prompt sotto in Claude, ChatGPT, Grok, Gemini, Cursor o un altro assistente compatibile MCP. Sostituisci YOUR_TOKEN_HERE con il tuo token Sessy. L’IA può guidarti nell’aggiungere la connessione sul tuo computer.

Incolla il token solo in uno strumento di fiducia.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


Connect me to Sessy (my gym admin platform).

- Server URL: https://mcp.sessy.app
- Transport: Streamable HTTP (JSON-RPC POST)
- Auth: Bearer token in the Authorization header
- My token: YOUR_TOKEN_HERE

Add this connection in my environment (Claude MCP settings, ChatGPT custom connector, Cursor mcp.json, Grok or Gemini MCP settings, OpenClaw/Hermes MCP config, or equivalent). Use the token only for this connection.

When you are done, confirm it works by listing the available Sessy tools.

Poi chiedi qualcosa di semplice, ad esempio:

«Quali strumenti Sessy hai?»
«Mostra le sessioni di questa settimana.» (se il token consente l’accesso al calendario)

Se non vede Sessy, controlla il token, che la connessione sia attiva e che tu abbia avviato una nuova chat dopo aver salvato le impostazioni.

Configurazione manuale

Preferisci configurare la connessione da solo, o il prompt non ha funzionato? Usa i passaggi per il tuo strumento sotto. Ovunque vale lo stesso principio: aggiungi Sessy come connessione personalizzata, incolla l’indirizzo server https://mcp.sessy.app e il token, poi salva.

Claude (consigliato per utenti non tecnici)

Nel browser (claude.ai):

Apri claude.ai e accedi.
Apri Impostazioni (menu profilo).
Cerca Connettori, Integrazioni o MCP — il nome varia per tipo di account.
Aggiungi un connettore personalizzato o server MCP.
Incolla l’URL https://mcp.sessy.app e il token Sessy per l’autenticazione (Bearer token o chiave API).
Salva e avvia una nuova chat. Chiedi: «Cosa puoi fare con la mia palestra Sessy?»

Claude desktop: stessi passaggi — Impostazioni → Connettori / MCP → server personalizzato con URL e token.

ChatGPT

Apri chat.openai.com e accedi (spesso serve piano a pagamento per i connettori).
Impostazioni → Connettori o Apps (il nome può variare).
Aggiungi un connettore personalizzato o connessione MCP.
URL server: https://mcp.sessy.app — autenticazione: il tuo token Sessy.
Salva, apri una nuova chat e prova.

Grok

Apri grok.com (o la tua app xAI) e accedi.
Apri Impostazioni e cerca MCP, connettori o integrazioni.
Aggiungi un server MCP personalizzato con URL https://mcp.sessy.app e il token Sessy come autenticazione Bearer.
Salva e avvia una nuova chat per testare.

Gemini

Apri gemini.google.com e accedi.
Impostazioni → Estensioni, Apps o MCP (il nome varia per piano e regione).
Aggiungi una connessione personalizzata con URL server https://mcp.sessy.app e il token Sessy.
Salva e testa in una nuova chat.

Cursor

Installa Cursor e accedi.
Apri Cursor Settings → MCP (o modifica il file di configurazione MCP quando richiesto).
Aggiungi un server chiamato sessy con URL https://mcp.sessy.app e il token nell’header Authorization.
Nel pannello chat, verifica che compaiano strumenti Sessy quando chiedi della palestra.

OpenClaw, Hermes Agent o Grok bot

Sono per configurazioni avanzate — automazioni, attività programmate o controllo di app sul computer. Aggiungi Sessy come server MCP nella configurazione di quel prodotto:

URL: https://mcp.sessy.app
Auth: Bearer token = il tuo token Sessy

Vedi la documentazione MCP OpenClaw, la guida MCP Hermes Agent o la documentazione del tuo fornitore Grok bot. Aspettati una configurazione più tecnica rispetto a Claude o ChatGPT.

Altre app MCP

Per Windsurf, Zed, VS Code, Raycast o simili: apri le impostazioni MCP o Integrazioni di quell’app e aggiungi URL e token sopra. Consulta le pagine di aiuto dell’app per «MCP» o «custom server» se i nomi del menu differiscono.

4. Privacy e sicurezza dei dati

I dati personali escono da Sessy

Quando il tuo assistente IA usa Sessy per tuo conto, i dati della palestra e dei membri vengono inviati al servizio IA che scegli — ad esempio Anthropic, OpenAI, xAI, Google o Cursor. Possono includere:

Nomi e email dei membri
Presenze e cronologia prenotazioni
Note dello staff e tag membri
Titolo e testo dei messaggi che invii
Riepiloghi di fatturato e altri report

Sessy non controlla come quel fornitore esterno archivia, elabora o usa questi dati. Sei responsabile di:

Scegliere un servizio IA di cui ti fidi
Verificare che termini, trattamento dati e (se applicabile) opzioni enterprise / DPA rispettino gli obblighi GDPR e altre norme per la tua palestra
Dare i token solo al personale che ne ha bisogno e revocarli quando non servono più
Usare Limitato — nessun dato iscritti quando l’assistente non ha bisogno dei flussi membri (meno dati personali inviati all’IA esterna)

L’assistente IA integrato Sessy mantiene l’elaborazione nell’infrastruttura propria di Sessy. Collegare un agente IA esterno è una scelta deliberata di condividere dati con terzi.

Se non sei sicuro che un fornitore sia adatto ai dati dei tuoi membri, non collegare finché non ne parli con il tuo consulente legale o privacy.

Token e limiti di utilizzo

Tratta i token come password — chi ha il token può agire come quel dipendente nella tua palestra
Stesse regole di validazione dell’app (tipi sessione, sedi, finestra di pianificazione e altro)
Assistente in-app (per palestra): 60 richieste chat al minuto; 30 modifiche confermate al minuto, 500 al giorno (UTC) e 200 al mese di calendario
Limiti di scrittura MCP (per token): 30 mutazioni al minuto e 500 al giorno (UTC). Pianificare un’intera settimana da modelli ricorrenti conta come una scrittura; copiare una vecchia settimana sessione per sessione può raggiungere subito il limite
I token non possono eliminare la palestra, assegnare ruoli Admin o modificare la fatturazione piattaforma
Messaggi di massa a tutti i membri o pubblicazione newsletter richiedono particolare attenzione

Documentation