Smily MCP: Guide utilisateur

Source : enregistrements des webinaires Smily, septembre 2026, et documentation technique disponible ici.

1. Qu'est-ce que Smily MCP ?

Smily MCP connecte un assistant IA (Claude, ChatGPT, etc.) directement aux données réelles de votre compte Smily via le Model Context Protocol (MCP). Plus besoin d'exporter des données ou d'attendre un tableau de bord sur-mesure : vous posez vos questions en langage naturel et l'IA interroge vos vraies données pour répondre, construire des rapports ou détecter des anomalies.

L'accès est en lecture seule. L'IA peut interroger les données mais ne peut rien créer, modifier ou supprimer dans votre compte Smily.

Smily expose aujourd'hui plus de 70 « ressources » de données via le MCP et la liste continue de s'allonger. Exemples : réservations, tarifs journaliers et règles tarifaires, avis, tâches, revenus, programmes de protection (dommages et annulation), messagerie. Selon Smily, le MCP expose déjà plus de données que leur propre API publique.

La priorité affichée par Smily sur cette fonctionnalité est la qualité de la donnée : des chiffres ne sont utiles que s'ils sont propres et correctement calculés. C'est présenté comme l'un des points forts de Smily face à la concurrence.

2. Quel assistant IA utiliser ?

• Claude est recommandé par Smily. Claude offre actuellement la meilleure intelligence/performance pour cet usage (ce n'est pas l'option la moins chère, mais la plus performante).
• ChatGPT est également supporté, avec un processus de connexion similaire mais différent (voir plus bas).
• Claude Cowork / Claude Code permet en plus à l'IA d'agir (planifier des rapports récurrents, rafraîchir un tableau de bord automatiquement). Le chat Claude classique ne peut qu'analyser et répondre, pas planifier.

3. Prérequis

Un token MCP API personnel (une clé privée, à traiter comme un mot de passe) est nécessaire pour l'authentification.

• Pas encore disponible directement dans l'interface Smily.
• À demander à votre Account Manager ou au support client Smily.
• Gardez-le privé. Il donne un accès en lecture à vos données de compte.

4. Connexion à Claude (Desktop / Cowork)

1. Utilisez l'application Claude Desktop, ouvrez l'onglet Cowork.
2. Personnaliser les connecteurs → + Ajouter un connecteur personnalisé.
3. Nom : « Smily ».

4. URL (identique, ancien domaine) :

   <https://www.bookingsync.com/mcp?token=VOTRE_TOKEN_PRIVÉ>

5. Cliquez sur Ajouter. Vous avez maintenant un accès en lecture seule à vos données Smily depuis Claude.

5. Connexion à ChatGPT

1. Dans ChatGPT : profil (en bas à gauche) → Paramètres → Applications → Créer une application.
2. Icône : vous pouvez utiliser le logo Smily.
3. Nom : choisissez quelque chose de facilement identifiable, par exemple « Smily – [nom de votre compte] ». C'est utile si vous avez plusieurs applications ou comptes connectés.
4. Description : précisez que la connexion est en lecture seule, aucun risque d'effacer ou de modifier quoi que ce soit dans Smily.

5. URL de connexion :
   (L'API de Smily tourne encore sur l'ancien nom de domaine « BookingSync ».)

   <https://www.bookingsync.com/mcp?token=VOTRE_TOKEN_PRIVÉ>
   

6. Authentification : sélectionnez « pas d'authentification », le token dans l'URL fait office d'authentification.
7. Confirmez que vous comprenez que cette application n'est pas développée par OpenAI, puis cliquez sur Créer.
8. C'est fait ! Vous pouvez maintenant discuter avec vos données Smily directement dans ChatGPT.

6. Cas d'usage et exemples de prompts

6.1 Rapport hebdomadaire de KPI (récurrent, à votre image)

« Utilise Smily. Construis un rapport HTML aux couleurs et au logo de [votredomaine].com avec les KPI de la semaine sous forme de graphiques : taux d'occupation, revenu vs. semaine précédente, revenu vs. saison précédente, tâches en retard, part des réservations directes, part des logements couverts par la protection annulation. Donne-moi le top 3 des actions à faire cette semaine, et enregistre ce rapport comme modèle réutilisable pour le relancer chaque semaine. »

Avec Claude Cowork, une fois ce rapport enregistré comme modèle (ou « artifact »), vous pouvez demander qu'il se rafraîchisse automatiquement (par exemple chaque lundi à 8h), en réutilisant le même gabarit et en ne mettant à jour que les chiffres. Cela limite les coûts (pas besoin de tout regénérer) et vous donne un rapport prêt à la fréquence souhaitée. À noter : les rafraîchissements planifiés consomment plus de crédits IA et peuvent nécessiter un forfait Claude supérieur.

6.2 Rapport propriétaire

« Utilise Smily. Rédige un rapport propriétaire pour [nom de la propriété] : revenu et occupation cette année comparés aux deux années précédentes ; ce que disent les avis sur l'état du bien et les équipements ; les problèmes de maintenance récurrents remontés dans les tâches ; 2 à 3 recommandations pour préserver la valeur du bien et améliorer sa rentabilité à long terme. Fais ce rapport en HTML avec l'image de marque de [votredomaine].com, logo inclus. »

