Documentation MCP Thais

Introduction

Le MCP Thais est une interface de programmation (API) permettant d'interagir avec le système de gestion hôtelière Thais via des modèles de langage (LLMs). Cette documentation détaille les capacités du MCP et explique comment le configurer.

Qu'est-ce qu'un MCP ?

Le Model Context Protocol (MCP) est un protocole standard permettant aux LLMs de communiquer avec des systèmes externes. Il permet aux assistants IA d'effectuer des actions réelles dans vos applications via des outils structurés.

📖 Ressources utiles

• Documentation officielle du Model Context Protocol
• Spécification MCP sur GitHub
• Guide de démarrage MCP

Configuration du MCP sur différents LLMs

🤖 Configuration avec Claude Desktop (mode stdio)

Pour Claude Desktop, le MCP tourne en local sur votre machine. Les identifiants sont passés par variables d'environnement :

1. Localiser le fichier de configuration

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

2. Ajouter la configuration MCP

{
  "mcpServers": {
    "thais": {
      "command": "npx",
      "args": ["-y", "@thais/mcp-server"],
      "env": {
        "THAIS_SUBDOMAIN": "monhotel",
        "THAIS_USERNAME": "monhotel_api",
        "THAIS_PASSWORD": "•••••••"
      }
    }
  }
}

3. Redémarrer Claude Desktop

Les outils Thaïs apparaissent dans la liste des outils disponibles, prêts à l'emploi.

📚 Ressources

• Configuration MCP avec Claude Desktop
• Guide de démarrage MCP

🌟 Configuration avec Mistral, Claude.ai et autres clients HTTP

Pour les clients HTTP, on utilise le serveur partagé mcp.thais-hotel.com avec une authentification HTTP standard Authorization: Basic.

1. Construire la valeur Basic à partir de vos identifiants :

   echo -n 'monhotel_api:motdepasse' | base64

   🔧 Générateur assisté

   Saisissez vos identifiants ci-dessous : la valeur Basic est calculée localement dans votre navigateur. Rien n'est envoyé sur le réseau.

   👁

   Basic … Copier
2. Renseigner la configuration MCP du client :

   {
     "mcpServers": {
       "thais": {
         "url": "https://mcp.thais-hotel.com/mcp/monhotel",
         "headers": {
           "Authorization": "Basic bW9uaG90ZWxfYXBpOm1vdGRlcGFzc2U="
         }
       }
     }
   }

3. Démarrer une conversation — aucun identifiant à saisir : tout est géré par la config.

📚 Tutoriels Mistral

• Documentation Mistral AI
• Guide d'intégration MCP avec Mistral

🔧 Configuration avec d'autres LLMs

Le protocole MCP est supporté par plusieurs autres plateformes :

📚 Ressources générales

• Liste des clients MCP compatibles
• Implémentation du protocole MCP

URL du serveur MCP Thais

🌐 URLs disponibles

Instance de démonstration

Instance personnalisée

Remplacez {{instance}} par le nom de votre instance Thais.

🔐 Authentification

Le MCP utilise les credentials d'API de votre instance Thaïs (un compte technique par hôtel, distinct de vos comptes utilisateurs PMS). Ces credentials :

• sont fournis une seule fois dans la configuration du client MCP (env en stdio, Authorization: Basic en HTTP) ;
• restent côté serveur MCP — le LLM ne les voit jamais, ne peut pas les afficher ni les transmettre ;
• servent à obtenir automatiquement un JWT Hub, mis en cache et rafraîchi de façon transparente ;
• ne doivent jamais être collés dans la conversation.

Capacités du MCP Thais

Le MCP de Thais offre une gamme complète de fonctionnalités pour la gestion hôtelière et de complexe :

👥1. Gestion des Clients (CARDEX)

Fiches Clients

• Rechercher des clients par nom, prénom, email, téléphone
• Ajouter de nouvelles fiches clients
• Lire les informations détaillées d'un client
• Modifier les coordonnées, adresses, statuts des clients

Opérations Avancées

• Fusionner des fiches clients en double
• Gérer les relations entre clients (famille, entreprise)

Configuration

• Récupérer les listes de civilités (M., Mme, etc.)
• Consulter les langues disponibles
• Accéder aux tranches d'âges (pour taxes de séjour et statistiques)
• Gérer les catégories et groupes de clients

🏨2. Réservations et Disponibilités Hôtelières

Gestion des Réservations (Bookings)

• Récupérer les détails d'une réservation
• Lister les réservations selon différents critères :
  • Dates de séjour (check-in, check-out)
  • Statut de la réservation
  • Groupe de réservation
  • Client associé
