> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Connecter un client MCP
> Connectez un client compatible MCP à Qwairy avec OAuth ou un jeton d’accès personnel
Connectez votre assistant IA préféré à vos données de suivi GEO Qwairy. Il suffit de l’URL du serveur :
```text theme={null}
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**](https://www.qwairy.co/dashboard/team/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
1. Ouvrez **Settings** → **Connectors**
2. Cliquez sur **Add custom connector**
3. Saisissez un nom (par exemple `Qwairy`) et l’URL du serveur :
```text theme={null}
https://mcp.qwairy.co
```
4. 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](https://support.anthropic.com/en/articles/11175166-about-custom-integrations-using-remote-mcp).
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.
1. 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**.
2. Ouvrez **Apps > Create**. Dans un espace géré, un propriétaire ou un administrateur peut devoir vous accorder l’accès au préalable.
3. Saisissez un nom comme `Qwairy` et l’URL du serveur :
```text theme={null}
https://mcp.qwairy.co
```
4. Choisissez l’authentification OAuth, analysez les outils, puis terminez le flux d’autorisation Qwairy.
5. 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](https://help.openai.com/en/articles/12584461) 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.
```json theme={null}
{
"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](https://cursor.com/docs/mcp) pour les étapes d’interface actuelles.
Ajoutez le serveur HTTP distant au niveau utilisateur, puis connectez-vous et vérifiez-le :
```bash theme={null}
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](https://code.claude.com/docs/en/mcp) pour les niveaux de configuration et les commandes de gestion.
1. Ouvrez la palette de commandes et lancez **MCP: Add Server**.
2. Choisissez un serveur HTTP et saisissez :
```text theme={null}
https://mcp.qwairy.co
```
3. Choisissez **Global** pour tous les espaces de travail ou **Workspace** pour le dépôt en cours.
4. Faites confiance au serveur quand cela vous est demandé, puis terminez l’autorisation Qwairy.
La configuration équivalente dans `.vscode/mcp.json` est :
```json theme={null}
{
"servers": {
"qwairy": {
"type": "http",
"url": "https://mcp.qwairy.co"
}
}
}
```
Consultez le [guide des serveurs MCP de VS Code](https://code.visualstudio.com/docs/agent-customization/mcp-servers) 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 :
```bash theme={null}
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` :
```json theme={null}
{
"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](https://docs.devin.ai/cli/extensibility/mcp/configuration) et le [guide de l’ancien Cascade](https://docs.devin.ai/desktop/cascade/mcp).
Privilégiez le transport **Streamable HTTP** natif du client avec OAuth et utilisez l’URL :
```text theme={null}
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 :
1. Une fenêtre de navigateur s’ouvre sur la page de connexion Qwairy
2. Connectez-vous avec votre compte Qwairy
3. Autorisez la connexion
4. 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](/fr/mcp/oauth).
## Interroger vos données
Essayez ces exemples de prompts :
```text theme={null}
Quelles marques est-ce que je suis ?
```
```text theme={null}
Montre-moi ma performance GEO sur les 30 derniers jours
```
```text theme={null}
Qui sont mes principaux concurrents dans les réponses IA ?
```
```text theme={null}
Quelles sources citent ma marque le plus souvent ?
```
```text theme={null}
Quelles sont les meilleures opportunités de contenu pour ma marque en ce moment ?
```
```text theme={null}
Compare le sentiment envers ma marque selon les fournisseurs IA
```
```text theme={null}
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 »
1. Vérifiez que vous disposez d’une **offre Starter** ou supérieure
2. Assurez-vous de vous connecter avec le bon compte Qwairy
3. 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](/fr/mcp/tools/measure).
## Étapes suivantes
Le rôle et les paramètres de chaque outil
Des cas d’usage concrets
Reliez Qwairy à vos outils SEO, CMS et de gestion de projet
Le fonctionnement de l’authentification
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.