Aller au contenu

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.