Vosréservations,dansn’importequelassistantIA.

Connectez StayHawk à Claude, ChatGPT ou votre IDE et posez vos questions sur les échéances, les prix et ce qui demande votre attention — en langage naturel.

ClaudeChatGPTGeminiCursorVS Code
Lecture seule · Authentifié par Kinde

Qu’est-ce que c’est ?

StayHawk expose un serveur Model Context Protocol. Il donne à un assistant IA un accès en lecture seule à votre portefeuille de réservations, authentifié avec le compte que vous utilisez sur le web. Il n’écrit jamais et ne conserve aucune donnée.

Pour qui ? Les voyageurs et les agents de voyage qui veulent connecter un assistant IA à leurs propres réservations — pour savoir ce qui arrive à échéance, ce qui a baissé de prix et ce qui demande leur attention.

Connexion en trois étapes.

1

Ajoutez le serveur

Dans les réglages MCP de votre assistant IA, ajoutez un serveur pointant vers l’endpoint StayHawk. La plupart des clients demandent une URL et un identifiant client.

2

Connectez-vous une fois

Votre client ouvre une fenêtre de navigateur. Connectez-vous avec le compte StayHawk que vous utilisez sur le web. Le client conserve le jeton pour vous — rien à copier.

3

Interrogez vos réservations

Demandez à votre assistant ce qui arrive à échéance, quelles réservations ont baissé de prix, ou ce qui demande votre attention. Il lit votre portefeuille en direct.

Exemple de configuration client

{
  "mcpServers": {
    "stayhawk": {
      "url": "https://mcp.stayhawk.app/mcp",
      "client_id": "974dd144220a443590152e70213e835d"
    }
  }
}

L’identifiant client est un identifiant public, pas un secret. Votre client découvre les URL de connexion et de jeton automatiquement depuis https://auth.stayhawk.app.

Détails de connexion

Endpoint MCPPOST https://mcp.stayhawk.app/mcp
TransportStreamable HTTP
Identifiant client974dd144220a443590152e70213e835d
Serveur d’autorisationhttps://auth.stayhawk.app
Audiencehttps://api.stayhawk.app
AccèsLecture seule

Connecter votre client

Le même endpoint partout. Pointez votre client vers l’URL et connectez-vous une fois dans le navigateur — le jeton se renouvelle ensuite tout seul. Pour utiliser un jeton statique à la place, ajoutez un en-tête Authorization: Bearer <jeton> à n’importe quelle configuration ci-dessous.

Claude Code

Ajoutez le serveur, puis lancez /mcp pour vous connecter :

claude mcp add --transport http stayhawk https://mcp.stayhawk.app/mcp

Claude Desktop

Réglages → Connecteurs → Ajouter un connecteur personnalisé, collez l’URL, puis connectez-vous :

https://mcp.stayhawk.app/mcp
Plutôt le fichier de configuration ?
{
  "mcpServers": {
    "stayhawk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.stayhawk.app/mcp"]
    }
  }
}

mcp-remote assure la connexion navigateur pour la configuration par fichier. Redémarrez Claude Desktop après modification.

ChatGPT

Activez le mode développeur (Réglages → Apps et connecteurs → Avancé), puis Réglages → Connecteurs → Ajouter un connecteur personnalisé, collez l’URL et connectez-vous :

https://mcp.stayhawk.app/mcp

Nécessite un forfait ChatGPT payant. Activez le connecteur pour chaque conversation via +→ mode développeur.

Cursor

Créez ~/.cursor/mcp.json (global) ou .cursor/mcp.json (ce projet) :

{
  "mcpServers": {
    "stayhawk": {
      "url": "https://mcp.stayhawk.app/mcp"
    }
  }
}

Réglages → MCP affiche un point vert ; la première utilisation ouvre le navigateur pour la connexion.

VS Code (Copilot / mode Agent)

Ajoutez à .vscode/mcp.json :

{
  "servers": {
    "stayhawk": {
      "type": "http",
      "url": "https://mcp.stayhawk.app/mcp"
    }
  }
}

Gemini CLI

Ajoutez à ~/.gemini/settings.json (utilise httpUrl pour le Streamable HTTP) :

{
  "mcpServers": {
    "stayhawk": {
      "httpUrl": "https://mcp.stayhawk.app/mcp"
    }
  }
}

Gemini CLI découvre la connexion OAuth automatiquement ; connectez-vous à la première utilisation.

Ce que votre assistant peut faire

list_workspaces

Espaces de travail dont vous faites partie

get_dashboard_summary

Aperçu du portefeuille d’un espace

get_upcoming_bookings

Voyages à venir et leurs échéances

get_action_items

Ce qui demande votre attention maintenant

list_bookings

Réservations d’un espace de travail

get_booking

Une réservation en détail

search_bookings

Rechercher des réservations en texte libre

get_price_checks

Historique des vérifications de prix

list_alerts

Alertes d’échéance et de baisse de prix

Dépannage

401 Unauthorized

Le jeton est manquant, expiré ou émis pour la mauvaise audience. Reconnectez-vous depuis votre client. Si vous avez collé un jeton à la main, obtenez-en un nouveau.

404 / Cannot GET

Mauvais chemin ou méthode. MCP est un POST vers l’endpoint /mcp, pas une page à ouvrir dans un navigateur. Vérifiez que l’URL se termine par /mcp.

Résultats vides

Vous regardez probablement le mauvais espace de travail. Demandez à votre assistant de lister vos espaces, puis indiquez le bon.

La connexion ne s’ouvre pas

Certains clients ne savent que s’enregistrer automatiquement et n’acceptent pas d’identifiant client. Pour ceux-là, collez un jeton d’accès StayHawk comme jeton bearer. Voir la FAQ ci-dessous.

Questions fréquentes

Le Model Context Protocol est un standard ouvert qui permet à un assistant IA de dialoguer avec un service externe de façon structurée. StayHawk expose un serveur MCP pour que votre assistant puisse lire votre portefeuille de réservations — échéances, prix et alertes — sans rien recopier.

Oui. Le serveur ne peut que lire vos réservations. Il ne crée, ne modifie et ne supprime rien, et ne conserve aucune donnée — chaque requête est limitée à votre espace de travail par l’API StayHawk.

Tout client qui parle MCP en Streamable HTTP et permet de définir un client_id — Claude, ChatGPT, Cursor, VS Code et d’autres. Les clients qui ne savent que s’enregistrer automatiquement ont besoin d’un jeton collé (voir ci-dessous).

Utilisez 974dd144220a443590152e70213e835d. C’est un identifiant public, pas un secret ; vous pouvez le coller sans risque.

Quelques clients ne savent que s’enregistrer automatiquement et n’acceptent pas d’identifiant client. Pour ceux-là, connectez-vous à StayHawk, générez un jeton d’accès pour l’API (audience https://api.stayhawk.app) et collez-le dans votre client comme jeton bearer dans l’en-tête Authorization.

Votre assistant ne voit que ce que vous demandez, authentifié avec votre propre compte. La connexion est en lecture seule et limitée à votre espace de travail. Vous pouvez révoquer l’accès à tout moment depuis votre compte Kinde.

D’autres questions ?

Nous répondons généralement sous un jour ouvré.

Écrire à support@stayhawk.app