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 :
- Getting Started with Local MCP Servers on Claude Desktop
- Get started with custom connectors using remote MCP
Configuration¶
- Ouvrez Claude Desktop.
- Éditez le fichier de configuration, de l’une des deux façons suivantes :
- Dans Claude Desktop : Settings > Developer > Edit Config.
- 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
- Vérifiez que le point d’accès MCP Canopsis est joignable depuis la machine qui exécute Claude Desktop.
- Placez l’authkey Canopsis dans une variable d’environnement avant de lancer Claude Desktop :
export CANOPSIS_AUTHKEY=REPLACE_WITH_AUTHKEY
- 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.
- 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).
- Vérifiez que le serveur Canopsis est connecté et que ses tools sont bien découverts.
- 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.