Dépannage

Les pannes les plus fréquentes et comment les résoudre.

Les outils synapse_* n'apparaissent pas dans /mcp

• Le MCP n'est pas enregistré → lance (ou relance) la commande d'enregistrement :

  claude mcp add --transport http --scope user synapse \
    https://synapse.bee-consulting.dev/mcp \
    --header "X-Api-Key: TA_CLE_API"
  

• Redémarre Claude Code après l'enregistrement, puis revérifie avec /mcp.
• Contrôle avec claude mcp list : synapse doit apparaître avec l'URL HTTP.

Erreur 401 / « Unauthorized »

La clé API est invalide ou mal copiée.

• Vérifie que tu as bien collé la clé complète dans le header X-Api-Key (sans espace ni guillemet en trop).

• Régénère une clé sur https://synapse.bee-consulting.dev/account/api-keys, puis ré-enregistre :

  claude mcp remove synapse
  claude mcp add --transport http --scope user synapse \
    https://synapse.bee-consulting.dev/mcp \
    --header "X-Api-Key: NOUVELLE_CLE"
  

synapse s'affiche Failed to connect dans /mcp

• Vérifie ta connexion internet et que https://synapse.bee-consulting.dev est joignable.
• Vérifie que l'URL dans l'enregistrement se termine bien par /mcp.
• Relance claude mcp list pour confirmer la configuration enregistrée.

La liste de mes espaces est vide

C'est normal juste après l'installation : tu n'as pas encore créé d'espace. Va sur la page Initialiser un projet pour en créer un.

Je ne vois pas les espaces d'un autre utilisateur

C'est voulu 🔒. Chaque compte ne voit que ses propres espaces (ceux dont il est propriétaire ou membre). L'isolation est garantie par le serveur.

Toujours bloqué ? Contacte l'administrateur de l'instance Synapse — il a accès aux logs du serveur et pourra t'aider.