Authentification & Mind Keys

Synapse utilise deux méthodes d'authentification, chacune optimisée pour un cas d'usage différent. Comprendre la différence est essentiel pour construire des intégrations fiables.

Deux méthodes d'auth

Mind Key (pour les agents)

Une Mind Key est un jeton d'API limité au tenant. Elle authentifie les données d'un seul mind (mémoires, tâches, chat, scripts, etc.). Utilisez-la pour :

• Les agents LLM appelant l'API
• Les scripts d'automatisation en arrière-plan
• La configuration du serveur MCP
• Toute intégration longue durée

Authentification par en-tête (recommandée)

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

Paramètre de requête (pour les outils n'utilisant que des URLs)

curl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere

Créer une Mind Key

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "Work Mind", "description": "Project memories"}'

La réponse inclut mind_key — sauvegardez-la immédiatement, elle n'est affichée qu'une seule fois.

Lister vos minds

curl -H "Authorization: Bearer YOUR_JWT" \
     https://synapse.schaefer.zone/minds

Supprimer un mind (irréversible !)

curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \
     https://synapse.schaefer.zone/minds/m_xyz789

JWT (pour les humains)

Les JWT authentifient le compte utilisateur, pas un mind spécifique. Utilisez-les pour :

• L'inscription et la connexion au compte
• La création / liste / suppression de minds
• Le partage de minds avec d'autres utilisateurs
• La gestion des abonnements Web Push

Inscription

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

Renvoie : { "jwt": "eyJ...", "user": {...} }

Connexion

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

Renvoie : { "jwt": "eyJ...", "user": {...} }

Expiration du JWT

Les JWT expirent après 7 jours. Une fois expirés, appelez simplement /login à nouveau pour en obtenir un nouveau. La Mind Key n'expire jamais, donc les intégrations d'agents existantes continuent de fonctionner.

Bonnes pratiques de sécurité

Schéma de variable d'environnement

# .env (NE JAMAIS commiter ce fichier)
SYNAPSE_MIND_KEY=mk_yourMindKeyHere
SYNAPSE_URL=https://synapse.schaefer.zone

// Node.js
const mindKey = process.env.SYNAPSE_MIND_KEY;
const url = process.env.SYNAPSE_URL;
await fetch(`${url}/memory/recall`, {
  headers: { Authorization: `Bearer ${mindKey}` },
});

Configuration du serveur MCP

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_yourMindKeyHere",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

Schéma multi-mind

Chaque utilisateur peut avoir plusieurs minds. Schémas courants :

Utilisez différentes Mind Keys pour différentes sessions LLM afin de garder les contextes isolés.

Limites de débit

Les en-têtes de limite de débit (X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After) sont inclus dans les réponses le cas échéant.

Prochaines étapes

• Mind Key vs JWT — quand utiliser laquelle
• API Memory — ce que vous pouvez faire avec une Mind Key
• API User — gestion de compte avec JWT