Aller au contenu

Claude Desktop

Claude Desktop peut se connecter au serveur MCP Canopsis en tant que serveur HTTP distant.

Dans les exemples ci-dessous, remplacez MCP_URL par l’URL complète du serveur et CANOPSIS_AUTHKEY par une authkey Canopsis dédiée (voir Sécurité et audit). Ne committez jamais une authkey en clair.

Références :

Configuration

  1. Ouvrez Claude Desktop.
  2. Éditez le fichier de configuration, de l’une des deux façons suivantes :
  3. Dans Claude Desktop : Settings > Developer > Edit Config.
  4. Directement dans le système de fichiers, en ouvrant claude_desktop_config.json :
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
  1. Vérifiez que le point d’accès MCP Canopsis est joignable depuis la machine qui exécute Claude Desktop.
  2. Placez l’authkey Canopsis dans une variable d’environnement avant de lancer Claude Desktop :
export CANOPSIS_AUTHKEY=REPLACE_WITH_AUTHKEY
  1. Ajoutez l’entrée de serveur MCP Canopsis, en adaptant l’URL :
{
  "mcpServers": {
    "canopsis": {
          "command": "npx",
          "args": [
             "-y",
             "mcp-remote",
             "http://127.0.0.1:8081/",
             "--header",
             "Authorization: Bearer ${CANOPSIS_AUTHKEY}"
          ],
          "env": {
             "CANOPSIS_AUTHKEY": "REPLACE_WITH_AUTHKEY"
          }
    }
  }
}

Claude Desktop lance ici une commande locale et communique en stdio ; mcp-remote fait le pont vers le point d’accès HTTP MCP de Canopsis. CANOPSIS_AUTHKEY ne sert qu’à renseigner l’en-tête Authorization envoyé par mcp-remote au serveur MCP Canopsis.

Connecteurs personnalisés

Pour gérer directement des connecteurs HTTP distants dans Claude, sans passer par mcp-remote, utilisez plutôt les connecteurs personnalisés (remote MCP) proposés dans l’interface de Claude, à la place de claude_desktop_config.json.

  1. Redémarrez complètement Claude Desktop pour qu’il recharge sa configuration MCP : utilisez le menu File > Quit (l’application ne se ferme pas en fermant simplement sa fenêtre).
  2. Vérifiez que le serveur Canopsis est connecté et que ses tools sont bien découverts.
  3. Effectuez d’abord un appel à faible risque, puis conservez l’approbation manuelle activée pour les opérations mutables.

Dépannage rapide

  • Assurez-vous d’avoir bien quitté puis relancé l’application (File > Quit, pas juste fermer la fenêtre) après toute modification de configuration.
  • Vérifiez que le client peut joindre l’URL exacte, slash final inclus.

Voir la page Dépannage pour la liste complète des vérifications.