Démarrer avec Synapse
Bienvenue 👋 — ce guide t'explique, étape par étape, comment utiliser cette instance Synapse comme outil de documentation de tes projets, piloté automatiquement par Claude Code via le serveur MCP synapse.
Qu'est-ce que Synapse ? Un mini-wiki auto-hébergé (espaces + pages Markdown arborescentes) avec une API REST. Couplé au serveur MCP, il permet à Claude Code de lire et tenir à jour la doc de tes projets tout seul, dans toutes tes sessions.
🔒 Isolation garantie. Ton compte ne voit que tes espaces. Tu ne touches pas à ceux des autres utilisateurs, et inversement — même instance, données cloisonnées.
Comment fonctionne le couplage
┌─────────────┐ HTTP + MCP ┌──────────────────────────────────┐
│ Claude Code │ ─────────────────▶ │ Serveur MCP Synapse (distant) │
│ (ton poste)│ tools synapse_* │ synapse.bee-consulting.dev/mcp │
└─────────────┘ header X-Api-Key └──────────────────────────────────┘
Claude appelle des tools synapse_* ; le serveur MCP distant traduit ces appels en requêtes vers l'API Synapse, authentifiées par ta clé API. Le serveur est hébergé et mis à jour côté Synapse — tu n'installes rien en local, et n'as jamais de mise à jour à faire.
Sommaire — suis les étapes dans l'ordre
- Prérequis — ce qu'il te faut avant de commencer (très peu !).
- Créer ton compte et ta clé API — inscription + génération de la clé.
- Connecter le serveur MCP — une seule commande, zéro installation.
- Apprendre à Claude à utiliser Synapse — règles dans ton
~/.claude/CLAUDE.md. - Initialiser un projet — relier un projet à un espace.
- Dépannage — les pannes courantes et leurs solutions.
💡 Chaque étape est une page dédiée (menu de gauche). Commence par les Prérequis.