Connecter Qyrvo à votre IA

À quoi ça sert

Le MCP permet à votre IA (Claude, ChatGPT, Cursor) d'interroger directement vos données Qyrvo en lecture seule. Au lieu d'ouvrir l'app et naviguer entre les écrans, vous tapez votre question à votre IA et la réponse arrive en 2 secondes avec les vrais chiffres.

Ce que votre IA peut faire

7 outils en lecture seule sont disponibles :

Lecture seule : votre IA ne peut jamais envoyer une relance, modifier une facture, ou faire une action côté Qyrvo. Si vous voulez agir, vous gardez la main.

Connexion Claude.ai (web)

La méthode la plus simple. OAuth automatique, pas de fichier de config.

1. Allez sur claude.ai → votre avatar (haut droite) → Settings → Connectors
2. Cliquez sur « Add custom connector »
3. Remplissez :
   • Name : Qyrvo
   • Description : Pilotage cash et factures (facultatif)
   • URL du serveur MCP : https://www.qyrvo.com/api/mcp
4. Cliquez « Créer »
5. Claude.ai vous redirige vers Qyrvo pour autoriser la connexion → cliquez « Autoriser »
6. Retour automatique sur Claude.ai, le connecteur est connecté ✓

Dans une conversation, vous verrez « Qyrvo » dans vos outils disponibles. Tapez par exemple :

Connexion Claude Desktop

Méthode par fichier de config + clé API statique. Utile si vous préférez Claude Desktop à la version web.

1. Générez une clé API dans Qyrvo

1. Allez sur Settings → MCP dans Qyrvo
2. Cliquez « Nouvelle clé », nommez-la (ex: « Claude Desktop »)
3. Copiez la clé affichée (commence par qy_live_) — elle ne sera plus affichée après

2. Ouvrez le fichier de config

• Mac : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

3. Collez la config

{
  "mcpServers": {
    "qyrvo": {
      "transport": {
        "type": "http",
        "url": "https://www.qyrvo.com/api/mcp",
        "headers": {
          "Authorization": "Bearer VOTRE_CLE_QY_LIVE"
        }
      }
    }
  }
}

4. Relancez Claude Desktop

Quittez complètementClaude Desktop (Cmd+Q sur Mac, fermez via systray sur Windows), pas juste la fenêtre. Puis relancez. Dans une nouvelle conversation, l'icône 🔧 en bas devrait afficher « qyrvo » avec 7 tools.

Connexion Cursor IDE

Pour les développeurs qui utilisent Cursor.

1. Générez une clé dans Settings → MCP
2. Cursor Settings → MCP → Add new MCP server
3. Collez :

   {
     "qyrvo": {
       "url": "https://www.qyrvo.com/api/mcp",
       "headers": {
         "Authorization": "Bearer VOTRE_CLE"
       }
     }
   }

4. Cursor redémarre automatiquement le serveur MCP. Testez dans le chat.

Connexion Claude Code (CLI)

Pour les développeurs qui utilisent Claude Code en terminal.

claude mcp add --transport http qyrvo \
  https://www.qyrvo.com/api/mcp \
  --header "Authorization: Bearer VOTRE_CLE"

Vérifiez :

claude mcp list

qyrvo doit apparaître avec les 7 tools listés.

Exemples de questions

Une fois connecté, voici ce que vous pouvez demander :

Sécurité

• Lecture seule : votre IA ne peut jamais déclencher d'action côté Qyrvo (pas de relance, pas de modif).
• Scope organisation : la clé donne accès uniquement aux données de votre organisation, jamais à celles d'autres clients Qyrvo.
• Hash en base : nous ne stockons jamais votre clé en clair. Si vous la perdez, créez-en une nouvelle.
• Révocation 1-clic : depuis Settings → MCP, vous pouvez révoquer une clé à tout moment.
• Audit : la dernière utilisation de chaque clé est tracée pour vous permettre de détecter une activité anormale.
• OAuth 2.1 + PKCE pour Claude.ai web : standard de sécurité moderne, pas de secret en clair échangé.

Limites actuelles

• ChatGPT : la version web ne supporte pas encore les MCP custom de tous les SaaS. On surveille — ça arrive courant 2026.
• Lecture seule : pas d'envoi de relance via l'IA pour l'instant. Phase 2.
• Données d'entrée : Qyrvo doit avoir vos factures importées (via intégration Odoo, Stripe, Xero, etc.) pour répondre. Si pas de données, l'IA dira « pas encore de données disponibles ».

FAQ