1. Centre d'aide Guesty
  2. Pilote/Bêta
  3. Autres sorties

Bêta : Connexion des assistants IA compatibles MCP à votre compte Guesty

Cet article explique comment connecter des assistants IA compatibles avec le protocole MCP (Model Context Protocol) à votre compte Guesty via le serveur Guesty MCP. Cela permet à des assistants comme Cursor, Claude Desktop et VS Code de récupérer et d'interpréter les données Guesty auxquelles vous êtes autorisé à accéder.

Important:

Le serveur Guesty MCP est une fonctionnalité expérimentale en version bêta. Ne l'utilisez pas en production. Durant cette phase, l'accès au serveur est limité à la lecture : les assistants peuvent consulter et synthétiser les données, mais ne peuvent ni créer, ni modifier, ni supprimer d'enregistrements Guesty.

Vue d'ensemble du serveur Guesty MCP

Le serveur expose les fonctionnalités Guesty prises en charge en tant qu'outils MCP. Votre assistant IA ne peut utiliser que les outils enregistrés sur le serveur MCP et authentifiés avec vos informations d'authentification API Guesty.

Les cas d'utilisation typiques comprennent :

  • Recherche des enregistrements Guesty pris en charge à partir d'un assistant
  • Résumé des informations sur les réservations, les propriétés ou les voyageurs
  • Analyse des questions opérationnelles à l'aide des données autorisées de Guesty
  • Réduire les recherches manuelles tout en évitant d'afficher les informations d'authentification API dans les invites de chat.

Avant de commencer

  • Vous aurez besoin de votre client_id et de votre clé secrète pour l'API Guesty.
  • Pour la méthode de connexion locale recommandée, vous devez avoir Node.js 20 ou une version ultérieure installée et disponible dans votre PATH système.

Obtenez votre jeton API Guesty

Pour connecter votre assistant, vous avez d'abord besoin d'un jeton d'accès à l'API Guesty. Vous pouvez l'obtenir en échangeant vos informations d'authentification OAuth du voyageur contre un jeton d'accès.

Votre identifiant client (client_id) et votre clé secrète (client_secret) sont disponibles dans votre compte Guesty. Pour plus d'informations, consultez notre article sur l'utilisation de l'API ouverte de Guesty.

Note:

Si vous configurez votre assistant MCP pour utiliser directement votre CLIENT_ID et votre CLIENT_SECRET, vous pouvez ignorer l'étape d'échange manuel de jetons.

  1. Exécutez la commande curl suivante dans votre terminal, en remplaçant votre-identifiant-client et votre-secret-client par vos informations d'authentification réelles.

  2. Requête

     curl -s -X POST https://open-api.guesty.com/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=your-client-id" \ -d "client_secret=your-client-secret" \ -d "scope=open-api"
  3. Une requête réussie renvoie une réponse de ce type :

  4. JSON

     { "token_type": "Bearer", "access_token": "eyJ...", "expires_in": 86400 }
  5. Copiez la valeurde access_token. Il s'agit du jeton d'authentification que vous utiliserez pour configurer votre voyageur. Les jetons expirent généralement après 24 heures.

Note:

Pour éviter d'atteindre les limites de tarif de l'API, réutilisez vos jetons Guesty jusqu'à leur expiration.

Choisissez un mode de connexion

Vous pouvez vous connecter au serveur Guesty MCP de deux manières : localement via les E/S standard ou via un point de terminaison HTTP hébergé. Nous recommandons la configuration locale via les E/S standard pour la plupart des utilisateurs, car elle évite d'afficher vos informations d'authentification dans les invites de chat.

Mode Point de terminaison / Commande Idéal pour
Local (stdio) — recommandé npx -y @guestyorg/sdk mcp Valeur par défaut pour tous les clients pris en charge ; informations d'authentification dans l'environnement ; version du SDK épinglée
Hébergé (HTTP) https://mcp.guesty.com/v1 Aucun Node.js installé sur la machine, ou déploiement géré par Guesty

Connectez votre voyageur MCP

Suivez les instructions ci-dessous pour votre voyageur d'assistant IA spécifique.

