Connecter Claude Code

Claude Code se connecte à Octopus en HTTP. Connectez-vous avec votre navigateur (recommandé), ou utilisez une clé personnelle sur les machines sans navigateur.

Connexion par le navigateur

1. Ajoutez Octopus pour tous vos projets :

   claude mcp add --transport http --scope user octopus https://mcp.octopus-brain.com/mcp
   

2. Lancez Claude Code et tapez /mcp. Sélectionnez octopus, puis Authenticate.

3. Votre navigateur ouvre octopus-brain.com : connectez-vous, choisissez l'espace et cliquez sur Autoriser. De retour dans le terminal, Octopus apparaît comme connecté.

Pour vérifier à tout moment :

claude mcp list

À propos des portées : --scope user rend Octopus disponible dans tous vos projets. Utilisez --scope local (par défaut) pour le projet courant uniquement, ou --scope project pour partager le serveur via le .mcp.json du dépôt — sans jamais y écrire de clé.

Avec une clé personnelle

Pour un serveur, une CI ou une machine distante sans navigateur :

1. Générez une clé sur octopus-brain.com/connect (Clés personnelles → Générer une clé). Elle n'est affichée qu'une fois : copiez-la.

2. Ajoutez Octopus avec la clé :

   claude mcp add --transport http --scope user octopus https://mcp.octopus-brain.com/mcp \
     --header "Authorization: Bearer osk_ext_…"
   

Pour garder la clé hors des fichiers partagés, utilisez une variable d'environnement dans .mcp.json :

{
  "mcpServers": {
    "octopus": {
      "type": "http",
      "url": "https://mcp.octopus-brain.com/mcp",
      "headers": { "Authorization": "Bearer ${OCTOPUS_API_KEY}" }
    }
  }
}

Quand un en-tête Authorization est configuré et refusé (clé révoquée ou expirée), Claude Code ne repasse pas par la connexion navigateur. Supprimez le serveur avec claude mcp remove octopus puis ajoutez-le à nouveau.

Une clé fonctionne dans un seul espace, agit avec votre rôle et expire après 30, 90 ou 180 jours (90 par défaut).

Prompts et outils

• Dites « utilise Octopus » ou lancez /mcp__octopus__octopus pour commencer : Claude Code charge d'abord le contexte Octopus de l'équipe, puis travaille.
• Les workflows Octopus apparaissent comme commandes, par exemple /mcp__octopus__catch_up — tapez /mcp__octopus__ pour les voir tous.
• Claude Code charge les outils MCP à la demande (recherche d'outils) : le catalogue Octopus n'encombre pas votre contexte.
• Les très gros résultats sont enregistrés dans un fichier par Claude Code. Augmentez MAX_MCP_OUTPUT_TOKENS pour en afficher davantage.

Supprimer

claude mcp remove octopus

Puis déconnectez l'application ou révoquez la clé sur octopus-brain.com/account.