Quand quelqu'un demande à une IA où apprendre à surfer, nous renvoyons de vrais cours — plage, niveau, heure, prix — prêts à réserver. Pas un article. De vrais cours, d'écoles certifiées.
{
"spot": "Ribeira d'Ilhas",
"date": "2026-06-13",
"time": "09:00",
"level": "iniciante",
"price": "€45",
"book": "surfbooking.eu/reservar/…"
}La veille d'arriver au Portugal, un touriste demande à une IA : "où est-ce que j'apprends à surfer ce week-end ?"
Aujourd'hui, l'assistant répond encore avec une carte générique. Mais SurfBooking a déjà construit le pont : un index pour LLMs et un endpoint MCP qui renvoient de vrais cours — la bonne plage pour le niveau, à des heures qui existent vraiment, avec le lien pour réserver. À mesure que les assistants ouvrent leurs connecteurs, SurfBooking devient la réponse. Et qui connecte déjà aujourd'hui — par connecteur ou MCP — les reçoit dès maintenant.
Le LLM ne lit pas une page: il demande une de ces choses et reçoit des données réelles sur le champ, y compris l’état de la mer sur chaque plage.
Par plage, zone, niveau, date ou prix maximum. Renvoie des cours réservables avec jour, heure, plage, école, prix et lien.
Prix, durée, places et ce qui est inclus: combinaison, planche, transport, assurance.
Le lien sécurisé où le surfeur réserve et paie. L’agent ne facture jamais.
Une note de 0 à 10 ajustée au niveau, avec vague, période et vent, et la meilleure fenêtre de chaque jour. Elle répond à: quel jour dois-je réserver?
Les plages actives classées par conditions en direct, avec vague, vent, note et lien.
La même vague est bonne pour un débutant et faible pour un avancé. Celle-ci classe selon la manière dont chaque plage convient au niveau demandé.
Des cours réservables seulement sur les plages où la mer atteint vraiment le minimum demandé de vague, de note ou de vent faible.
Chaque zone avec le nombre d’écoles et s’il y a des cours à réserver. La première étape d’un: où est-ce que j’apprends à surfer?
Les plages par zone, avec le type de fond et une courte description, pour distinguer celles qui conviennent aux débutants.
Combinaison, planche, leash et chaussons à partir du poids, de la taille et du niveau. Tailles européennes, sans promouvoir aucune marque.
Les hôtels partenaires de SurfBooking, par zone ou ville.
Tous ne font que lire. Aucun ne crée, n’annule, ne change les prix ou les horaires, ni ne renvoie de données d’élèves.
Ce n'est pas une maquette — c'est ce que notre endpoint MCP renvoie, maintenant. Tout agent connecté au MCP reçoit exactement ça. (Ce n'est pas ce qu'une IA fait toute seule aujourd'hui — c'est ce qu'elle reçoit quand tu la connectes.)
▸ utilisateur: "Réserve-moi un cours de surf débutant au Portugal ce week-end." # l'agent appelle search_lessons("débutant") et SurfBooking renvoie : - 13 juin · 09:00 · Ribeira d'Ilhas · débutant · €45 → réserver: surfbooking.eu/reservar/... - 14 juin · 09:00 · Ribeira d'Ilhas · débutant · €45 → réserver: surfbooking.eu/reservar/... # la réservation se conclut en toute sécurité. Le paiement est confirmé par l'humain.
Sur Claude.ai (Pro), tu ajoutes SurfBooking comme connecteur personnalisé en 20 secondes. Rien à installer, pas de clé.
https://www.surfbooking.eu/api/mcpSur Claude.ai : Paramètres → Connecteurs (ou Personnaliser → Connecteurs).
Clique sur "Ajouter un connecteur personnalisé".
Nom : SurfBooking. Dans le champ "URL du serveur MCP distant", colle l'adresse ci-dessus. Laisse OAuth vide — c'est public, sans clé.
Clique sur Ajouter. Puis demande "cours de surf débutant ce week-end" — et tu reçois de vrais cours, prêts à réserver.
La même URL fonctionne dans n'importe quel client compatible MCP, au fur et à mesure que les connecteurs s'ouvrent. Pour le terminal ou Claude Desktop, vois plus bas.
Rien à installer. Colle dans le terminal :
# chercher un cours débutant 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"}}}'
Dans un client compatible MCP : sur Claude.ai (Pro) tu ajoutes l'URL comme connecteur ; sur Claude Desktop tu connectes via mcp-remote :
{
"mcpServers": {
"surfbooking": {
"command": "npx",
"args": ["mcp-remote", "https://www.surfbooking.eu/api/mcp"]
}
}
}Dans les grands assistants d'IA, la prise en charge des connecteurs MCP s'ouvre en ce moment. Mais la façon qui marche déjà aujourd'hui est la plus simple : quand un assistant navigue sur le web, il lit notre index pour LLMs et recommande de vrais cours SurfBooking — sans rien connecter.
Les partenaires officiels de SurfBooking (hôtels, marques de matériel) reçoivent une clé avec scope qui limite le MCP à leurs propres données — pour qu'une intégration d'hôtel n'affiche jamais une marque de planche concurrente, et qu'une marque de matériel n'annonce jamais une chaîne hôtelière étrangère.
find_hotels ne renvoie que les établissements du partenaire. size_equipment donne un sizing neutre — aucune marque de matériel n'est mise en avant.
size_equipment recommande le catalogue propre de la marque. find_hotels reste masqué — il ne fait pas partie de cette intégration.
Tu veux une clé avec un scope pour ta marque ? Envoie un email à [email protected] — nous vérifions le partenariat et configurons le scope.
Une porte séparée de la porte publique, rien que pour ton école. L’assistant lit ce que ton rôle voit déjà dans SurfBooking OS et peut préparer deux changements, qui n’ont lieu que lorsque le propriétaire les confirme dans l’OS.
État aujourd’hui : il est désactivé par défaut et n’a pas encore été validé avec un vrai assistant. Tant qu’il est désactivé, l’adresse répond 404.
C'est le propriétaire qui crée la clé, dans SurfBooking OS, fenêtre «Assistentes ligados» : c'est là qu'il la révoque, voit les demandes de l'assistant et confirme les propositions.
POST https://www.surfbooking.eu/api/mcp/escola
Authorization: Bearer sbek_XXXXXXXXXX_…Le nom de l’école, ton rôle, les permissions de la clé et sa date d’expiration.
Les cours entre deux dates, jusqu’à 14 jours : heure, plage, niveau, moniteurs et places libres. Un moniteur ne voit que les siens.
Des comptes par jour, jusqu’à 31 jours : confirmées, check-in, absences et participants. Aucun montant d’argent. Propriétaire, ou équipe ayant accès aux rapports.
Seulement le prénom, le check-in et les tailles déjà enregistrées. Aucun contact, santé, allergie ni date de naissance.
Le matériel par catégorie et taille : quantité, en réparation et disponible.
Pour les cours des prochains jours, jusqu’à 7 : note, vague, période, vent et une alerte de risque pour le niveau du cours.
Crée une proposition en attente avec une nouvelle date et heure. Le cours ne change pas. Les cours qui ont déjà des élèves ne sont pas acceptés dans cette version.
Crée une proposition en attente pour fixer, ajouter ou retirer des unités, jusqu’à 30 lignes. Le stock ne change pas et ne passe jamais sous zéro.
Les propositions préparées et l’état de chacune. Le propriétaire les voit toutes ; l’équipe voit les siennes.
Il ne touche pas à l’argent : paiements, remboursements, prix ou annulations. Il n’applique rien tout seul : chaque changement attend la confirmation du propriétaire dans l’OS, qui passe par les mêmes vérifications que le tableau de bord.
La clé se génère avec la session du propriétaire dans SurfBooking OS et n’est affichée qu’une fois. Nous n’en gardons que l’empreinte, elle vaut 30, 90 ou 365 jours et se révoque quand tu veux. L’écran dans Réglages arrive à la prochaine phase.
Sur Claude Desktop, on se connecte via mcp-remote, avec la clé dans un en-tête :
{
"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_…" }
}
}
}Le connecteur personnalisé de Claude.ai sur le web et celui de ChatGPT ne permettent pas d’envoyer une clé dans un en-tête, seulement OAuth, que ce connecteur n’a pas encore. Aujourd’hui il ne fonctionne qu’avec les clients qui envoient l’en-tête. Aucun client n’a été validé en direct.
Nous ouvrons la porte aux IA du monde — mais avec des règles qui vivent dans le code, pas dans la confiance.
Il renvoie toujours un lien ; le surfeur confirme et paie sur SurfBooking. Aucun agent ne touche à ton argent.
Le LLM ne peut que lire. Il ne crée rien, n'annule rien, ne change ni les prix ni les horaires. Tout ce qu'il fait, c'est chercher des cours.
Seules les informations publiques du cours sortent. Les noms, emails et téléphones des élèves ne quittent jamais SurfBooking.
Il encaisse des milliers de requêtes sans affecter le service aux écoles — et se ferme en un instant si besoin.
De vrais cours, d'écoles certifiées, prêts à réserver.
Réserver un cours