Connecter le curseur

  1. Ouvrez votre fichier de configuration MCP, situé à ~/.cursor/mcp.json (pour les paramètres utilisateur) ou dans la configuration MCP de votre projet.
  2. Ajoutez l'une des configurations suivantes :
    Recommandé — Studio local

  3. JSON

     { "mcpServers": { "guesty": { "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternative — Hébergé avec en-tête d'autorisation

  5. JSON

     { "mcpServers": { "guesty": { "url": "https://mcp.guesty.com/v1", "headers": { "Authorization": "Bearer your-guesty-token" } } } }
  6. Redémarrez Cursor et vérifiez que le serveur Guesty apparaît comme connecté sous « Paramètres → MCP ».

Retour en haut de page

Connectez-vous à Claude Desktop

  1. Ouvrez le fichier de configuration de Claude Desktop.
    1. macOS : ~/Bibliothèque/ Application Assistance/Claude/claude_desktop_config.json
    2. Windows : %APPDATA%\Claude\claude_desktop_config.json
  2. Ajoutez l'une des configurations suivantes :
    Recommandé — Studio local

  3. JSON

     { "mcpServers": { "guesty": { "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternative — Hébergé
    Étant donné que Claude Desktop ne prend pas en charge les en-têtes personnalisés dans sa configuration MCP, vous devez vous authentifier pour chaque session.
    1. Ajoutez les éléments suivants à votre fichier de configuration :

    2. JSON

       { "mcpServers": { "guesty": { "url": "https://mcp.guesty.com/v1" } } }
    3. Après la connexion, demandez à l'assistant de s'authentifier en envoyant un message comme : Mon jeton Guesty est eyJ... — veuillez vous authentifier .
    4. L'assistant utilisera l'outil set_token pour enregistrer le jeton de la session en cours. Vous devrez répéter cette opération pour chaque nouvelle session.

Retour en haut de page

Connecter VS Code (GitHub Copilot)

  1. Ouvrez votre fichier de configuration MCP.
    • Espace de travail : .vscode/mcp.json
    • Utilisateur: Ouvrez la « Palette de commandes » et sélectionnez « MCP : Ouvrir la configuration Utilisateur ».
  2. Ajoutez l'une des configurations suivantes à l'intérieur de l'objet serveurs :
    Recommandé — Studio local

  3. JSON

     { "servers": { "guesty": { "type": "stdio", "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternative — Hébergé

  5. JSON

     { "servers": { "guesty": { "type": "http", "url": "https://mcp.guesty.com/v1", "headers": { "Authorization": "Bearer your-guesty-token" } } } }
  6. Rechargez la fenêtre ou redémarrez l'hôte MCP. Vérifiez que Guesty est répertoriée et connectée dans les paramètres Copilot Chat MCP.

Retour en haut de page

Se connecter à Google Antigravité

  1. Ouvrez votre fichier de configuration MCP, situé à l' emplacement ~/.gemini/config/mcp_config.json. Vous pouvez également l'ouvrir depuis le panneau de l'agent en sélectionnant « Gérer les serveurs MCP → Afficher la configuration brute ».
  2. Ajoutez l'une des configurations suivantes :
    Recommandé — Studio local

  3. JSON

     { "mcpServers": { "guesty": { "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "BEARER_TOKEN": "eyJ..." } } } }
  4. Alternative — Hébergé

  5. JSON

     { "mcpServers": { "guesty": { "serverUrl": "https://mcp.guesty.com/v1", "headers": { "Authorization": "Bearer your-guesty-token" } } } }
  6. Redémarrez Antigravity après modification. Sous macOS, si l'IDE ne trouve pas npx, utilisez le chemin complet vers npx (par exemple, /opt/homebrew/bin/npx) dans le champ de commande.

Retour en haut de page

Niveau avancé : Utilisation des informations d'authentification Voyageur OAuth2

Au lieu d'utiliser un jeton porteur, vous pouvez fournir directement votre CLIENT_ID et votre CLIENT_SECRET dans la configuration. Le serveur effectuera l'échange de jetons au démarrage.

JSON

 { "mcpServers": { "guesty": { "command": "npx", "args": ["-y", "@guestyorg/sdk", "mcp"], "env": { "CLIENT_ID": "your-client-id", "CLIENT_SECRET": "your-client-secret" } } } }

Retour en haut de page

Avancé : Épingler une version de publication

Pour garantir un comportement reproductible, vous pouvez spécifier une version particulière du SDK Guesty dans le tableau args.

JSON

 "args": ["-y", "@guestyorg/sdk@0.2.0", "mcp"]

Retour en haut de page

Comment utiliser la connexion

Une fois votre voyageur connecté et authentifié, vous pouvez poser des questions à votre assistant concernant vos données Guesty. L'assistant détecte automatiquement les outils Guesty disponibles et les utilise au besoin pour répondre à vos questions.

Exemples de messages d'invite :

  • "Trouvez la réservation correspondant au code de confirmation ABC123."
  • "Résumez les détails de la réservation actuelle de ce client."
  • "Consultez les annonces de cette propriété."

Meilleures pratiques de sécurité

  • Conservez votre jeton d'accès Guesty en lieu sûr, car il vous donne accès à l'API de votre compte.
  • Privilégiez l'utilisation de la méthode stdio locale avec BEARER_TOKEN dans les variables d'environnement ou la méthode hébergée avec les en-têtes d'autorisation. Cela empêche l'affichage des jetons dans votre historique de conversation.
  • Si vous devez utiliser l'outil set_token, évitez de coller des jetons dans des sessions partagées ou enregistrées.
  • Ne transmettez pas les jetons en tant que paramètres de requête d'URL.
  • Ne pas intégrer au système de contrôle de version les fichiers de configuration MCP contenant des jetons actifs.
  • Renouvelez vos informations d'authentification conformément à la politique de sécurité de votre organisation.

Déploiements gérés

Pour les déploiements dédiés où Guesty fournit les informations d'authentification côté serveur, il suffit de se connecter via l'URL. Aucune configuration de jeton côté client n'est requise.

JSON

 { "mcpServers": { "guesty": { "url": "https://mcp.guesty.com/v1" } } }

Contactez Guesty pour mettre en place un déploiement géré.

Comment le serveur utilise votre jeton

Le jeton utilisé pour les appels à l'API Guesty dépend de la manière dont il est fourni. Tous les appels API au sein d'une même session utilisent le jeton associé à cette session, et les sessions sont isolées les unes des autres.

Source Quand cela s'applique
JETON_PORTEUR ou environnement OAuth (stdio) Appliqué lorsque le processus du serveur MCP démarre
En-tête d'autorisation (hébergé) Lié lors de l'initialisation de la session MCP
Outil set_token (hébergé, Agent Desktop) Stocké immédiatement pour le reste de la session

Associé à:

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0