Mind Key vs JWT — Kapan Menggunakan?

Synapse memiliki dua token autentikasi. Memilih yang salah menyebabkan error 401. Panduan ini memberikan kerangka keputusan yang jelas.

Tabel Keputusan Cepat

Aturan Sederhana

Mind Key — Token Akses Data

Mind Key memberikan akses ke data satu mind. Token berumur panjang yang tidak pernah kedaluwarsa (sampai mind dihapus). Sempurna untuk:

• Agen LLM yang menyimpan memori lintas sesi
• Cron job latar belakang
• Konfigurasi MCP server
• Integrasi webhook
• Aplikasi mobile yang membaca memori

Apa yang dapat dilakukan Mind Key

• GET /memory/recall — membaca semua memori dalam mind ini
• POST /memory — menyimpan/memperbarui memori
• GET /chat/poll — membaca pesan chat
• POST /chat/reply — mengirim pesan chat
• GET /mind/tasks — mendaftar tugas
• POST /mind/task — membuat tugas
• POST /script — menyimpan skrip
• POST /webhooks — mendaftarkan webhook
• POST /computers/:id/commands — mengantri perintah komputer

Apa yang TIDAK dapat dilakukan Mind Key

• Membuat / mendaftar / menghapus mind (memerlukan JWT)
• Berbagi mind dengan pengguna lain (memerlukan JWT)
• Melihat info akun pengguna (memerlukan JWT)
• Berlangganan web push (memerlukan JWT)

JWT — Token Manajemen Akun

JWT mengautentikasi akun pengguna. Kedaluwarsa setelah 7 hari dan digunakan untuk operasi level akun yang mencakup beberapa mind atau melibatkan pengguna lain.

Apa yang dapat dilakukan JWT

• POST /minds — membuat mind baru (mengembalikan Mind Key baru)
• GET /minds — mendaftar semua mind untuk pengguna ini
• DELETE /minds/:id — menghapus mind
• POST /sharing — berbagi mind dengan pengguna lain
• POST /push/subscribe — berlangganan notifikasi web push
• GET /sharing — mendaftar berbagi mind

Apa yang TIDAK dapat dilakukan JWT

• Membaca / menulis memori (memerlukan Mind Key)
• Mengirim pesan chat (memerlukan Mind Key)
• Mengelola tugas (memerlukan Mind Key)
• Mendaftarkan webhook (memerlukan Mind Key)

Kasus Khusus: Computer Token

Endpoint /computers/me/* (sisi agen, untuk screen-remote-agent) menggunakan tipe token ketiga: Computer Token. Token ini dikembalikan oleh POST /computers/register saat menukar kode instalasi, dan spesifik untuk satu komputer terdaftar.

Pola Umum

Pola 1: Agen LLM Tunggal

1. Daftar sekali → dapatkan JWT
2. Buat satu mind → dapatkan Mind Key
3. LLM menggunakan Mind Key untuk semuanya

Pola 2: Agen Multi-Proyek

1. Daftar sekali → dapatkan JWT
2. Buat beberapa mind (kerja, pribadi, proyek-x) → dapatkan beberapa Mind Key
3. LLM memuat Mind Key berbeda berdasarkan konteks

Pola 3: Berbagi Tim

1. Pengguna A membuat mind → dapatkan Mind Key A
2. Pengguna A berbagi dengan Pengguna B melalui JWT (POST /sharing)
3. Pengguna B sekarang dapat mengakses melalui JWT mereka sendiri
4. Untuk akses LLM, Pengguna B perlu membuat Mind Key mereka sendiri (atau menggunakan milik A)

Pola 4: MCP Server

MCP server selalu menggunakan Mind Key (diatur melalui env var SYNAPSE_MIND_KEY). Satu instansi MCP server = satu mind. Untuk akses multi-mind, jalankan beberapa instansi MCP atau implementasikan peralihan mind sisi klien.

Lembar Contoh Format Token

Langkah Berikutnya

• Autentikasi — panduan autentikasi lengkap
• User & Minds API — endpoint yang dilindungi JWT
• Memory API — endpoint yang dilindungi Mind Key