Passer au contenu principal
Qwairy fonctionne avec Claude Code comme serveur MCP HTTP distant. Vous ajoutez le serveur depuis un terminal, vous vous connectez avec OAuth, puis vous posez à Claude Code des questions sur vos marques. 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.
  • Claude Code installé et connecté
  • Un navigateur pour la connexion OAuth, sur la même machine ou sur une autre (voir Dépannage pour les machines distantes).

Connecter Qwairy à Claude Code

1

Ajoutez le serveur

Lancez cette commande dans un terminal. --scope user rend Qwairy disponible dans tous vos projets.
Utilisez l’URL racine, sans ajouter /mcp. Sans --scope user, Claude Code enregistre le serveur pour le projet en cours uniquement.
2

Connectez-vous avec OAuth

Ouvrez Claude Code et lancez /mcp, sélectionnez qwairy, puis choisissez Authenticate. Claude Code ouvre votre navigateur. Connectez-vous avec le compte Qwairy qui a accès à vos marques et autorisez l’accès.Depuis le terminal, vous pouvez aussi lancer :
3

Confirmez l’état du serveur

La sortie indique l’URL du serveur, le transport HTTP et son état.

Vérifier que la connexion fonctionne

Dans Claude Code, envoyez :
Claude Code doit appeler l’outil list_brands de Qwairy et afficher les marques accessibles. Autorisez l’appel s’il vous le demande. Une réponse générale sans appel d’outil ne confirme pas la connexion.

Dépannage

Le serveur demande une authentification

Lancez /mcp dans Claude Code, sélectionnez qwairy, puis choisissez Authenticate. Terminez la connexion dans le navigateur, puis relancez claude mcp get qwairy.

Le serveur est introuvable ou la connexion échoue

Vérifiez que l’URL est https://mcp.qwairy.co, sans /mcp. Pour recommencer, supprimez le serveur puis ajoutez-le de nouveau :

Vous travaillez sur une machine sans navigateur

Lancez claude mcp login qwairy --no-browser, ouvrez l’URL affichée dans un navigateur sur n’importe quelle machine, connectez-vous et autorisez l’accès, puis collez l’URL de retour complète dans le terminal. Pour un usage non interactif, comme un script ou une CI, créez un jeton d’accès personnel dans Gestion de l’équipe > Serveur MCP et transmettez-le dans un en-tête bearer. Remplacez la valeur d’exemple par votre jeton et gardez-le hors des fichiers partagés et de l’historique du shell.

Les outils Qwairy n’apparaissent pas après un changement de scope

Les scopes d’un jeton déjà émis ne sont jamais étendus. Supprimez le serveur, ajoutez-le de nouveau et autorisez-le pour obtenir les nouveaux scopes comme read:measure. Consultez Authentification OAuth.

Documentation officielle

Les options des commandes, les niveaux de configuration et les commandes de gestion sont maintenus par Anthropic. Consultez Connect Claude Code to tools via MCP. Procédure vérifiée d’après la documentation d’Anthropic le 22 octobre 2026.

Étapes suivantes