{"title":"Démarrage rapide (humain)","slug":"quick-start","category":"getting-started","summary":"Inscrivez un compte, créez votre premier mind, stockez une mémoire — en 5 minutes.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":429,"read_minutes":2,"lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Démarrage rapide (humain)\n\nCe guide vous accompagne dans l'obtention d'un compte Synapse, votre première Mind Key\net le stockage de votre première mémoire. Durée totale : ~5 minutes.\n\n## Étape 1 : inscrire un compte\n\nOuvrez l'API Synapse et créez un compte :\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nRéponse :\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> Sauvegardez le JWT en lieu sûr — vous en aurez besoin pour créer des minds. Le JWT\n> expire après 7 jours ; reconnectez-vous avec le même endpoint pour le rafraîchir.\n\n## Étape 2 : créez votre premier mind\n\nUn « mind » est un scope de mémoire isolé. La plupart des utilisateurs commencent avec\nun seul mind, mais vous pouvez en avoir plusieurs (ex. « work », « personal »,\n« project-x »). Chaque mind a sa propre Mind Key unique.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nRéponse :\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **Sauvegardez la `mind_key` immédiatement.** Elle n'est affichée qu'une seule fois\n> et ne peut pas être récupérée plus tard. Si vous la perdez, vous devrez créer un\n> nouveau mind.\n\n## Étape 3 : stockez votre première mémoire\n\nUtilisez maintenant la Mind Key pour stocker une mémoire :\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nRéponse :\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## Étape 4 : rappeler toutes les mémoires\n\nPour récupérer tout ce que vous avez stocké :\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nRéponse (texte brut, optimisée pour la consommation LLM) :\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## Étape 5 : rechercher des mémoires\n\nTrouvez des mémoires spécifiques par mot-clé :\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## Étape 6 : connectez votre LLM\n\nLe moyen le plus simple de donner à votre LLM l'accès à Synapse est via MCP :\n\n- [Configuration Claude Desktop](/docs/mcp/claude-desktop) — config en 2 minutes\n- [Configuration Claude Code](/docs/mcp/claude-code) — intégration terminal\n- [Configuration Cursor](/docs/mcp/cursor) — intégration IDE\n\nAprès configuration, votre LLM appellera automatiquement `memory_recall` au début de\nchaque session et persistera les nouveaux faits via `memory_store`.\n\n## Catégories de mémoire\n\nSynapse prend en charge 8 catégories — choisissez la plus spécifique :\n\n| Catégorie | Cas d'usage |\n|----------|----------|\n| `identity` | Nom d'utilisateur, rôle, infos de contact |\n| `preference` | Goûts, aversions, style de travail |\n| `fact` | Faits vérifiables (détails de projet, dates) |\n| `project` | Statut de projet, jalons, todos |\n| `skill` | Choses dont l'utilisateur est bon |\n| `mistake` | Erreurs passées — à éviter de répéter |\n| `context` | Contexte pertinent à la session |\n| `note` | Notes diverses |\n\n## Niveaux de priorité\n\n- `low` — utile de savoir\n- `normal` — par défaut\n- `high` — important\n- `critical` — à ne jamais oublier (identité utilisateur, infos légales)\n\n## Prochaines étapes\n\n- [Approfondissement authentification](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Référence API Memory](/docs/api/memory)\n- [Intégration MCP](/docs/mcp/what-is-mcp)\n","content_html":"

Démarrage rapide (humain)

\n

Ce guide vous accompagne dans l'obtention d'un compte Synapse, votre première Mind Key\net le stockage de votre première mémoire. Durée totale : ~5 minutes.

\n

Étape 1 : inscrire un compte

\n

Ouvrez l'API Synapse et créez un compte :

\n
curl -X POST https://synapse.schaefer.zone/register \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "email": "you@example.com",\n    "password": "your-secure-password"\n  }'

Réponse :

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
Sauvegardez le JWT en lieu sûr — vous en aurez besoin pour créer des minds. Le JWT\nexpire après 7 jours ; reconnectez-vous avec le même endpoint pour le rafraîchir.

Étape 2 : créez votre premier mind

\n

Un « mind » est un scope de mémoire isolé. La plupart des utilisateurs commencent avec\nun seul mind, mais vous pouvez en avoir plusieurs (ex. « work », « personal »,\n« project-x »). Chaque mind a sa propre Mind Key unique.

\n
curl -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "My First Mind",\n    "description": "Personal assistant memory"\n  }'

Réponse :

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**Sauvegardez la `mind_key` immédiatement.** Elle n'est affichée qu'une seule fois\net ne peut pas être récupérée plus tard. Si vous la perdez, vous devrez créer un\nnouveau mind.

Étape 3 : stockez votre première mémoire

\n

Utilisez maintenant la Mind Key pour stocker une mémoire :

\n
curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "category": "identity",\n    "key": "user_name",\n    "content": "My name is Michael",\n    "tags": ["personal", "identity"],\n    "priority": "critical"\n  }'

Réponse :

\n
{\n  "id": "mem_001",\n  "status": "stored",\n  "mind_id": "m_xyz789"\n}

Étape 4 : rappeler toutes les mémoires

\n

Pour récupérer tout ce que vous avez stocké :

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Réponse (texte brut, optimisée pour la consommation LLM) :

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

Étape 5 : rechercher des mémoires

\n

Trouvez des mémoires spécifiques par mot-clé :

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=michael"

Étape 6 : connectez votre LLM

\n

Le moyen le plus simple de donner à votre LLM l'accès à Synapse est via MCP :

\n\n

Après configuration, votre LLM appellera automatiquement memory_recall au début de\nchaque session et persistera les nouveaux faits via memory_store.

\n

Catégories de mémoire

\n

Synapse prend en charge 8 catégories — choisissez la plus spécifique :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CatégorieCas d'usage
identityNom d'utilisateur, rôle, infos de contact
preferenceGoûts, aversions, style de travail
factFaits vérifiables (détails de projet, dates)
projectStatut de projet, jalons, todos
skillChoses dont l'utilisateur est bon
mistakeErreurs passées — à éviter de répéter
contextContexte pertinent à la session
noteNotes diverses
\n

Niveaux de priorité

\n\n

Prochaines étapes

\n\n","urls":{"html":"/docs/getting-started/quick-start","text":"/docs/getting-started/quick-start?format=text","json":"/docs/getting-started/quick-start?format=json","llm":"/docs/getting-started/quick-start?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}