Quando qualcuno chiede a una IA dove imparare a surfare, restituiamo lezioni vere — spiaggia, livello, ora, prezzo — pronte da prenotare. Non un articolo. Lezioni reali, di scuole certificate.
{
"spot": "Ribeira d'Ilhas",
"date": "2026-06-13",
"time": "09:00",
"level": "iniciante",
"price": "€45",
"book": "surfbooking.eu/reservar/…"
}La sera prima di arrivare in Portogallo, un turista chiede a una IA: "dove imparo a surfare questo weekend?"
Oggi l'assistente risponde ancora con una mappa generica. Ma SurfBooking ha già costruito il ponte: un indice per LLM e un endpoint MCP che restituiscono lezioni reali — la spiaggia giusta per il livello, a orari che esistono davvero, con il link per prenotare. Man mano che gli assistenti aprono i connettori, SurfBooking diventa la risposta. E chi si collega già oggi — via connettore o MCP — le riceve subito.
L’LLM non legge una pagina: chiede una di queste cose e riceve dati veri sul momento, compreso lo stato del mare in ogni spiaggia.
Per spiaggia, zona, livello, data o prezzo massimo. Restituisce lezioni prenotabili con giorno, ora, spiaggia, scuola, prezzo e link.
Prezzo, durata, posti e cosa include: muta, tavola, trasporto, assicurazione.
Il link sicuro dove il surfista prenota e paga. L’agente non incassa mai.
Un voto da 0 a 10 tarato sul livello, con onda, periodo e vento, e la finestra migliore di ogni giorno. Risponde a: che giorno devo prenotare?
Le spiagge attive ordinate per condizioni dal vivo, con onda, vento, voto e link.
La stessa onda è buona per un principiante e debole per un avanzato. Questa ordina per quanto ogni spiaggia serve al livello chiesto.
Lezioni prenotabili solo nelle spiagge dove il mare raggiunge davvero il minimo chiesto di onda, voto o vento debole.
Ogni zona con quante scuole ha e se ci sono lezioni da prenotare. Il primo passo di un: dove imparo a surfare?
Spiagge per zona, con tipo di fondo e una breve descrizione, per distinguere quelle buone per principianti dalle altre.
Muta, tavola, leash e scarpette da peso, altezza e livello. Taglie europee, senza promuovere nessun marchio.
Gli hotel partner di SurfBooking, per zona o città.
Tutti leggono soltanto. Nessuno crea, annulla, cambia prezzi o orari, né restituisce dati di allievi.
Questo non è un mockup — è ciò che il nostro endpoint MCP restituisce, adesso. Qualsiasi agente collegato all'MCP riceve esattamente questo. (Non è quello che una IA fa da sola oggi — è quello che riceve quando la colleghi.)
▸ utente: "Prenotami una lezione di surf per principianti in Portogallo questo weekend." # l'agente chiama search_lessons("principiante") e SurfBooking restituisce: - 13 giu · 09:00 · Ribeira d'Ilhas · principiante · €45 → prenotare: surfbooking.eu/reservar/... - 14 giu · 09:00 · Ribeira d'Ilhas · principiante · €45 → prenotare: surfbooking.eu/reservar/... # la prenotazione si conclude in sicurezza. Il pagamento è confermato dalla persona.
Su Claude.ai (Pro) aggiungi SurfBooking come connettore personalizzato in 20 secondi. Niente da installare, nessuna chiave.
https://www.surfbooking.eu/api/mcpSu Claude.ai: Impostazioni → Connettori (o Personalizza → Connettori).
Clicca su "Aggiungi connettore personalizzato".
Nome: SurfBooking. Nel campo "URL del server MCP remoto", incolla l'indirizzo qui sopra. Lascia OAuth vuoto — è pubblico, senza chiave.
Clicca su Aggiungi. Poi chiedi "lezioni di surf per principianti questo weekend" — e ricevi lezioni reali, pronte da prenotare.
Lo stesso URL funziona in qualsiasi client compatibile con MCP, man mano che si aprono i connettori. Per il terminale o Claude Desktop, guarda qui sotto.
Senza installare nulla. Incolla nel terminale:
# cercare una lezione per principianti curl -s https://www.surfbooking.eu/api/mcp \ -H "content-type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call", "params":{"name":"search_lessons", "arguments":{"query":"iniciante ericeira"}}}'
In un client con supporto MCP: su Claude.ai (Pro) aggiungi l'URL come connettore; su Claude Desktop ti colleghi via mcp-remote:
{
"mcpServers": {
"surfbooking": {
"command": "npx",
"args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp"]
}
}
}Nei grandi assistenti di IA il supporto per i connettori MCP si sta aprendo adesso. Ma il modo che funziona già oggi è il più semplice: quando un assistente naviga sul web, legge il nostro indice per LLM e consiglia lezioni reali di SurfBooking — senza collegare niente.
I partner ufficiali di SurfBooking (hotel, marchi di attrezzatura) ricevono una chiave con scope che limita l'MCP ai loro dati — così un'integrazione di hotel non mostra mai un marchio di tavole concorrente, e un marchio di attrezzatura non pubblicizza mai una catena alberghiera altrui.
find_hotels restituisce solo le strutture del partner. size_equipment dà un sizing neutro — nessun marchio di attrezzatura viene promosso.
size_equipment consiglia il catalogo proprio del marchio. find_hotels resta nascosto — non fa parte di questa integrazione.
Vuoi una chiave con scope per la tua marca? Manda un'email a [email protected] — verifichiamo la partnership e configuriamo lo scope.
Una porta separata da quella pubblica, solo per la tua scuola. L’assistente legge ciò che il tuo ruolo vede già in SurfBooking OS e può preparare due modifiche, che avvengono solo quando il titolare le conferma nell’OS.
Stato oggi: è disattivato per impostazione predefinita e non è ancora stato validato con un assistente reale. Finché è disattivato, l’indirizzo risponde 404.
La chiave la crea il titolare, in SurfBooking OS, nella finestra «Assistentes ligados»: lì la revoca, vede le richieste dell'assistente e conferma le proposte.
POST https://www.surfbooking.eu/api/mcp/escola
Authorization: Bearer sbek_XXXXXXXXXX_…Il nome della scuola, il tuo ruolo, i permessi della chiave e quando scade.
Le lezioni tra due date, fino a 14 giorni: ora, spiaggia, livello, istruttori e posti liberi. Un istruttore vede solo le sue.
Conteggi per giorno, fino a 31 giorni: confermate, check-in, assenze e partecipanti. Nessun importo in denaro. Titolare, o staff con accesso ai report.
Solo il nome, il check-in e le taglie già registrate. Nessun contatto, salute, allergia o data di nascita.
L’attrezzatura per categoria e taglia: quantità, in riparazione e disponibile.
Per le lezioni dei prossimi giorni, fino a 7: voto, onda, periodo, vento e un avviso di rischio per il livello della lezione.
Crea una proposta in sospeso con nuova data e ora. La lezione non cambia. Le lezioni che hanno già allievi non sono accettate in questa versione.
Crea una proposta in sospeso per impostare, aggiungere o togliere unità, fino a 30 righe. Lo stock non cambia e non scende mai sotto zero.
Le proposte preparate e lo stato di ciascuna. Il titolare le vede tutte; lo staff vede le proprie.
Non tocca il denaro: pagamenti, rimborsi, prezzi o cancellazioni. Non applica nulla da solo: ogni modifica attende la conferma del titolare nell’OS, che passa per gli stessi controlli del pannello.
La chiave si genera con la sessione del titolare in SurfBooking OS e viene mostrata una sola volta. Ne conserviamo solo l’impronta, vale 30, 90 o 365 giorni e si revoca quando vuoi. La schermata nelle Impostazioni arriva nella prossima fase.
Su Claude Desktop ci si collega tramite mcp-remote, con la chiave in un’intestazione:
{
"mcpServers": {
"surfbooking-escola": {
"command": "npx",
"args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp/escola",
"--header", "Authorization:${SB_SCHOOL_AUTH}"],
"env": { "SB_SCHOOL_AUTH": "Bearer sbek_XXXXXXXXXX_…" }
}
}
}Il connettore personalizzato di Claude.ai sul web e quello di ChatGPT non permettono di inviare una chiave in un’intestazione, solo OAuth, che questo connettore non ha ancora. Oggi funziona solo con i client che inviano l’intestazione. Nessun client è stato validato dal vivo.
Apriamo la porta alle IA del mondo — ma con regole che vivono nel codice, non nella fiducia.
Restituisce sempre un link; il surfista conferma e paga su SurfBooking. Nessun agente tocca i tuoi soldi.
L'LLM può solo leggere. Non crea, non cancella, non cambia prezzi né orari. Al massimo cerca lezioni.
Esce solo l'informazione pubblica della lezione. Nomi, email e telefoni degli allievi non escono mai da SurfBooking.
Regge migliaia di richieste senza intaccare il servizio alle scuole — e si chiude in un istante se serve.
Lezioni reali, di scuole certificate, pronte da prenotare.
Prenota una lezione