Skip to main content
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.
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.

Connexion

Utilisez cette URL de serveur dans votre client MCP :
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 et Authentification.

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

Méthode recommandée

1

Identifiez le périmètre

Appelez list_brands, puis listez les Topics ou les Tags si vous avez besoin d’une analyse segmentée.
2

Choisissez une marque

Passez son brandId à l’outil suivant. Un appel d’outil ne combine jamais les données de plusieurs équipes.
3

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

Examinez les données sous-jacentes

Passez des indicateurs agrégés aux prompts, réponses, sources ou analytics connectés avant de conclure.

Étapes suivantes

Connecter un client

Configurez OAuth ou un jeton bearer dans un client MCP compatible.

Comprendre l’authentification

Scopes, isolation des équipes, comportement des jetons et révocation.

Découvrir les données

Obtenez les identifiants de marque, de Topic et de Tag utilisés par les autres outils.

Lire la performance

Définitions des indicateurs, filtres, tendances et ventilations.

Utiliser les outils de mesure

Lisez les analytics connectés avec leurs limites de couverture et de disponibilité.

Suivre un workflow

Combinez les outils sans perdre le périmètre ni les preuves d’une étape à l’autre.