L'IA peut aller chercher votre logo et vos couleurs directement sur votre site. Il faut généralement un ou deux allers-retours pour affiner la teinte exacte ou la mise en page. Elle peut aussi construire une chronologie des problèmes de maintenance directement à partir du texte des avis (ex. « route d'accès dégradée signalée en juillet 2024… toujours signalée en mai 2025… confirmée réparée en mai 2026 »), un travail très long à faire manuellement.

6.3 Rapport de performance global du portefeuille

« Utilise Smily et donne-moi un bilan de santé complet de mon compte en HTML : occupation et revenu sur les 12 derniers mois vs. les 24 derniers mois, tendance de la note moyenne des avis, part des réservations directes vs. plateformes, part des logements inscrits à la protection annulation. »

Utile pour une vue « niveau direction » du business. Ce type de rapport peut aussi être généré avec les chiffres financiers automatiquement floutés. C'est pratique pour faire une démonstration à un prospect propriétaire sans exposer les vrais chiffres d'autres clients.

6.4 Audit tarifaire / durée de séjour (LOS)

« Fais un audit tarifaire complet pour [propriété]. Explore les remises liées à la durée de séjour, les tarifs saisonniers, les règles de séjour minimum et les offres spéciales actives. Signale les anomalies : nuits sans tarif, écarts anormaux entre périodes voisines, incohérences. »

Pas besoin de préciser exactement quoi chercher. Un prompt large (« signale-moi tout, prends ton temps ») fonctionne très bien. L'IA peut prendre 30 à 60 minutes pour traiter la demande ; inutile de rester devant l'écran.
Important : cet outil complète un revenue manager, il ne le remplace pas. L'IA n'a pas toute la connaissance du marché, mais elle est très efficace pour repérer des incohérences de données à grande échelle.

6.5 Détection de trous dans le calendrier

Exemple montré lors de la démo : l'IA a détecté une période où aucun check-out/check-in n'était possible sur plusieurs jours consécutifs, créant un trou impossible à réserver dans le calendrier, un problème concret et actionnable, facile à manquer manuellement.

6.6 Analyse des avis dans une autre langue

L'IA peut traduire et résumer des avis rédigés dans une autre langue sur simple demande (« traduis-moi cet avis en français »), et faire ressortir les points récurrents (positifs comme négatifs) avec des recommandations concrètes (repositionnement de l'annonce, révision tarifaire, etc.).

7. Bien travailler avec l'IA : conseils pratiques

• Vérifiez toujours les chiffres calculés, en particulier les chiffres financiers. Lors des démos, un pourcentage de « réservations directes » s'est avéré faux car l'IA n'avait pris en compte qu'une partie des canaux. Demandez-lui d'expliquer sa méthode, la plupart des rapports incluent un court récapitulatif de ce qui a été calculé et comment, ce qui facilite la vérification.
• Itérez. L'image de marque, les couleurs et le périmètre sont rarement parfaits du premier coup. Corrigez en conversation (« ce n'est pas tout à fait le bon bleu, revérifie le site »), plus vous corrigez dans une même session, plus l'IA devient précise.
• Soyez précis sur vos objectifs: KPI exacts, période de comparaison exacte, source de l'image de marque exacte, pour un résultat plus pertinent. Un prompt vague donne une réponse générique.
• Vous pouvez convertir un rapport en PDF en le demandant directement à l'IA, ou via Fichier → Imprimer → Enregistrer en PDF de votre navigateur.

8. Sécurité et gestion des données

• La connexion MCP elle-même est en lecture seule. Aucun risque que l'IA écrase ou supprime quoi que ce soit dans votre compte Smily via ce connecteur.
• Faites attention à où vous partagez ou hébergez vos rapports. Ils contiennent souvent des données confidentielles de propriétaires, y compris des indicateurs financiers. Évitez de les publier sur un site public ; privilégiez des canaux directs (email, WhatsApp) ou des portails à accès contrôlé.
• Si vous connectez l'IA à votre messagerie pour l'envoi automatique, sachez que cela comporte un risque de sécurité propre (un agent IA avec un accès d'envoi à votre boîte mail). À évaluer avant d'automatiser l'envoi.
• L'IA peut se tromper sur les chiffres, notamment financiers — ce risque a été explicitement souligné lors du webinaire. Gardez toujours un œil sur l'ordre de grandeur et vérifiez tout document destiné à un propriétaire ou investisseur avant envoi.
• Si vous allez au-delà de simples requêtes en lecture et commencez à construire des outils personnalisés qui écrivent dans une base de données, cela nécessite de vraies pratiques d'ingénierie : gestion de versions (type GitHub) et sauvegardes/réplication vérifiées. Sans cela, une modification malheureuse assistée par IA peut effacer ou corrompre des données. À titre de référence, l'infrastructure de Smily est entièrement répliquée avec des sauvegardes conservées plusieurs mois, un niveau de rigueur recommandé si vous construisez vos propres outils au-dessus des données.