Connecter Claude Desktop

Claude Desktop prend en charge nativement les serveurs MCP. Après cette configuration, les outils Qyvo apparaissent dans le sélecteur d'outils et Claude peut piloter directement votre espace de travail.

1. Générer un jeton Qyvo

Si ce n'est pas déjà fait, suivez le Démarrage rapide MCP.

2. Modifier le fichier de configuration

Ouvrez claude_desktop_config.json :

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows — %APPDATA%/Claude/claude_desktop_config.json

Ajoutez une entrée qyvo sous mcpServers :

{
  "mcpServers": {
    "qyvo": {
      "transport": {
        "type": "http",
        "url": "https://www.qyvo.io/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_TOKEN_HERE"
        }
      }
    }
  }
}

Si vous avez déjà d'autres serveurs MCP configurés, ajoutez qyvo à côté d'eux — même map mcpServers, pas besoin d'imbriquer.

3. Redémarrer Claude Desktop

Quittez complètement et rouvrez Claude Desktop. La première requête amorce la connexion — vous verrez un petit indicateur d'état au bas du panneau de saisie pendant l'initialisation.

4. Vérifier la connexion

Ouvrez une nouvelle conversation et cliquez sur le sélecteur outils. Les outils Qyvo devraient être listés (35 d'entre eux, regroupés par nom). S'ils ne le sont pas, voir Dépannage ci-dessous.

Essayez d'abord une lecture simple :

Liste mes cinq contacts les plus engagés des 30 derniers jours.

Claude appellera list_contacts (ou composera list_contacts + get_analytics) et répondra.

5. Auto-approuver les outils sûrs

Claude Desktop respecte les annotations IsReadOnly / IsIdempotent que le serveur Qyvo livre. Les outils en lecture seule (list_*, get_*) s'auto-approuvent par défaut. Les outils d'écriture (create_*, send_message, trigger_*) sollicitent une approbation par appel — c'est le défaut sûr. Vous pouvez accorder « toujours autoriser » par outil dans la boîte de dialogue.

Dépannage

• Aucun outil n'apparaît — le panneau Settings → MCP servers de Claude Desktop affichera l'état de la connexion. Un point rouge signifie que le handshake a échoué ; vérifiez le jeton, puis vérifiez ~/Library/Logs/Claude/mcp-server-qyvo.log (macOS) pour l'erreur exacte.
• "Bad Request" à chaque appel — votre jeton n'a pas le scope mcp. Générez un nouveau jeton depuis le tableau de bord ; les nouveaux l'incluent par défaut.
• Les outils fonctionnent mais les envois échouent — vérifiez Paramètres → WhatsApp → Templates dans Qyvo. Le template que vous essayez d'envoyer doit être APPROVED pour la langue que vous passez.

Notes de sécurité

• Le fichier de configuration vit en clair sur le disque. Traitez-le comme une clé SSH — ne le synchronisez pas vers une sauvegarde non chiffrée, ne le collez pas dans des captures d'écran.
• Un jeton par installation Claude, par machine. Si vous changez de laptop, générez un nouveau jeton ; révoquez l'ancien quand vous avez terminé.