> ## 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 Qwairy à Claude Code

> Oui. Ajoutez Qwairy à Claude Code comme serveur HTTP distant avec une seule commande, puis connectez-vous avec OAuth. URL du serveur : https://mcp.qwairy.co.

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.

```bash theme={null}
claude mcp add --transport http qwairy --scope user https://mcp.qwairy.co
```

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 :

```bash theme={null}
claude mcp login qwairy
```

**3. Confirmez l’état du serveur**

```bash theme={null}
claude mcp get qwairy
```

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

## Vérifier que la connexion fonctionne

Dans Claude Code, envoyez :

```text theme={null}
Utilise Qwairy pour lister les marques auxquelles j’ai accès.
```

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 :

```bash theme={null}
claude mcp remove qwairy
```

### 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**](https://www.qwairy.co/dashboard/team/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.

```bash theme={null}
claude mcp add --transport http qwairy --scope user https://mcp.qwairy.co --header "Authorization: Bearer qw-usr-REPLACE_WITH_YOUR_TOKEN"
```

### 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](/fr/mcp/oauth.md).

## 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](https://code.claude.com/docs/en/mcp).

Procédure vérifiée d’après la documentation d’Anthropic le 22 octobre 2026.

## Étapes suivantes

* [Référence des outils](/fr/mcp/tools/discovery.md) : le rôle de chaque outil Qwairy
* [Exemples de conversations](/fr/mcp/examples/getting-started.md) : des prompts à essayer
* [Tous les clients pris en charge](/fr/mcp/getting-started.md#choisir-un-client)


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