> ## 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.

# Serveur MCP Qwairy

> Connectez un assistant compatible MCP pour lire les données de suivi Qwairy et la documentation que vous autorisez

Le serveur MCP Qwairy permet à un assistant compatible MCP de lire les données Qwairy que vous autorisez. Depuis une conversation, vous pouvez découvrir vos marques, inspecter les réponses suivies, comparer concurrents et sources, et interroger les données de mesure connectées.

<Note>
  Le MCP est en lecture seule. Les outils disponibles dépendent des scopes accordés à la connexion, de la marque sélectionnée, de son offre et des intégrations configurées.
</Note>

## Connexion

Utilisez cette URL de serveur dans votre client MCP :

```text theme={null}
https://mcp.qwairy.co
```

Qwairy prend en charge OAuth 2.1 avec PKCE pour les clients compatibles. Des jetons d’accès personnels sont aussi disponibles pour les clients qui exigent un jeton bearer. Consultez [Connecter un client](/fr/mcp/getting-started) et [Authentification](/fr/mcp/oauth).

## Prérequis

* Une offre Qwairy Starter ou supérieure active, y compris les offres agence éligibles
* Au moins une marque accessible disposant de données de suivi
* Un client compatible MCP

Certains outils ont des conditions supplémentaires. Par exemple, les outils de mesure exigent le scope `read:measure` et l’intégration connectée correspondante. Analytics des crawlers suit en plus la condition d’offre du produit.

## Ce que vous pouvez interroger

La découverte des outils fait foi pour la connexion en cours. Qwairy regroupe les outils selon le type de données qu’ils renvoient :

| Domaine | Tâches typiques |
| - | - |
| Découverte | Lister les marques, Topics et Tags accessibles avant d’utiliser leurs identifiants |
| Performance | Inspecter les indicateurs de visibilité, les tendances, les fournisseurs, les Topics et la matrice |
| Prompts et réponses | Lire les prompts suivis, les réponses enregistrées et les signaux au niveau du prompt |
| Concurrents | Comparer les concurrents configurés, leurs positions et leurs tendances |
| Sources | Inspecter les domaines et URL cités, les tendances des sources et les profils de source |
| Stratégie | Examiner les actions, les opportunités de contenu, la perception et l’état technique |
| Insights | Interroger les données shopping, locales, sociales, sponsorisées, Query Fan-Out et questions de suivi |
| Mesure | Lire les données connectées de recherche, de trafic, de revenus, de crawlers et de performance des pages |
| Agence | Découvrir et lire les audits de prospection autorisés |
| Documentation | Rechercher dans la documentation produit et intégrations de Qwairy |

<Warning>
  Des indicateurs aux noms proches peuvent utiliser des unités ou des dénominateurs différents selon le produit, l’API, les exports et les outils MCP. Fiez-vous à la définition renvoyée par l’outil concerné et gardez les mêmes filtres lorsque vous comparez des résultats.
</Warning>

## Méthode recommandée

<Steps>
  <Step title="Identifiez le périmètre">
    Appelez `list_brands`, puis listez les Topics ou les Tags si vous avez besoin d’une analyse segmentée.
  </Step>

  <Step title="Choisissez une marque">
    Passez son `brandId` à l’outil suivant. Un appel d’outil ne combine jamais les données de plusieurs équipes.
  </Step>

  <Step title="Fixez les filtres explicitement">
    Précisez la période, les fournisseurs, les Topics, les Tags ou les types de prompts qu’exige la décision.
  </Step>

  <Step title="Examinez les données sous-jacentes">
    Passez des indicateurs agrégés aux prompts, réponses, sources ou analytics connectés avant de conclure.
  </Step>
</Steps>

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Connecter un client" icon="plug" href="/fr/mcp/getting-started">
    Configurez OAuth ou un jeton bearer dans un client MCP compatible.
  </Card>

  <Card title="Comprendre l’authentification" icon="key" href="/fr/mcp/oauth">
    Scopes, isolation des équipes, comportement des jetons et révocation.
  </Card>

  <Card title="Découvrir les données" icon="magnifying-glass" href="/fr/mcp/tools/discovery">
    Obtenez les identifiants de marque, de Topic et de Tag utilisés par les autres outils.
  </Card>

  <Card title="Lire la performance" icon="chart-line" href="/fr/mcp/tools/performance">
    Définitions des indicateurs, filtres, tendances et ventilations.
  </Card>

  <Card title="Utiliser les outils de mesure" icon="chart-mixed" href="/fr/mcp/tools/measure">
    Lisez les analytics connectés avec leurs limites de couverture et de disponibilité.
  </Card>

  <Card title="Suivre un workflow" icon="route" href="/fr/mcp/workflows">
    Combinez les outils sans perdre le périmètre ni les preuves d’une étape à l’autre.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.