Connecter un client MCP

Connectez votre assistant IA préféré à vos données de suivi GEO Qwairy. Il suffit de l’URL du serveur :

https://mcp.qwairy.co

Les clients compatibles OAuth découvrent le flux OAuth 2.1 de Qwairy à partir de cette adresse. Selon le client, l’autorisation démarre automatiquement, à la première utilisation ou après une commande de connexion explicite. Pour les clients headless qui ne peuvent pas mener un OAuth interactif, créez un jeton d’accès personnel dans Gestion de l’équipe > Serveur MCP. Préférez OAuth dès que le client le permet.

Les interfaces des clients MCP évoluent indépendamment de Qwairy. Les éléments stables sont l’URL du serveur et OAuth. Les procédures ci-dessous ont été vérifiées le 28 août 2026 d’après la documentation de chaque éditeur, en lien.

Prérequis

L’accès à une équipe Qwairy active sur une offre Starter ou supérieure, y compris les offres agence payantes
Un client qui prend en charge les serveurs MCP distants en Streamable HTTP
Pour interroger les données de suivi : au moins une marque active accessible avec des réponses générées

Choisir un client

Ouvrez Settings → Connectors
Cliquez sur Add custom connector
Saisissez un nom (par exemple Qwairy) et l’URL du serveur :

https://mcp.qwairy.co

Cliquez sur Add, puis autorisez la connexion quand elle vous est demandée

Les connecteurs personnalisés sont disponibles sur les offres Claude compatibles. Les propriétaires d’espaces Team et Enterprise peuvent devoir activer ou ajouter le connecteur pour l’organisation. Consultez le guide des connecteurs personnalisés d’Anthropic.

La disponibilité et les contrôles de publication dépendent de votre offre ChatGPT et de la politique de votre espace de travail. La prise en charge complète du MCP est disponible sur ChatGPT Business, Enterprise et Edu. ChatGPT Pro prend en charge les apps personnalisées en lecture et récupération en mode développeur.

Vérifiez que le mode développeur est activé pour votre compte. Les administrateurs et propriétaires Business peuvent l’activer depuis Workspace Settings > Apps > Create. Les utilisateurs Enterprise et Edu autorisés peuvent aussi passer par Settings > Apps > Advanced Settings.
Ouvrez Apps > Create. Dans un espace géré, un propriétaire ou un administrateur peut devoir vous accorder l’accès au préalable.
Saisissez un nom comme Qwairy et l’URL du serveur :

https://mcp.qwairy.co

Choisissez l’authentification OAuth, analysez les outils, puis terminez le flux d’autorisation Qwairy.
Créez l’app. Un propriétaire de l’espace peut devoir la publier avant que les autres membres puissent l’utiliser.

Consultez le guide des apps personnalisées d’OpenAI pour les offres et contrôles d’espace en vigueur.

Ajoutez Qwairy à ~/.cursor/mcp.json pour une connexion personnelle valable dans tous les projets. N’utilisez le .cursor/mcp.json d’un projet que si le serveur doit être limité à ce projet.

{
  "mcpServers": {
    "qwairy": {
      "url": "https://mcp.qwairy.co"
    }
  }
}

Enregistrez le fichier, redémarrez Cursor, puis ouvrez Customize > MCPs pour vérifier que le serveur est activé et terminer OAuth. Consultez la documentation MCP de Cursor pour les étapes d’interface actuelles.

Ajoutez le serveur HTTP distant au niveau utilisateur, puis connectez-vous et vérifiez-le :

claude mcp add --transport http qwairy --scope user https://mcp.qwairy.co
claude mcp login qwairy
claude mcp get qwairy

Sur les versions de Claude Code sans claude mcp login, lancez /mcp dans Claude Code pour terminer OAuth. Consultez la documentation MCP de Claude Code pour les niveaux de configuration et les commandes de gestion.

Ouvrez la palette de commandes et lancez MCP: Add Server.
Choisissez un serveur HTTP et saisissez :

https://mcp.qwairy.co

Choisissez Global pour tous les espaces de travail ou Workspace pour le dépôt en cours.
Faites confiance au serveur quand cela vous est demandé, puis terminez l’autorisation Qwairy.

La configuration équivalente dans .vscode/mcp.json est :

{
  "servers": {
    "qwairy": {
      "type": "http",
      "url": "https://mcp.qwairy.co"
    }
  }
}

Consultez le guide des serveurs MCP de VS Code pour les options de configuration par espace de travail et par utilisateur.

Devin Local est l’agent par défaut des nouveaux onglets Windsurf. Ajoutez Qwairy au niveau utilisateur, puis connectez-vous et vérifiez-le :

devin mcp add -s user qwairy https://mcp.qwairy.co
devin mcp login qwairy
devin mcp get qwairy

L’ancien agent Cascade utilise Devin Settings > Cascade > MCP Servers ou ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "qwairy": {
      "serverUrl": "https://mcp.qwairy.co"
    }
  }
}

Cascade accepte serverUrl ou url pour les serveurs HTTP distants. Les politiques d’équipe peuvent exiger qu’un administrateur active ou autorise l’accès MCP. Consultez le guide MCP de Devin Local et le guide de l’ancien Cascade.