• Rechercher des réservations spécifiques

E-Réservations et Options

• Insérer de nouvelles pré-réservations (eBookings)
• Lire les détails des options en cours
• Modifier les informations d'une e-réservation
• Valider une option pour la transformer en réservation confirmée
• Annuler une option expirée ou refusée
• Gérer les dates d'expiration des options

Mise à Jour des Séjours

• Modifier l'état d'une chambre (Check-in, Check-out, Pending)
• Ajuster les heures d'arrivée et de départ
• Ajouter ou modifier des commentaires sur la réservation
• Changer le style d'affichage d'une réservation

💰3. Tarification et Inventaire (Revenue Management)

Tarifs et Restrictions

• Consulter l'historique des tarifs
• Lire les tarifs courants par type de chambre et période
• Mettre à jour en vrac les tarifs pour plusieurs dates
• Gérer les restrictions (MinStay, MaxStay, CTA, CTD)

Disponibilités

• Lire les disponibilités actuelles par type de chambre
• Consulter l'historique des disponibilités
• Analyser les taux d'occupation

Calculs

• Calculer le prix complet d'un séjour (nuits, extras, options)
• Calculer les taxes de séjour selon la réglementation

Gestion des Blocages

• Lire les blocages de chambres (NPL - Non à la vente)
• Créer de nouveaux blocages
• Modifier ou supprimer des blocages existants

🧾4. Ventes, Facturation et Paiements

Achats et Ventes

• Enregistrer des ventes libres (produits, services)
• Vendre des articles du catalogue
• Transférer des ventes depuis d'autres modules (Restaurant, Services, Boutique)
• Associer des ventes à une réservation de chambre

Comptabilité

• Préparer le Fichier des Écritures Comptables (FEC)
• Exporter les données comptables
• Générer des rapports financiers

Factures et Commandes

• Récupérer la liste des factures
• Consulter le détail d'une facture
• Lister les commandes en cours
• Envoyer les factures par email au client

Paiements

• Enregistrer des acomptes (dépôts)
• Créer des liens de paiement en ligne
• Suivre l'état des paiements
• Gérer les remboursements

Cartes Cadeaux

• Créer de nouvelles cartes cadeaux
• Modifier le montant d'une carte cadeau
• Envoyer les cartes cadeaux par email
• Vérifier le solde restant

Catalogue et TVA

• Récupérer l'ensemble des articles vendables
• Consulter les catégories d'articles
• Accéder aux taux de TVA configurés

🔧5. Modules Complémentaires

Réservations de Tables (Restaurant)

• Lire les réservations de tables existantes
• Créer de nouvelles réservations de restaurant
• Modifier les détails d'une réservation (heure, nombre de couverts)
• Annuler une réservation de table

Réservations de Services/Ressources

• Gérer les types de ressources (spa, salle de réunion, etc.)
• Consulter les ressources réservables
• Créer des réservations de services
• Confirmer ou annuler des réservations
• Calculer la tarification des services

Gouvernance (Ménage)

• Récupérer l'état de propreté des chambres (Propre, Sale, En cours, À inspecter)
• Mettre à jour le statut de nettoyage
• Suivre la progression du ménage

Notifications

• Gérer les notifications de réservations
• Recevoir les alertes d'e-réservations
• Suivre les notifications de groupes

Guide d'utilisation

🚀 Première utilisation

1. Configurer le MCP sur votre client (voir section Configuration). Les credentials de votre instance Thaïs y sont renseignés une fois.
2. Redémarrer le client MCP pour que la nouvelle configuration soit prise en compte.
3. Démarrer une conversation directement avec une demande métier — aucun identifiant à saisir dans le chat.

   Exemple de message initial :

   Affiche-moi les arrivées prévues cette semaine et les chambres concernées.

✅ Bonnes pratiques

Exemples d'utilisation

Support et Contact

Pour toute question ou problème concernant le MCP Thais :

• 📧 Contactez l'équipe de support Thais
• 📚 Consultez la documentation technique complète
• 🐛 Signalez les bugs via votre canal habituel

Notes de version

Version actuelle

• Authentification entièrement gérée côté serveur : credentials et JWT invisibles du LLM
• Configuration par Authorization: Basic (HTTP) ou variables d'environnement THAIS_* (stdio)
• Cache JWT par instance avec rafraîchissement transparent et retry automatique sur 401
• Validation stricte du subdomain à la frontière HTTP (protection SSRF)
• Rate limit par (IP, instance) et redaction systématique des secrets dans les logs
• Compatibilité Claude Desktop, Claude.ai, Mistral et tout client MCP standard