Salta al contenuto principale

Hai ancora dubbi su cosa può fare Badgie per il tuo club? Ci vediamo in una demo.

Badgie

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

Server MCP di Badgie: collega Claude, ChatGPT o OpenClaw al tuo club

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
  1. Dove si trova
  2. Passo dopo passo: collegare il tuo assistente
  3. Cosa può fare ogni ruolo
  4. Come si approvano le modifiche
  5. Sicurezza e privacy
  6. Domande frequenti

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.
Sezione Come funziona della pagina pubblica del Badgie MCP
badgie.com/mcp → «Come funziona»: autorizzi con il tuo account, Badgie riconosce il tuo ruolo e lavori via chat.

Passo dopo passo: collegare il tuo assistente

  1. Copia l'URL del server: https://www.badgie.com/api/mcp/mcp.
  2. 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"}}}.
  1. L'assistente apre l'accesso a Badgie. Entra con l'account che usi in Badgie.
  2. 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).
  3. Chiedi prima «chi sono in Badgie?»: l'assistente chiama whoami e ti mostra ruolo, scuola e che le scritture richiedono la tua approvazione.
  4. Da lì, chiedigli ciò che ti serve in linguaggio naturale.
Scheda Claude della sezione Collegare del Badgie MCP con l'URL del server e il comando di Claude Code
«Un server. Tre minuti.»: URL del server e passaggi per Claude e Claude Code.
Scheda ChatGPT della sezione Collegare del Badgie MCP
Scheda ChatGPT: Impostazioni → App e connettori → Modalità sviluppatore → Aggiungi connettore.
Scheda OpenClaw della sezione Collegare del Badgie MCP con la configurazione JSON
Scheda OpenClaw: il blocco di configurazione per OpenClaw, Cursor e altri client MCP.

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ì.