Privilégiez le transport Streamable HTTP natif du client avec OAuth et utilisez l’URL :

https://mcp.qwairy.co

Si un client ne prend en charge que stdio, choisissez une passerelle HTTP maintenue et validée par votre organisation. Figez un paquet et une version approuvés au lieu d’exécuter un paquet non figé à l’exécution. La configuration de la passerelle et la prise en charge du callback OAuth dépendent du client.

Autoriser la connexion

Après l’ajout du serveur, votre client lance le flux OAuth :

Une fenêtre de navigateur s’ouvre sur la page de connexion Qwairy
Connectez-vous avec votre compte Qwairy
Autorisez la connexion
Vous êtes redirigé vers le client : la connexion est active

Vos identifiants ne sont jamais partagés avec le client IA. L’authentification repose sur OAuth 2.1 avec PKCE : seul un jeton d’accès sécurisé et limité à des scopes est échangé. En savoir plus sur OAuth.

Interroger vos données

Essayez ces exemples de prompts :

Quelles marques est-ce que je suis ?

Montre-moi ma performance GEO sur les 30 derniers jours

Qui sont mes principaux concurrents dans les réponses IA ?

Quelles sources citent ma marque le plus souvent ?

Quelles sont les meilleures opportunités de contenu pour ma marque en ce moment ?

Compare le sentiment envers ma marque selon les fournisseurs IA

Quels prompts apportent le plus de visibilité à mes concurrents ?

Dépannage

Erreur « Server not found »

Utilisez l’adresse racine https://mcp.qwairy.co, sans ajouter /mcp
Vérifiez que votre fichier de configuration est un JSON valide
Redémarrez votre client IA après avoir modifié la configuration

Erreur « Authentication failed »

Vérifiez que vous disposez d’une offre Starter ou supérieure
Assurez-vous de vous connecter avec le bon compte Qwairy
Déconnectez puis reconnectez le serveur

« No data returned »

Vérifiez que vous avez :

Au moins une marque au statut « Live »
Un suivi activé avec des réponses générées
Des données récentes (30 derniers jours par défaut)

Votre client ne prend pas en charge le MCP distant ?

Privilégiez un client avec Streamable HTTP natif et prise en charge d’OAuth. Si votre organisation approuve une passerelle, figez sa version et suivez la procédure de callback OAuth documentée par ce client.

Limites de débit

Le serveur MCP autorise actuellement 300 requêtes par minute et 3 000 requêtes par jour par jeton d’accès. Les réponses HTTP 429 exposent X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset pour la fenêtre par minute ; les réponses réussies n’exposent pas d’en-têtes de quota. Le délai de nouvel essai indiqué dans le message d’erreur JSON est calculé à partir de cette même réinitialisation par minute. Appliquez un backoff exponentiel. Si les requêtes restent limitées après la réinitialisation, arrêtez les nouvelles tentatives automatiques et reprenez plus tard, car le plafond quotidien est peut-être atteint. Ces limites de service peuvent évoluer : considérez les valeurs documentées comme la politique en vigueur, et les en-têtes 429 comme une indication sur la fenêtre courte, pas comme un signal complet du quota quotidien.

Outils de mesure et scopes

Les outils qui lisent des analytics hors IA (Search Console, Bing, trafic référent, revenus IA, activité des crawlers) relèvent de la catégorie Measure et exigent le scope read:measure. Si vous vous êtes connecté avant l’existence de ce scope, déconnectez-vous puis reconnectez-vous pour l’obtenir : les scopes d’un jeton déjà émis ne sont jamais étendus en silence. Consultez Outils Measure.

Étapes suivantes

Référence des outils

Le rôle et les paramètres de chaque outil

Exemples de conversations

Des cas d’usage concrets

Combiner avec d’autres outils

Reliez Qwairy à vos outils SEO, CMS et de gestion de projet

Configuration OAuth

Le fonctionnement de l’authentification

Bien démarrer

Référence des outils

Exemples

Workflows

Prérequis

Choisir un client

Autoriser la connexion

Interroger vos données

Dépannage

Erreur « Server not found »

Erreur « Authentication failed »

« No data returned »

Votre client ne prend pas en charge le MCP distant ?

Limites de débit

Outils de mesure et scopes

Étapes suivantes

Référence des outils

Exemples de conversations

Combiner avec d’autres outils

Configuration OAuth

​Prérequis

​Choisir un client

​Autoriser la connexion

​Interroger vos données

​Dépannage

​Erreur « Server not found »

​Erreur « Authentication failed »

​« No data returned »

​Votre client ne prend pas en charge le MCP distant ?

​Limites de débit

​Outils de mesure et scopes

​Étapes suivantes

Référence des outils

Exemples de conversations

Combiner avec d’autres outils

Configuration OAuth

Prérequis

Choisir un client

Autoriser la connexion

Interroger vos données

Dépannage

Erreur « Server not found »

Erreur « Authentication failed »

« No data returned »

Votre client ne prend pas en charge le MCP distant ?

Limites de débit

Outils de mesure et scopes

Étapes suivantes