Mind Key vs JWT — vad när?

Synapse har två autentiseringstoken. Att välja fel leder till 401-fel. Den här guiden ger er ett tydligt beslutsramverk.

Snabb beslutstabell

Den enkla regeln

Mind Key — dataåtkomsttoken

En Mind Key ger åtkomst till en minds data. Det är en långlivad token som aldrig löper ut (tills minden tas bort). Perfekt för:

• LLM-agenter som persistens minnen mellan sessioner
• Bakgrunds-cron-jobb
• MCP-serverkonfiguration
• Webhook-integrationer
• Mobilappar som läser minne

Vad Mind Key kan göra

• GET /memory/recall — läsa alla minnen i denna mind
• POST /memory — lagra/uppdatera minnen
• GET /chat/poll — läsa chattmeddelanden
• POST /chat/reply — skicka chattmeddelanden
• GET /mind/tasks — lista uppgifter
• POST /mind/task — skapa uppgifter
• POST /script — lagra skript
• POST /webhooks — registrera webhooks
• POST /computers/:id/commands — köa datorkommandon

Vad Mind Key INTE kan göra

• Skapa / lista / ta bort minds (behöver JWT)
• Dela mind med annan användare (behöver JWT)
• Visa användarkontoinfo (behöver JWT)
• Prenumerera på web push (behöver JWT)

JWT — token för kontohantering

En JWT autentiserar användarkontot. Den löper ut efter 7 dagar och används för kontooperationer som spänner över flera minds eller involverar andra användare.

Vad JWT kan göra

• POST /minds — skapa en ny mind (returnerar en ny Mind Key)
• GET /minds — lista alla minds för denna användare
• DELETE /minds/:id — ta bort en mind
• POST /sharing — dela en mind med en annan användare
• POST /push/subscribe — prenumerera på web push-aviseringar
• GET /sharing — lista mind-delningar

Vad JWT INTE kan göra

• Läsa / skriva minnen (behöver Mind Key)
• Skicka chattmeddelanden (behöver Mind Key)
• Hantera uppgifter (behöver Mind Key)
• Registrera webhooks (behöver Mind Key)

Specialfall: Computer Token

/computers/me/*-endpoints (agentriktade, för screen-remote-agent) använder en tredje tokentyp: Computer Token. Denna token returneras av POST /computers/register när en installationskod löses in och är specifik för en registrerad dator.

Vanliga mönster

Mönster 1: Enskild LLM-agent

1. Registrera en gång → få JWT
2. Skapa en mind → få Mind Key
3. LLM använder Mind Key för allt

Mönster 2: Flerprojektsagent

1. Registrera en gång → få JWT
2. Skapa flera minds (work, personal, project-x) → få flera Mind Keys
3. LLM laddar olika Mind Key baserat på kontext

Mönster 3: Team-delning

1. Användare A skapar en mind → får Mind Key A
2. Användare A delar med Användare B via JWT (POST /sharing)
3. Användare B kan nu komma åt via sin egen JWT
4. För LLM-åtkomst måste Användare B skapa sin egen Mind Key (eller använda A:s)

Mönster 4: MCP-server

MCP-servrar använder alltid Mind Key (satt via SYNAPSE_MIND_KEY-miljövariabel). En MCP-serverinstans = en mind. För multi-mind-åtkomst, kör flera MCP-instanser eller implementera klientbaserad mind-växling.

Fusklapp för tokenformat

Nästa steg

• Autentisering — fullständig auth-guide
• User & Minds API — JWT-skyddade endpoints
• Memory API — Mind Key-skyddade endpoints