Passer au contenu principal
Qwairy fonctionne avec tout client MCP qui prend en charge les serveurs distants en Streamable HTTP. Utilisez OAuth quand le client le permet, et un jeton d’accès personnel quand il ne peut pas mener une connexion interactive. La connexion est en lecture seule.

​
Avant de commencer

  • L’accès à une équipe Qwairy sur une offre Starter ou supérieure. Vous pouvez vous connecter avant toute collecte. Les requêtes renvoient des données dès qu’une marque active a des réponses générées.
  • Un client avec prise en charge native de Streamable HTTP
  • Pour OAuth : un client compatible OAuth 2.1 avec PKCE (S256) et enregistrement dynamique de client

​
Connecter votre client

1

Saisissez l’URL du serveur

Ajoutez un serveur MCP distant avec le transport Streamable HTTP et cette URL, sans ajouter /mcp :
2

Choisissez l’authentification

Pour OAuth, laissez le client découvrir le flux à partir de l’URL du serveur et choisissez l’enregistrement automatique du client. Qwairy enregistre le client pour vous, sans client ID ni client secret à saisir. Connectez-vous avec le compte Qwairy qui a accès à vos marques et autorisez l’accès.Pour les clients headless comme les plateformes d’automatisation, les scripts et les agents personnalisés, créez un jeton d’accès personnel dans Gestion de l’équipe > Serveur MCP et transmettez-le dans un en-tête bearer :
Gardez le jeton secret et révoquez-le depuis la même page quand vous n’en avez plus besoin.
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.

​
Vérifier que la connexion fonctionne

Dans une conversation où Qwairy est activé, envoyez :
L’assistant doit appeler l’outil list_brands de Qwairy et afficher les marques accessibles. Pour un script, appelez d’abord tools/list et vérifiez que les outils Qwairy sont renvoyés.

​
Dépannage

​
Le client ne parvient pas à joindre le serveur

Vérifiez que le transport est Streamable HTTP, que l’URL est https://mcp.qwairy.co, sans /mcp, et que votre réseau autorise le HTTPS sortant.

​
Le client demande un client ID ou un secret

Choisissez l’enregistrement automatique du client si le client le propose. Vous n’avez pas à saisir de client ID ni de client secret. Si le client ne peut pas s’enregistrer automatiquement, utilisez plutôt un jeton d’accès personnel. Consultez Authentification OAuth pour les points d’accès et le flux d’enregistrement manuel.

​
L’autorisation échoue

Vérifiez que le jeton ou le compte appartient à une équipe sur une offre Starter ou supérieure et que le jeton n’a pas été révoqué. Consultez le dépannage général.

​
Documentation officielle

La configuration dépend de chaque client. Consultez la documentation de votre client pour ajouter un serveur MCP distant, et la spécification du Model Context Protocol pour le transport. Procédure vérifiée d’après la documentation des fournisseurs le 28 août 2026.

​
Étapes suivantes