{"title":"Mind Key vs JWT — ใช้เมื่อไร?","slug":"mind-key-vs-jwt","category":"getting-started","summary":"คู่มือการตัดสินใจ: Mind Key สำหรับการเข้าถึงข้อมูล agent, JWT สำหรับการจัดการบัญชี","audience":["human","llm"],"tags":["auth","mind-key","jwt","decision-guide"],"difficulty":"beginner","updated":"2026-06-27","word_count":553,"read_minutes":3,"llm_context":"Mind Key: tenant-scoped, never expires, for memory/chat/tasks/scripts/computers/webhooks.\nJWT: user-scoped, 7-day expiry, for /register, /login, /minds (CRUD), /sharing, /push.\nSimple rule: if it touches a single mind's data → Mind Key. If it manages the account → JWT.\nException: /computers/me/* uses Computer Token (not Mind Key or JWT).\n","lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# Mind Key vs JWT — ใช้เมื่อไร?\n\nSynapse มีสอง authentication token การเลือกผิดจะนำไปสู่ error 401 คู่มือนี้ให้กรอบการตัดสินใจที่ชัดเจน\n\n## ตารางการตัดสินใจด่วน\n\n| คุณต้องการ... | ใช้ |\n|----------------|-----|\n| จัดเก็บ / recall memory | Mind Key |\n| ส่ง / poll ข้อความแช็ต | Mind Key |\n| จัดการ task | Mind Key |\n| เก็บ script | Mind Key |\n| ลงทะเบียน webhook | Mind Key |\n| ควบคุม computer | Mind Key (ฝั่งผู้ใช้) / Computer Token (ฝั่ง agent) |\n| สมัครบัญชีผู้ใช้ | None (public) |\n| ล็อกอิน | None (public) |\n| สร้าง / รายการ / ลบ mind | JWT |\n| แชร์ mind กับผู้ใช้อื่น | JWT |\n| สมัครรับ web push notification | JWT |\n| ดู audit log | Mind Key |\n\n## กฎง่าย ๆ\n\n> [!TIP]\n> **หากมันสัมผัสข้อมูล mind เดียว → Mind Key**\n> **หากมันจัดการบัญชีหรือ metadata ของ mind → JWT**\n\n## Mind Key — Data Access Token\n\nMind Key ให้สิทธิ์เข้าถึง **ข้อมูล mind หนึ่ง** เป็น token ที่อยู่ยาวนานและไม่หมดอายุ (จนกว่า mind จะถูกลบ) เหมาะสำหรับ:\n\n- LLM agent ที่เก็บ memory ข้าม session\n- cron job เบื้องหลัง\n- กำหนดค่า MCP server\n- integration webhook\n- แอปมือถือที่อ่าน memory\n\n### Mind Key ทำอะไรได้\n\n- `GET /memory/recall` — อ่าน memory ทั้งหมดใน mind นี้\n- `POST /memory` — เก็บ/อัปเดต memory\n- `GET /chat/poll` — อ่านข้อความแช็ต\n- `POST /chat/reply` — ส่งข้อความแช็ต\n- `GET /mind/tasks` — รายการ task\n- `POST /mind/task` — สร้าง task\n- `POST /script` — เก็บ script\n- `POST /webhooks` — ลงทะเบียน webhook\n- `POST /computers/:id/commands` — จัดคิวคำสั่ง computer\n\n### Mind Key ทำอะไรไม่ได้\n\n- สร้าง / รายการ / ลบ mind (ต้องใช้ JWT)\n- แชร์ mind กับผู้ใช้อื่น (ต้องใช้ JWT)\n- ดูข้อมูลบัญชีผู้ใช้ (ต้องใช้ JWT)\n- สมัครรับ web push (ต้องใช้ JWT)\n\n## JWT — Account Management Token\n\nJWT ยืนยันตัวตน **บัญชีผู้ใช้** หมดอายุหลัง 7 วัน และใช้สำหรับการดำเนินการระดับบัญชีที่ครอบคลุมหลาย mind หรือเกี่ยวข้องกับผู้ใช้อื่น\n\n### JWT ทำอะไรได้\n\n- `POST /minds` — สร้าง mind ใหม่ (ส่งกลับ Mind Key ใหม่)\n- `GET /minds` — รายการ mind ทั้งหมดของผู้ใช้นี้\n- `DELETE /minds/:id` — ลบ mind\n- `POST /sharing` — แชร์ mind กับผู้ใช้อื่น\n- `POST /push/subscribe` — สมัครรับ web push notification\n- `GET /sharing` — รายการการแชร์ mind\n\n### JWT ทำอะไรไม่ได้\n\n- อ่าน / เขียน memory (ต้องใช้ Mind Key)\n- ส่งข้อความแช็ต (ต้องใช้ Mind Key)\n- จัดการ task (ต้องใช้ Mind Key)\n- ลงทะเบียน webhook (ต้องใช้ Mind Key)\n\n## กรณีพิเศษ: Computer Token\n\nendpoint `/computers/me/*` (ฝั่ง agent, สำหรับ screen-remote-agent) ใช้ token ประเภทที่สาม: **Computer Token** token นี้ถูกส่งกลับโดย `POST /computers/register` เมื่อแลกรับ install code และเฉพาะสำหรับ computer ที่ลงทะเบียนหนึ่งเครื่อง\n\n| Endpoint | Auth |\n|----------|------|\n| `GET /computers/me/poll` | Computer Token |\n| `POST /computers/me/commands/:cid/result` | Computer Token |\n| `GET /computers/list` | Mind Key or JWT |\n| `POST /computers/:id/commands` | Mind Key or JWT |\n\n## รูปแบบทั่วไป\n\n### รูปแบบ 1: LLM Agent เดียว\n\n1. สมัครครั้งเดียว → รับ JWT\n2. สร้าง mind เดียว → รับ Mind Key\n3. LLM ใช้ Mind Key สำหรับทุกอย่าง\n\n### รูปแบบ 2: Agent หลายโปรเจกต์\n\n1. สมัครครั้งเดียว → รับ JWT\n2. สร้างหลาย mind (work, personal, project-x) → รับหลาย Mind Key\n3. LLM โหลด Mind Key ต่างกันตาม context\n\n### รูปแบบ 3: การแชร์ในทีม\n\n1. ผู้ใช้ A สร้าง mind → ได้ Mind Key A\n2. ผู้ใช้ A แชร์กับผู้ใช้ B ผ่าน JWT (`POST /sharing`)\n3. ผู้ใช้ B สามารถเข้าถึงผ่าน JWT ของตนเอง\n4. สำหรับการเข้าถึง LLM, ผู้ใช้ B ต้องสร้าง Mind Key ของตนเอง (หรือใช้ของ A)\n\n### รูปแบบ 4: MCP Server\n\nMCP server ใช้ Mind Key เสมอ (ตั้งผ่าน env var `SYNAPSE_MIND_KEY`) หนึ่ง MCP server instance = หนึ่ง mind สำหรับการเข้าถึงหลาย mind ให้รันหลาย MCP instance หรือ implement mind switching ฝั่ง client\n\n## Cheat Sheet รูปแบบ Token\n\n| Token | รูปแบบ | ตัวอย่าง |\n|-------|--------|---------|\n| Mind Key | `mk_` + 36 ตัวอักษร | `mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789` |\n| JWT | `eyJ` + base64 | `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` |\n| Computer Token | `ct_` + 36 ตัวอักษร | `ct_xYzAbCdEfGhIjKlMnOpQrStUvWxYz0123456789` |\n\n## ขั้นตอนถัดไป\n\n- [Authentication](/docs/getting-started/authentication) — คู่มือ auth แบบเต็ม\n- [User & Minds API](/docs/api/user) — endpoint ที่ป้องกันด้วย JWT\n- [Memory API](/docs/api/memory) — endpoint ที่ป้องกันด้วย Mind Key\n","content_html":"

Mind Key vs JWT — ใช้เมื่อไร?

\n

Synapse มีสอง authentication token การเลือกผิดจะนำไปสู่ error 401 คู่มือนี้ให้กรอบการตัดสินใจที่ชัดเจน

\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\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
คุณต้องการ...ใช้
จัดเก็บ / recall memoryMind Key
ส่ง / poll ข้อความแช็ตMind Key
จัดการ taskMind Key
เก็บ scriptMind Key
ลงทะเบียน webhookMind Key
ควบคุม computerMind Key (ฝั่งผู้ใช้) / Computer Token (ฝั่ง agent)
สมัครบัญชีผู้ใช้None (public)
ล็อกอินNone (public)
สร้าง / รายการ / ลบ mindJWT
แชร์ mind กับผู้ใช้อื่นJWT
สมัครรับ web push notificationJWT
ดู audit logMind Key
\n

กฎง่าย ๆ

\n
**หากมันสัมผัสข้อมูล mind เดียว → Mind Key**\n**หากมันจัดการบัญชีหรือ metadata ของ mind → JWT**

Mind Key — Data Access Token

\n

Mind Key ให้สิทธิ์เข้าถึง ข้อมูล mind หนึ่ง เป็น token ที่อยู่ยาวนานและไม่หมดอายุ (จนกว่า mind จะถูกลบ) เหมาะสำหรับ:

\n\n

Mind Key ทำอะไรได้

\n\n

Mind Key ทำอะไรไม่ได้

\n\n

JWT — Account Management Token

\n

JWT ยืนยันตัวตน บัญชีผู้ใช้ หมดอายุหลัง 7 วัน และใช้สำหรับการดำเนินการระดับบัญชีที่ครอบคลุมหลาย mind หรือเกี่ยวข้องกับผู้ใช้อื่น

\n

JWT ทำอะไรได้

\n\n

JWT ทำอะไรไม่ได้

\n\n

กรณีพิเศษ: Computer Token

\n

endpoint /computers/me/* (ฝั่ง agent, สำหรับ screen-remote-agent) ใช้ token ประเภทที่สาม: Computer Token token นี้ถูกส่งกลับโดย POST /computers/register เมื่อแลกรับ install code และเฉพาะสำหรับ computer ที่ลงทะเบียนหนึ่งเครื่อง

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EndpointAuth
GET /computers/me/pollComputer Token
POST /computers/me/commands/:cid/resultComputer Token
GET /computers/listMind Key or JWT
POST /computers/:id/commandsMind Key or JWT
\n

รูปแบบทั่วไป

\n

รูปแบบ 1: LLM Agent เดียว

\n
    \n
  1. สมัครครั้งเดียว → รับ JWT
    2. \n
  2. สร้าง mind เดียว → รับ Mind Key
    3. \n
  3. LLM ใช้ Mind Key สำหรับทุกอย่าง
    4. \n
\n

รูปแบบ 2: Agent หลายโปรเจกต์

\n
    \n
  1. สมัครครั้งเดียว → รับ JWT
    2. \n
  2. สร้างหลาย mind (work, personal, project-x) → รับหลาย Mind Key
    3. \n
  3. LLM โหลด Mind Key ต่างกันตาม context
    4. \n
\n

รูปแบบ 3: การแชร์ในทีม

\n
    \n
  1. ผู้ใช้ A สร้าง mind → ได้ Mind Key A
    2. \n
  2. ผู้ใช้ A แชร์กับผู้ใช้ B ผ่าน JWT (POST /sharing)
    3. \n
  3. ผู้ใช้ B สามารถเข้าถึงผ่าน JWT ของตนเอง
    4. \n
  4. สำหรับการเข้าถึง LLM, ผู้ใช้ B ต้องสร้าง Mind Key ของตนเอง (หรือใช้ของ A)
    5. \n
\n

รูปแบบ 4: MCP Server

\n

MCP server ใช้ Mind Key เสมอ (ตั้งผ่าน env var SYNAPSE_MIND_KEY) หนึ่ง MCP server instance = หนึ่ง mind สำหรับการเข้าถึงหลาย mind ให้รันหลาย MCP instance หรือ implement mind switching ฝั่ง client

\n

Cheat Sheet รูปแบบ Token

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Tokenรูปแบบตัวอย่าง
Mind Keymk_ + 36 ตัวอักษรmk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789
JWTeyJ + base64eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Computer Tokenct_ + 36 ตัวอักษรct_xYzAbCdEfGhIjKlMnOpQrStUvWxYz0123456789
\n

ขั้นตอนถัดไป

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