Brief

Ce guide vous accompagne dans la connexion d'un serveur MCP (Model Context Protocol) DataGalaxy à Claude Desktop. Une fois la connexion établie, Claude peut accéder directement à votre catalogue de données DataGalaxy depuis l'interface de chat.

Claude Desktop ne prend pas en charge nativement les serveurs MCP HTTP distants dans son fichier de configuration. Nous utilisons donc un outil proxy appelé mcp-remote pour établir la connexion.

Prérequis

Étapes d'installation

1. Installer Node.js

Rendez-vous sur nodejs.org, téléchargez la version LTS et lancez le programme d'installation. Cela fournit à la fois node et npx sur votre machine.

2. Trouver le chemin complet vers npx

Claude Desktop a besoin du chemin absolu vers npx. Ouvrez un terminal et exécutez la commande correspondant à votre système d'exploitation.

macOS :

Ouvrez le Terminal (Cmd + Espace, tapez Terminal, puis appuyez sur Entrée) :

which npx

# Exemple de résultat :

/usr/local/bin/npx

Windows :

Ouvrez l'invite de commandes (Win + R, tapez cmd, puis appuyez sur Entrée) :

where npx

# Exemple de résultat :

C:\Program Files\nodejs\npx.cmd

Copiez le chemin complet retourné — vous en aurez besoin à l'étape 4.

3. Ouvrir le fichier de configuration de Claude Desktop

Dans Claude Desktop, allez dans Paramètres → Développeur → Modifier la configuration. Cela ouvre le fichier claude_desktop_config.json dans votre éditeur de texte.

Si vous préférez l'ouvrir manuellement, le fichier se trouve à l'emplacement suivant :

macOS :

~/Library/Application Support/Claude/claude_desktop_config.json

Windows :

%APPDATA%\Claude\claude_desktop_config.json

4. Ajouter la configuration du serveur MCP DataGalaxy

Ajoutez votre configuration (voir le JSON ci-dessous) au contenu du fichier de configuration. Remplacez les deux espaces réservés par vos valeurs issues de l'étape 2 et par votre jeton DataGalaxy.

{

  "mcpServers": {

    "datagalaxy-server": {

      "command": "<FULL_PATH_TO_NPX>",

      "args": [

        "-y",

        "mcp-remote@latest",

        "https://<your instance>.api.datagalaxy.com/mcp/",

        "--header",

        "Authorization: Bearer <YOUR_TOKEN>",

        "--header",

        "X-API-Base-URL: https://<your instance>.api.datagalaxy.com/",

        "--header",

        "X-Source-Request: cursor-client",

        "--header",

        "Accept: application/json, text/event-stream"

      ]

    }

  }

}

⚠️ Remarque : Ne partagez jamais votre fichier de configuration et ne le versionnez jamais dans un gestionnaire de versions — il contient votre jeton d'API.

5. Redémarrer Claude Desktop

Quittez complètement Claude Desktop puis rouvrez-le. Claude doit redémarrer pour prendre en compte les modifications de configuration.

macOS :

Appuyez sur Cmd + Q pour quitter, puis rouvrez Claude Desktop depuis le dossier Applications.

Windows :

Faites un clic droit sur l'icône Claude dans la barre des tâches et sélectionnez Quitter, puis rouvrez l'application depuis le menu Démarrer.

6. Vérifier la connexion

Ouvrez une nouvelle conversation dans Claude Desktop. Si le serveur s'est connecté avec succès, Claude aura accès aux outils DataGalaxy. Vous pouvez demander à Claude de lister les outils DataGalaxy disponibles pour le confirmer.

Troubleshouting

« Not valid MCP server configurations » — entrées ignorées

Cela se produit lorsque l'on utilise type: streamable_http directement dans la configuration. Claude Desktop ne prend pas en charge ce format. Utilisez toujours l'approche npx mcp-remote décrite à l'étape 4.

« Could not attach to MCP server »

Consultez le fichier journal de Claude Desktop pour plus de détails :

macOS :

~/Library/Logs/Claude/mcp-server-datagalaxy-server.log

Windows :

%APPDATA%\Claude\logs\mcp-server-datagalaxy-server.log

Causes fréquentes :

• Le chemin de npx est incorrect — utilisez le chemin absolu complet de l'étape 2.

• Node.js n'est pas installé — installez-le depuis nodejs.org et réessayez.

• Le jeton Bearer a expiré — générez un nouveau jeton dans DataGalaxy.

• Problème réseau — vérifiez que l'URL DataGalaxy est accessible depuis votre machine.

« Failed to spawn process: No such file or directory »

Claude Desktop ne parvient pas à trouver npx. Assurez-vous d'utiliser le chemin absolu complet dans le champ command, et non simplement npx.

Tester le point de terminaison manuellement

Exécutez ceci dans le Terminal (macOS) ou l'invite de commandes (Windows) pour vérifier que votre jeton et votre URL fonctionnent indépendamment de Claude :

macOS :

curl -X POST https://<your instance>.api.datagalaxy.com/mcp/ \

  -H "Authorization: Bearer <YOUR_TOKEN>" \

  -H "X-API-Base-URL: https://<your instance>.api.datagalaxy.com/" \

  -H "X-Source-Request: cursor-client" \

  -H "Accept: application/json, text/event-stream" \

  -H "Content-Type: application/json" \

  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{}},"id":1}'

Windows :

curl -X POST https://<your instance>.api.datagalaxy.com/mcp/ ^

  -H "Authorization: Bearer <YOUR_TOKEN>" ^

  -H "X-API-Base-URL: https://<your instance>.api.datagalaxy.com/" ^

  -H "X-Source-Request: cursor-client" ^

  -H "Accept: application/json, text/event-stream" ^

  -H "Content-Type: application/json" ^

  -d "{\"jsonrpc\":\"2.0\",\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{}},\"id\":1}"

Une réponse réussie renvoie un objet JSON contenant protocolVersion. Une erreur indique un problème de jeton ou d'URL.

Pour l'interface en ligne de commande Claude Code, utilisez ~/.claude/settings.json 

(macOS) ou %USERPROFILE%\.claude\settings.json (Windows) avec type: "http" au lieu de l'approche npx mcp-remote.