Model Context Protocol

GeoMaestros pour Claude Desktop, Cursor et ChatGPT Desktop

Connectez n’importe quel client IA compatible MCP à votre espace de travail. Posez des questions en anglais simple sur votre visibilité dans les recherches IA, vos concurrents et vos propriétés suivies. Lecture seule par défaut. Révocable à tout moment.

Générer un jeton Lire la documentation

Exemples de requêtes

"Quelle est ma part de voix cette semaine ?"
"Dresse la liste de mes hôtels suivis."
"De quels concurrents devrais-je me préoccuper ?"
"Montre-moi les preuves de recherche IA les plus récentes pour ma marque."
"Quels ont été les plus grands écarts de visibilité la semaine dernière ?"

Installation en 60 secondes

1. Connectez-vous sur app.geomaestros.com.
2. Ouvrez Paramètres → Jetons MCP et cliquez sur Générer un nouveau jeton. Copiez le jeton immédiatement — il n’apparaît qu’une seule fois.

3. Ouvrez le fichier de configuration de Claude Desktop (macOS : ~/Library/Application Support/Claude/claude_desktop_config.json) et collez :

{
  "mcpServers": {
    "geomaestros": {
      "transport": {
        "type": "streamable-http",
        "url": "https://api.geomaestros.com/v1/mcp",
        "headers": { "Authorization": "Bearer YOUR_TOKEN" }
      }
    }
  }
}

4. Redémarrez Claude Desktop. Saisissez list my GeoMaestros properties. Vous devriez voir la réponse en direct.

7 outils en lecture seule (outils d’écriture en option)

Tous les outils sont limités à l’espace de travail pour lequel votre jeton a été généré. Ajoutez mcp:write au moment de la génération uniquement si vous avez besoin d’actions d’écriture.

list_propertiesHôtels, destinations et marques suivis.
list_keywordsRequêtes actives, intention, dernière visibilité.
get_sovSOV global + SOV AI Overview + SOV Local Pack.
get_share_of_voice_trendTendance hebdomadaire, N dernières semaines.
get_evidenceLignes de preuves de recherche IA récentes.
get_competitorsConcurrents suivis avec score de prospection.
get_visibility_gapsAnalyses récentes « why-they-won ».

Sécurité

Les jetons MCP portent un claim d’audience. Ils ne peuvent pas être rejoués contre un point de terminaison non MCP.
Limitation de débit par espace de travail et par utilisateur. Les outils d’écriture ont un bucket plus strict, pour qu’un jeton d’écriture divulgué ne puisse pas épuiser votre quota de suivi en un seul burst.
Expiration par défaut de 90 jours. La révocation se propage en moins de 30 secondes.
Chaque appel d’outil est audité. Les membres de l’espace de travail peuvent consulter le journal des invocations pour plus de transparence.

FAQ

Qu’est-ce que MCP ?

Model Context Protocol. Un standard ouvert d’Anthropic qui permet aux clients IA (Claude Desktop, Cursor, ChatGPT Desktop) d’appeler des outils externes. Pensez OAuth + REST + JSON-RPC, conçu pour l’IA.

Est-ce sécurisé ?

Oui. Les jetons MCP portent un claim d’audience qui les limite au seul serveur MCP. Un jeton divulgué ne peut pas être rejoué contre votre tableau de bord, la facturation ou tout autre point de terminaison. La clé de signature est indépendante du secret de session web.

Comment révoquer un jeton ?

Ouvrez la page des jetons MCP dans les paramètres de votre tableau de bord et cliquez sur Révoquer. En moins de 30 secondes, le jeton est invalidé partout.

Quelle est la durée de vie des jetons ?

90 jours par défaut. Vous pouvez les révoquer plus tôt ou émettre des jetons à durée de vie plus courte via l'API.

Pourquoi l’accès en écriture nécessite-t-il un scope distinct ?

Les outils de lecture (SOV, preuves, concurrents) ne nécessitent que mcp:tools. Les outils qui modifient les données et qui mettent en file d’attente des exécutions de suivi nécessitent mcp:write. Par défaut, nous sommes en lecture seule afin qu’un jeton divulgué ne puisse pas épuiser votre quota de suivi.