Développeurs · pour Hôtes

Connecter ChatGPT, Claude ou votre propre agent IA (MCP)

Connectez ChatGPT, Claude, Cursor, n8n ou tout client MCP à Guestbud, par connexion ou clé API : votre agent répond aux voyageurs et gère réservations et annonces.

Guestbud prend en charge le Model Context Protocol (MCP), le standard ouvert que les assistants IA utilisent pour travailler avec d'autres logiciels. Vous connectez une fois votre propre agent IA à votre compte Guestbud. Ensuite, vous lui dites en langage courant ce qu'il doit faire, par exemple :

« Réponds aux nouvelles questions sur le parking dans la messagerie Airbnb. »
« Qui arrive demain, et tout le monde a-t-il fait son check-in ? »
« Change le mot de passe Wi-Fi de Harbour Loft en SeaBreeze2026. »
« Rends l'e-mail d'infos d'arrivée plus chaleureux et ajoute la règle sur les serviettes de plage. »
« Quels incidents sont encore ouverts, et qu'a signalé le voyageur de l'appartement 3 ? »

L'agent travaille avec vos données, dans votre compte et uniquement avec les autorisations que vous lui donnez.

Ce que votre agent peut faire #

Domaine	Ce qu'il peut faire	Autorisation de rôle nécessaire
Compte	Voir avec quel compte et quel rôle il est connecté	—
Réservations	Lister et rechercher des réservations, lire une réservation avec les infos de check-in, le statut des paiements et celui des codes d'accès	Bookings: view
Messagerie voyageurs	Lire la conversation Airbnb, Booking.com, Vrbo … et envoyer des messages au voyageur (via Hostaway ou Channex)	Bookings: view / edit
Check-in	Envoyer le lien de check-in ou un rappel par e-mail ou messagerie ; afficher les codes d'accès en avance pour une arrivée anticipée convenue	Bookings: edit
Réservations	Créer une réservation directe, modifier les notes, les voyageurs et les coordonnées, annuler	Bookings: edit
Incidents	Lister les signalements des voyageurs, les passer en cours ou résolus, ajouter des notes internes	Bookings: view / edit
Planning de ménage	Arrivées et départs des prochains jours avec heures d'arrivée / de départ et vols	Cleaning plan
Annonces	Lire tout le guide voyageur ; modifier des sections (Wi-Fi, étapes d'arrivée, règlement intérieur, bonnes adresses, extras …) ; activer ou désactiver un logement	Properties: view / edit
Messages aux voyageurs	Lire et modifier les messages automatiques et les modèles ; prévisualiser un message rempli avec une vraie réservation	Settings
Statistiques	Taux d'occupation, réservations, taxe de séjour, dépôts, arrivées anticipées / départs tardifs et extras vendus	Reports
Tout le reste	Lire n'importe quelle partie de l'API REST (lecture seule)	comme l'API

Jamais accessible à un agent : remboursements, libération ou encaissement des dépôts, paramètres de paiement, utilisateurs et clés API. Tout cela reste entre vos mains dans le tableau de bord.

Deux façons de se connecter #

	Connexion (recommandée)	Clé API
Pour	ChatGPT, claude.ai, Claude Desktop et mobile, Claude Code, Cursor	n8n, Make, frameworks d'agents, votre propre code, serveurs sans personne présente
Comment	Coller l'adresse du serveur dans l'application IA, se connecter à Guestbud, choisir un rôle, cliquer sur Allow	Créer une clé dans Guestbud et la coller dans l'outil
Qui	La personne qui se connecte (il lui faut l'autorisation de connecter des applications, voir ci-dessous)	Une personne qui gère les utilisateurs
Fin	Quand vous la déconnectez, quand la personne est supprimée, désactivée, change de rôle ou de mot de passe, ou après 60 jours sans aucune utilisation	Quand vous révoquez la clé

L'adresse de votre serveur est indiquée sous Settings → AI agent (MCP) :

https://guestbud.io/mcp, ou
votre propre domaine suivi de /mcp, par exemple https://stay.example.com/mcp.

1. Choisir ce que l'agent peut faire #

L'agent travaille toujours avec un rôle — exactement comme une personne de votre équipe (voir Utilisateurs, rôles et connexion) :

Staff — recommandé pour répondre aux voyageurs : lit les réservations, envoie les messages et les liens de check-in, traite les signalements d'incidents, voit le planning de ménage. Ne peut pas modifier les annonces ni les paramètres.
Manager — modifie en plus les annonces, les modèles de messages et les paramètres, et consulte les statistiques.
Viewer — lecture seule ; ne peut rien envoyer.
Cleaning — uniquement le planning de ménage.

Commencez avec Staff. Avec la connexion, vous choisissez le rôle sur la page Guestbud qui s'ouvre ; il ne peut jamais dépasser votre propre rôle, et ne peut jamais être Owner.

Où ajouter l'adresse du serveur (https://guestbud.io/mcp) dans votre application IA :

claude.ai, Claude Desktop et mobile : Settings → Connectors → Add custom connector, collez l'adresse, Add, puis Connect.
ChatGPT : Settings → Apps & Connectors, créez un connecteur (mode développeur), collez l'adresse, authentification OAuth.
Claude Code : exécutez claude mcp add --transport http guestbud https://guestbud.io/mcp, puis tapez /mcp dans Claude Code et choisissez Authenticate.
Cursor : Settings → MCP → Add server avec { "mcpServers": { "guestbud": { "url": "https://guestbud.io/mcp" } } }, puis Connect.

Ensuite :

Dans votre application IA, ajoutez Guestbud avec l'adresse de votre serveur comme indiqué ci-dessus et lancez la connexion.
Une page Guestbud s'ouvre. Connectez-vous avec vos identifiants Guestbud habituels (sur guestbud.io, saisissez aussi le nom court de votre entreprise).
Vérifiez le nom de l'application et l'adresse de retour (par exemple claude.ai), choisissez le rôle de l'application et cliquez sur Allow.
De retour dans l'application IA, les outils de Guestbud sont disponibles. Demandez par exemple : « Quels voyageurs arrivent cette semaine ? ».

Reste connectée : l'application renouvelle automatiquement son accès en arrière-plan (toutes les heures). Vous n'avez pas besoin de vous reconnecter tant que l'agent est utilisé au moins une fois tous les 60 jours.

Qui peut se connecter : sous Settings → AI agent (MCP) → Who may connect AI apps with sign-in, choisissez Team members who manage users (par défaut), All team members (chacun jusqu'à son propre rôle) ou Nobody. Passer à Nobody coupe d'un coup toutes les connexions par identification.

Applications connectées : la même page liste chaque application connectée avec la personne qui s'est identifiée, son rôle et sa dernière utilisation. Disconnect la coupe immédiatement.

3. Se connecter avec une clé API (outils d'automatisation et votre propre code) #

Utilisez une clé pour les outils qui fonctionnent sans personne qui se connecte : n8n, Make, frameworks d'agents, scripts et serveurs.

Ouvrez Settings → AI agent (MCP) et dépliez For automation tools and your own code (API key) (il faut l'autorisation de gérer les utilisateurs).
Saisissez un Name, par exemple n8n — réponses aux voyageurs, et choisissez le Role.
Cliquez sur Create key and show the setup.
La clé complète (gpk_…) n'est affichée qu'une fois, avec des lignes de configuration prêtes à l'emploi qui la contiennent déjà. Copiez-les maintenant. Si vous perdez la clé, révoquez-la et créez-en une nouvelle.

Une clé ne fonctionne que pour votre propre compte. Elle est refusée sur le domaine d'une autre entreprise.

n8n et autres outils d'automatisation #

Dans n8n, ajoutez un AI Agent avec le MCP Client Tool :

Endpoint : https://guestbud.io/mcp
Server transport : HTTP Streamable
Authentication : Bearer Auth, jeton = votre clé gpk_…

Tout autre client MCP capable d'envoyer un en-tête fonctionne de la même façon :

URL : https://guestbud.io/mcp
Transport : Streamable HTTP
En-tête : Authorization: Bearer gpk_…

Claude Code, Claude Desktop, Cursor, Windsurf avec une clé #

Pour ces applications, préférez la connexion par identification. Si vous voulez tout de même une clé (par exemple sur un serveur) :

claude mcp add --transport http guestbud https://guestbud.io/mcp --header "Authorization: Bearer gpk_…"

Les applications qui lancent des serveurs MCP à partir d'un fichier de configuration utilisent le pont gratuit mcp-remote (nécessite Node.js) :

{
  "mcpServers": {
    "guestbud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://guestbud.io/mcp", "--header", "Authorization:${GUESTBUD_AUTH}"],
      "env": { "GUESTBUD_AUTH": "Bearer gpk_…" }
    }
  }
}

La clé se trouve volontairement dans la partie env : cela évite les problèmes d'espaces sous Windows.

4. L'utiliser #

Demandez en langage courant, comme vous le feriez à un collègue. Quelques exemples qui fonctionnent bien :

Messagerie voyageurs : « Regarde les réservations qui arrivent dans les trois prochains jours. Lis leurs conversations Airbnb et Booking.com et rédige des réponses aux questions restées sans réponse. Montre-les-moi avant l'envoi. »
Relance du check-in : « Qui arrive demain et n'a pas fait le check-in en ligne ? Envoie-leur un rappel via la messagerie de réservation. »
Arrivée anticipée : « Le voyageur de la réservation GP-7KQ2XD peut arriver à 12:00 — débloque les codes en avance et préviens-le dans la messagerie. »
Annonces : « Montre-moi les étapes d'arrivée de Capua Flats et corrige le code de l'ascenseur en 3044. »
Incidents : « Liste les incidents ouverts ; passe celui du Wi-Fi à Harbour Loft en résolu avec la note “routeur redémarré”. »
Ménage : « Que doit faire l'équipe de ménage samedi, trié par heure de départ ? Signale les rotations le jour même. »
Messages : « Réécris l'e-mail d'infos d'arrivée sur un ton plus chaleureux, garde toutes les variables et montre-moi un aperçu avec la prochaine réservation. »
Chiffres : « Combien de départs tardifs avons-nous vendus le mois dernier, et quels extras se sont le mieux vendus ? »

Astuce : laissez d'abord l'agent rédiger les messages aux voyageurs et vous les montrer (« montre-les-moi avant l'envoi »). Une fois en confiance, vous pouvez le laisser envoyer directement.

Sécurité #

Vous choisissez les autorisations : le rôle de la clé ou de la connexion décide de tout. L'agent ne voit que les outils autorisés par son rôle, et le serveur vérifie de nouveau chaque appel.
Aucun mouvement d'argent : remboursements, dépôts, paramètres de paiement, utilisateurs et clés ne sont pas accessibles via MCP.
Texte des voyageurs non fiable : les voyageurs peuvent écrire n'importe quoi dans une messagerie ou un formulaire de check-in. Guestbud indique à l'agent de traiter tout ce qu'a écrit un voyageur comme une information, jamais comme une instruction. Il lui indique aussi de ne pas envoyer de codes d'accès avant que la réservation ne les affiche comme visibles. Vérifiez tout de même ce que l'agent envoie, surtout au début.
Chaque modification est enregistrée : chaque action qui modifie quelque chose (un message envoyé, une réservation ou une annonce modifiée, un code débloqué …) figure dans Settings → Audit trail sous le nom de l'application ou de la clé. Les simples consultations n'y figurent pas, pour que le journal reste lisible.
Moins de données personnelles : l'agent reçoit ce dont il a besoin pour aider les voyageurs, pas davantage. Les détails de réservation excluent les données de pièce d'identité et les fichiers envoyés, les adresses IP et le code de serrure connectée de la réservation. L'accès en lecture seule à l'API exclut les fichiers, les utilisateurs, les clés API, le journal d'audit, les webhooks, les données d'enregistrement des voyageurs ainsi que les paramètres de paiement, d'e-mail et de serrure.
Limites : au maximum 120 appels d'outils par minute et 40 messages aux voyageurs par heure et par connexion ou clé ; au maximum 10 requêtes par lot, et les réponses très longues sont raccourcies.
Connexion sécurisée : Guestbud utilise le standard de connexion des applications IA (OAuth 2.1 avec PKCE). L'application ne voit jamais votre mot de passe ; elle reçoit un jeton d'accès valable une heure et un jeton de renouvellement qui change à chaque utilisation. Si un jeton de renouvellement est utilisé deux fois, Guestbud ferme la connexion. Un jeton de connexion ne fonctionne que pour la connexion de l'agent IA, pas pour le reste de l'API.
Révocable à tout moment : Settings → AI agent (MCP) → Disconnect (connexion) ou Revoke (clé). L'agent perd immédiatement l'accès.
Votre fournisseur d'IA : les données que lit l'agent sont traitées par le service d'IA que vous connectez (par exemple Anthropic pour Claude). Vérifiez que cela correspond à la politique de confidentialité présentée à vos voyageurs.

Questions fréquentes #

Quels agents IA fonctionnent avec Guestbud ? #

Tous les clients MCP. ChatGPT, claude.ai, Claude Desktop et mobile, Claude Code et Cursor se connectent par identification. n8n, les frameworks d'agents et votre propre code se connectent avec une clé API.

Combien de temps dure une connexion par identification ? #

Aussi longtemps que vous l'utilisez. L'application renouvelle automatiquement son accès toutes les heures ; la connexion ne prend fin qu'après 60 jours sans aucune utilisation, lorsque vous la déconnectez, ou lorsque la personne qui s'est connectée est supprimée, désactivée, change de rôle ou de mot de passe.

L'agent peut-il envoyer les codes d'accès aux voyageurs ? #

Seulement si son rôle peut lire les réservations et les annonces, et seulement lorsque la réservation du voyageur affiche les codes comme visibles : check-in et paiements terminés, et heure du check-in atteinte (ou codes débloqués en avance par vous). L'agent connaît cette règle. Vos modèles de messages contenant {doorCodes} suivent automatiquement la même règle.

Plusieurs agents peuvent-ils utiliser Guestbud en même temps ? #

Oui. Chaque connexion et chaque clé est une connexion distincte avec son propre rôle, listée séparément dans le journal d'audit, et vous pouvez en déconnecter une sans toucher aux autres.

L'agent coûte-t-il quelque chose dans Guestbud ? #

Non. L'accès MCP fait partie de votre compte. L'agent lui-même vous est facturé par votre fournisseur d'IA.

Existe-t-il aussi une API pour les développeurs ? #

Oui — l'agent utilise les mêmes autorisations que l'API REST et les webhooks ; voir le démarrage rapide de l'API.