Server MCP di Badgie: collega Claude, ChatGPT o OpenClaw al tuo club
Come collegare un assistente IA compatibile con MCP (Claude, ChatGPT, OpenClaw, Cursor) a Badgie: URL del server, passaggi per client, autorizzazione OAuth 2.1, cosa può fare ogni ruolo e come si approvano le modifiche.
6 min di letturaIntermedioAggiornata il 2 ottobre 2026
Risposta rapida
Il server MCP di Badgie è il connettore ufficiale che permette a un assistente IA compatibile con MCP (Claude, ChatGPT, OpenClaw, Cursor e altri) di gestire il tuo club via chat. Aggiungi l'URL https://www.badgie.com/api/mcp/mcp al tuo assistente, accedi con il tuo account Badgie, approvi l'accesso (OAuth 2.1) e l'assistente lavora con il tuo ruolo: scuola, istruttore o allievo e famiglia. Non vede mai i dati di un'altra scuola.
In questa guida
Dove si trova
- Pagina pubblica con le istruzioni: badgie.com/mcp (sezione «Conectar»), con la privacy policy del Badgie MCP in fondo. Per ora la pagina è solo in spagnolo.
- URL del server:
https://www.badgie.com/api/mcp/mcp(trasporto HTTP in streaming). - Le proposte del tuo assistente si approvano nel pannello: Super Coach → Control → Pendientes.
Passo dopo passo: collegare il tuo assistente
- Copia l'URL del server:
https://www.badgie.com/api/mcp/mcp. - Aggiungilo al tuo assistente:
- Claude (claude.ai): Impostazioni → Connettori → Aggiungi connettore personalizzato, e incolla l'URL.
- Claude Code: nel terminale,
claude mcp add --transport http badgie https://www.badgie.com/api/mcp/mcp. - ChatGPT (piani a pagamento): Impostazioni → App e connettori → Modalità sviluppatore → Aggiungi connettore, e incolla l'URL.
- OpenClaw, Cursor e altri client MCP: aggiungi alla configurazione
{"mcpServers": {"badgie": {"url": "https://www.badgie.com/api/mcp/mcp", "transport": "http"}}}.
- L'assistente apre l'accesso a Badgie. Entra con l'account che usi in Badgie.
- Nella schermata di consenso vedi quale applicazione chiede l'accesso, con quale ruolo entrerai (account scuola, istruttore o allievo · famiglia) e cosa potrà fare. Premi Aprobar (approva; per ora la schermata è in spagnolo).
- Chiedi prima «chi sono in Badgie?»: l'assistente chiama
whoamie ti mostra ruolo, scuola e che le scritture richiedono la tua approvazione. - Da lì, chiedigli ciò che ti serve in linguaggio naturale.
Cosa può fare ogni ruolo
- Account scuola (direttore): consultare qualsiasi dato del club (debiti, presenze, rischio di abbandono, MRR, occupazione delle prenotazioni), leggere le guide di questa wiki, gestire la memoria del club, il piano di marketing, Content Studio e il Playbook (regole, voce, modelli) e proporre qualsiasi azione di un catalogo di oltre 200 azioni di scrittura (
list_action_catalog,propose_action,list_my_proposals). - Istruttore: le classi di oggi e della settimana, i suoi allievi e i loro progressi, fare l'appello, assegnare badge, lasciare note di allenamento e report in sospeso.
- Allievo e famiglia: profilo, badge, orario, presenze, report, pagamenti e tornei, giri e statistiche di golf, risultati negli esercizi e check-in di nutrizione.
In totale, oltre 120 strumenti MCP.
Come si approvano le modifiche
Le azioni di scrittura del direttore seguono la stessa Delega dell'agente web:
- Area su Auto: l'azione viene eseguita subito e l'assistente ti dà il risultato.
- Area su Sugerir: diventa una proposta in Pendientes, dove la approvi o la rifiuti.
- Area su Off: viene bloccata.
Sicurezza e privacy
- OAuth 2.1: accedi a Badgie e approvi l'accesso; l'assistente non vede mai la tua password.
- Ogni connessione è limitata al tuo account e al tuo ruolo. Non raggiunge mai i dati di un'altra scuola o di un altro allievo.
- La privacy policy del Badgie MCP è su badgie.com/mcp/privacy.
Domande frequenti
Badgie ha un'API REST pubblica o webhook?
No. Badgie non offre un'API REST pubblica con chiavi né webhook in uscita. La via per sviluppatori e integrazioni è questo server MCP e la Badgie CLI.
Con quali assistenti funziona?
Con qualsiasi client compatibile con MCP: Claude (claude.ai e Claude Code), ChatGPT, OpenClaw, Cursor e altri.
Che differenza c'è con l'agente dentro Badgie?
Badgie Agentico vive dentro il web e l'app, con il suo team di specialisti e i crediti. Il server MCP permette al tuo assistente di usare Badgie con i tuoi permessi e la stessa delega.
Compare «Cuenta sin perfil Badgie»?
Hai effettuato l'accesso con un'email non collegata a nessuna scuola, istruttore o allievo. Ricollegati ed entra con l'account che usi in Badgie.
La richiesta è scaduta?
L'autorizzazione deve partire dal tuo assistente. Se la richiesta di autorizzazione non esiste o è scaduta, riavvia la connessione da lì.