🧭 MCP ou API : lequel vous faut-il ?
Thaïs propose deux accès très différents à vos données. Trente secondes ici vous éviteront de perdre des jours.
🤖 Le connecteur MCP
Un assistant, pour vous- Vous êtes présent et vous formulez la demande
- Des actions ponctuelles, une à la fois
- Vous relisez et vous validez
- Aucun développement : une configuration, une fois
🔌 L'API REST
Une intégration, entre logiciels- Ça tourne sans personne devant l'écran
- Du volume, du récurrent, en masse
- Résultat identique à chaque appel, vérifiable
- Développement nécessaire, par un prestataire technique
| Votre besoin | L'outil | Pourquoi |
|---|---|---|
| « Combien de départs ai-je demain ? » | MCP | Question ponctuelle, vous lisez la réponse tout de suite. |
| « Modifier mes tarifs sur une période » | API | Une erreur de tarif se paie cash. Ce type d'action demande un contrôle strict : on ne laisse pas la main à un modèle qui peut se tromper. |
| « Crée une réservation pour le client que j'ai au téléphone » | MCP | Ponctuel et supervisé : vous relisez avant de confirmer. |
| « Importer 300 fiches clients depuis mon ancien logiciel » | API | Du volume, à faire en une passe, sans oubli possible. |
| « Quelles chambres sont sales ce matin ? » | MCP | Consultation immédiate, sans conséquence si vous reformulez. |
| « Envoyer chaque facture à mon logiciel comptable » | API | Automatique et déclenché par un événement : API + webhooks. |
| « Afficher les arrivées du jour sur un écran à l'accueil » | API | Un logiciel qui interroge Thaïs en boucle, personne aux commandes. |
| « M'aider à comprendre un dossier de réservation compliqué » | MCP | Exactement ce pour quoi un assistant est bon. |
| « Sortir mon chiffre d'affaires du mois pour ma compta » | API | Un chiffre officiel doit être exact et reproductible. |
🔌 Votre application est-elle compatible ?
À vérifier avant de préparer vos identifiants : toutes les applications IA ne peuvent pas se connecter à Thaïs.
Le serveur MCP Thaïs s'authentifie avec un en-tête Authorization que vous
renseignez vous-même. Certaines applications grand public n'acceptent qu'une connexion par
OAuth (le bouton « Se connecter avec… ») et n'offrent aucun champ pour saisir un
en-tête : avec celles-là, la connexion est impossible. Le serveur Thaïs ne propose pas OAuth.
| Application | État | Ce qu'il faut savoir |
|---|---|---|
| Mistral Le Chat | ✅ Recommandé | 100 % en ligne, rien à installer, accepte un en-tête d'authentification. Le chemin le plus simple. |
| Claude Desktop | ⚠️ Possible | Uniquement via le fichier de configuration (le menu « Connecteurs » ne fait que de l'OAuth). Nécessite Node.js et l'édition d'un fichier à la main. |
| Claude (web) — claude.ai | ❌ Non | Connecteurs personnalisés en OAuth uniquement : aucun champ pour un en-tête
Authorization.
|
| ChatGPT — chatgpt.com | ❌ Non | Serveurs MCP personnalisés en OAuth uniquement : aucun champ pour un en-tête
Authorization.
|
| Autre application | ✅ Si en-tête | Fonctionne si elle permet de déclarer un serveur MCP distant (HTTP) et
d'y ajouter un en-tête Authorization.
|
⚙️ Configurer
Trois éléments à réunir, puis trois étapes.
Ce qu'il vous faut
💻 Une application compatible
Voir ci-dessus. En cas de doute : Mistral Le Chat, rien à installer.
🏨 Le nom de votre établissement
Celui qui apparaît dans l'adresse de votre PMS.
https://monhotel.thais-hotel.com🔑 Un compte Thaïs dédié
Un login et un mot de passe de votre PMS. Créez un compte réservé à l'IA plutôt que d'utiliser le vôtre — pourquoi.
ex.monhotel_ia
Étape 1 — Renseignez vos informations
La configuration se construit automatiquement en dessous.
🔒 Tout est calculé localement dans votre navigateur. Aucune information n'est envoyée sur Internet par cette page.
Étape 2 — Choisissez votre application
Étape 3 — Suivez les instructions
Les connecteurs personnalisés de claude.ai n'acceptent que l'authentification OAuth et n'offrent aucun champ pour un en-tête
Authorization. Le serveur MCP Thaïs ne propose
pas OAuth.
Deux solutions : Mistral Le Chat (rien à installer) ou Claude Desktop (fichier de configuration) — sélectionnez l'onglet correspondant ci-dessus.
-
Ouvrez les connecteurs
Sur Le Chat, menu de gauche Contexte → Connecteurs, puis « Ajouter un connecteur ».
-
Choisissez « Connecteur MCP personnalisé »
Dans la fenêtre Create Connection, sélectionnez l'onglet « Connecteur MCP personnalisé » (le second, à droite de « Répertoire de connecteurs »).
-
Renseignez le titre et l'adresse du serveur
Titre :
Thaïs(libre). Serveur du connecteur :https://mcp.thais-hotel.com/mcp/monhotel
Onglet « Connecteur MCP personnalisé » avec le titre et l'URL.
-
Configurez l'authentification
Déroulez Méthode d'authentification → « Authentification par token API », puis :
- Nom de l'en-tête :
Authorization(valeur par défaut) - Type d'en-tête : « Basic » (et non « Bearer »)
- Valeur de l'en-tête → dépliez, puis collez ceci dans le champ « Jeton » :
…
Token API · Type d'en-tête « Basic » · champ « Jeton ».
- Nom de l'en-tête :
-
Créez, puis testez
Laissez Visibilité sur « Privé » et cliquez « Créer ». Dans une nouvelle conversation, demandez :
Liste-moi les arrivées prévues aujourd'hui dans Thaïs.Si de vraies données apparaissent, c'est bon. Sinon : voir le dépannage.
mcp-remote est lancée via npx).
-
Ouvrez le fichier de configuration
Réglages → Développeur → « Modifier la configuration ». Cela ouvre le dossier contenant
claude_desktop_config.json:- macOS :
~/Library/Application Support/Claude/claude_desktop_config.json - Windows :
%APPDATA%\Claude\claude_desktop_config.json
- macOS :
-
Collez la configuration Thaïs
Si le fichier contient déjà une section
mcpServers, ajoutez uniquement l'entrée"thais"à l'intérieur. -
Redémarrez l'application
Fermez complètement Claude Desktop (Quitter, pas seulement la fenêtre) et relancez-le : la configuration n'est lue qu'au démarrage.
-
Testez
Les outils « thais » apparaissent dans une nouvelle conversation. Demandez :
Liste-moi les arrivées prévues aujourd'hui dans Thaïs.
Thaïs expose un serveur MCP web (HTTP). La plupart des clients acceptent une configuration au format JSON :
Si le formulaire ne demande que des champs séparés :
Adresse (URL)
https://mcp.thais-hotel.com/mcp/monhotel
En-tête Authorization
Basic …
https://mcp.thais-hotel.com/mcp et ajoutez l'en-tête
X-Thais-Subdomain: monhotel.
🩺 Dépannage — ça ne marche pas ? Les cas fréquents
| Ce que vous observez | Cause probable | Solution |
|---|---|---|
| Les outils Thaïs n'apparaissent pas | La config n'a pas été rechargée | Fermez complètement l'application, rouvrez-la, et démarrez une nouvelle conversation. |
Erreur 401 / « non autorisé » |
Login ou mot de passe incorrect | Re-générez la config ci-dessus en vérifiant login et mot de passe. Attention aux espaces en trop. |
Erreur 404 / « instance introuvable » |
Nom d'établissement erroné | Vérifiez le nom dans l'adresse de votre PMS
(https://ce-nom.thais-hotel.com).
|
| « Impossible de se connecter au serveur » | URL mal copiée ou pare-feu | Recopiez l'URL. Vérifiez votre connexion / pare-feu d'entreprise. |
| Aucune donnée Thaïs : l'IA répond « de tête » | Connecteur désactivé dans la conversation | Vérifiez qu'il est activé, et reformulez en citant Thaïs (« dans Thaïs, … »). |
| Les données affichées sont incomplètes ou inexactes | Comportement normal d'une IA | Le connecteur peut fonctionner parfaitement et l'IA se tromper quand même. Recoupez dans le PMS — voir limites. |
| L'IA affirme avoir fait une modification introuvable | Action échouée, ou mal rapportée | Vérifiez dans Thaïs et refaites l'action si besoin. |
Toujours bloqué ? Notez le message d'erreur exact et contactez le support.
💡 Usages & limites
Là où le connecteur fait gagner du temps — et là où il faut s'arrêter.
Bons et mauvais usages
✅ Ce pour quoi il est excellent
- Répondre à une question sur la journée en cours
- Retrouver un dossier, un client, une facture
- Saisir une réservation pendant que vous êtes au téléphone
- Faire expliquer une situation compliquée
- Une correction ponctuelle que vous relisez
⛔ Ce qu'il ne faut pas lui confier
- Une modification de tarifs à enjeu
- Un import ou une mise à jour en masse
- Un chiffre officiel : compta, statistiques, déclaration
- Une tâche planifiée « tous les matins automatiquement »
- Une action qu'aucun humain ne relira
Les limites à connaître
Elles ne sont pas des défauts à corriger : elles tiennent à la nature d'un assistant IA.
La même question posée deux fois peut donner deux réponses différentes. C'est le fonctionnement normal d'une IA, pas une panne.
Un assistant résume, sélectionne, et peut omettre. Jamais comme source unique pour un décompte ou un document officiel.
Les actions passent une par une et le débit est limité.
Si une suite d'actions s'interrompt, ce qui est déjà écrit dans Thaïs reste écrit. À vous de vérifier et corriger.
Pas de planification ni de déclencheur : il faut quelqu'un dans la conversation pour demander.
Il peut affirmer avoir enregistré une modification qui a échoué. Après une action sensible, vérifiez dans le PMS.
📚 Domaines couverts — clients, réservations, tarifs, factures…
👥 Clients (Cardex)
- Recherche par nom, email, téléphone
- Création et modification de fiches
- Fusion des doublons
🏨 Réservations
- Liste par dates, statut, client
- Pré-réservations : créer, valider, annuler
- Check-in / check-out, commentaires
💰 Tarifs & disponibilités
- Consultation tarifs et restrictions
- Disponibilités et taux d'occupation
- Calcul du prix d'un séjour et des taxes
🧾 Ventes & factures
- Ventes libres et catalogue
- Factures : liste, détail, envoi
- Acomptes, liens de paiement
🍽️ Restaurant & services
- Réserver / modifier / annuler une table
- Ressources réservables
🧹 Gouvernance
- Statut ménage des chambres
- Notifications e-réservations
🔐 Sécurité
Trois choses à comprendre.
1. La chaîne de connexion, c'est votre mot de passe
La longue chaîne générée par l'assistant n'est pas un jeton délivré par Thaïs : c'est votre
login et votre mot de passe assemblés et encodés — un format
technique, pas un chiffrement. Elle se décode en une seconde. Qui l'obtient peut se
connecter à votre PMS avec ce compte. Traitez-la exactement comme un mot de passe : pas d'email, pas
de messagerie, pas de partage.
2. Vous pouvez couper l'accès vous-même
Si la configuration fuite, ou si vous voulez simplement cesser d'utiliser le connecteur : changez le mot de passe du compte Thaïs concerné. La chaîne devient immédiatement inutilisable. Aucune démarche auprès du support n'est nécessaire.
C'est pour cela qu'on recommande un compte dédié à l'IA : vous coupez l'accès quand vous voulez, sans changer votre propre mot de passe ni déconnecter vos équipes.
3. Limitez ce que l'assistant peut faire
L'assistant hérite exactement des droits du compte utilisé — ni plus, ni moins. Ne donnez à ce compte que les droits nécessaires : c'est un garde-fou bien plus fiable que la prudence de l'IA.
🤝 Support
- 📧 Contactez l'équipe support Thaïs via votre canal habituel.
- 🐛 Pour un problème technique, joignez le message d'erreur exact et le nom de votre application IA.
- 🔌 Pour un projet d'intégration, l'interlocuteur n'est pas le même : partez de la documentation de l'API REST et faites-la lire à votre prestataire technique.
Documentation officielle du MCP · API REST Thaïs · Webhooks · exemple de session.