Skip to main content

Connexion avec Claude Desktop

La solution la plus rapide pour tester interagir manuellement et de bout en bout avec vos données Qalita sans coder est d'intégrer le serveur MCP dans l'application Claude Desktop (Mac / Windows).

Claude Desktop supporte nativement le standard Model Context Protocol (MCP).

Prérequis​

  1. L'application Claude Desktop installée.
  2. Une clé d'API Qalita avec les accès aux ressources que vous souhaitez interroger.
  3. Un environnement Python avec uv (gestionnaire de paquets) installé ou bien pip fonctionnel pour lancer des packages python globalement.

Configuration (via claude_desktop_config.json)​

Le fichier de configuration de Claude se trouve généralement dans :

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

S'il n'existe pas, créez-le.

Ouvrez le fichier de configuration et ajoutez l'entrée qalita dans mcpServers :

{
  "mcpServers": {
    "qalita": {
      "command": "uvx",
      "args": [
        "qalita-mcp-server"
      ],
      "env": {
        "QALITA_API_KEY": "votre_cle_api_qlt_...",
        "QALITA_ORG_ID": "id_de_votre_organisation"
      }
    }
  }
}

💡 Note sur uvx: Utiliser uvx qalita-mcp-server va télécharger de manière éphémère le paquet (depuis PyPi) qui continent le serveur MCP au démarrage de Claude, en l'exécutant.

Vérification et Utilisation​

  1. Redémarrez complètement l'application Claude Desktop.
  2. Lors de l'ouverture de l'application, vous devriez voir un petit icône « prise » (plug) vous indiquant la disponibilité des extensions ("tools") MCP dans la barre de discussion.
  3. Poser des requêtes à Claude :
    • « Liste-moi les jeux de données disponibles dans Qalita. »
    • « Quel est le rapport de qualité du dataset 'patients-2026' ? »
    • « Peux-tu déclencher une vérification de la structure du dataset XYZ ? »

Derrière chacune de vos requêtes, Claude appellera l'exécutable local qalita-mcp-server, qui communiquera via API HTTP avec la plateforme Qalita, réinjectant la vue et la manipulation de données qualifiées dans votre discussion.