Claude Code¶
Cette page décrit la connexion du CLI Claude Code au serveur MCP Canopsis.
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 dans un dépôt.
Référence officielle : Connect Claude Code to MCP servers
Configuration privée locale¶
Ajoutez le serveur pour le projet courant :
claude mcp add --transport http --scope local \
--header "Authorization: Bearer CANOPSIS_AUTHKEY" \
canopsis MCP_URL
Vérifiez :
claude mcp list
claude mcp get canopsis
Démarrez Claude Code et exécutez :
/mcp
Confirmez que canopsis est connecté. Claude Code peut référencer les resources MCP avec @ : recherchez une resource Canopsis dans la liste d’autocomplétion.
Utilisez --scope user à la place de --scope local si la configuration privée doit être disponible dans tous vos projets.
Partager un template de projet sans identifiant¶
Exportez les valeurs privées avant de démarrer Claude Code :
export CANOPSIS_MCP_URL=http://127.0.0.1:8081/
export CANOPSIS_AUTHKEY=REPLACE_WITH_AUTHKEY
Créez .mcp.json à la racine du projet :
{
"mcpServers": {
"canopsis": {
"type": "http",
"url": "${CANOPSIS_MCP_URL}",
"headers": {
"Authorization": "Bearer ${CANOPSIS_AUTHKEY}"
}
}
}
}
Démarrez Claude Code depuis ce projet, approuvez la confiance du projet, puis approuvez le serveur MCP.
Exécutez /mcp pour vérifier la connexion. Ce fichier peut être partagé (versionné) puisqu’il ne contient aucun secret en clair, à condition que chaque utilisateur exporte ses propres variables d’environnement avant de lancer Claude Code.