# Démarrage rapide (humain)

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

## Étape 1 : inscrire un compte

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

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

Réponse :

```json
{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}
```

> [!TIP]
> Sauvegardez le JWT en lieu sûr — vous en aurez besoin pour créer des minds. Le JWT
> expire après 7 jours ; reconnectez-vous avec le même endpoint pour le rafraîchir.

## Étape 2 : créez votre premier mind

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

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

Réponse :

```json
{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
```

> [!CRITICAL]
> **Sauvegardez la `mind_key` immédiatement.** Elle n'est affichée qu'une seule fois
> et ne peut pas être récupérée plus tard. Si vous la perdez, vous devrez créer un
> nouveau mind.

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

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

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

Réponse :

```json
{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}
```

## Étape 4 : rappeler toutes les mémoires

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

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

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

```
Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27
```

## Étape 5 : rechercher des mémoires

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

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

## Étape 6 : connectez votre LLM

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

- [Configuration Claude Desktop](/docs/mcp/claude-desktop) — config en 2 minutes
- [Configuration Claude Code](/docs/mcp/claude-code) — intégration terminal
- [Configuration Cursor](/docs/mcp/cursor) — intégration IDE

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

## Catégories de mémoire

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

| Catégorie | Cas d'usage |
|----------|----------|
| `identity` | Nom d'utilisateur, rôle, infos de contact |
| `preference` | Goûts, aversions, style de travail |
| `fact` | Faits vérifiables (détails de projet, dates) |
| `project` | Statut de projet, jalons, todos |
| `skill` | Choses dont l'utilisateur est bon |
| `mistake` | Erreurs passées — à éviter de répéter |
| `context` | Contexte pertinent à la session |
| `note` | Notes diverses |

## Niveaux de priorité

- `low` — utile de savoir
- `normal` — par défaut
- `high` — important
- `critical` — à ne jamais oublier (identité utilisateur, infos légales)

## Prochaines étapes

- [Approfondissement authentification](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Référence API Memory](/docs/api/memory)
- [Intégration MCP](/docs/mcp/what-is-mcp)