{"title":"Mind Key बनाम JWT — क्या कब?","slug":"mind-key-vs-jwt","category":"getting-started","summary":"निर्णय गाइड: एजेंट डेटा एक्सेस के लिए Mind Key, खाता प्रबंधन के लिए JWT।","audience":["human","llm"],"tags":["auth","mind-key","jwt","decision-guide"],"difficulty":"beginner","updated":"2026-06-27","word_count":771,"read_minutes":4,"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":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# Mind Key बनाम JWT — क्या कब?\n\nSynapse में दो प्रमाणीकरण टोकन हैं। गलत चुनने से 401 त्रुटियाँ होती हैं। यह गाइड आपको स्पष्ट निर्णय ढाँचा देता है।\n\n## त्वरित निर्णय तालिका\n\n| आप क्या चाहते हैं... | उपयोग करें |\n|----------------|-----|\n| मेमोरीज़ स्टोर / रिकॉल | Mind Key |\n| चैट संदेश भेजें / poll | Mind Key |\n| कार्य प्रबंधित करें | Mind Key |\n| स्क्रिप्ट्स स्टोर करें | Mind Key |\n| Webhooks पंजीकृत करें | Mind Key |\n| कंप्यूटर्स नियंत्रित करें | Mind Key (उपयोगकर्ता-साइड) / Computer Token (एजेंट-साइड) |\n| उपयोगकर्ता खाता पंजीकृत करें | कोई नहीं (सार्वजनिक) |\n| लॉगिन | कोई नहीं (सार्वजनिक) |\n| Minds बनाएँ / सूचीबद्ध करें / हटाएँ | JWT |\n| अन्य उपयोगकर्ता के साथ mind साझा करें | JWT |\n| Web push सूचनाओं की सदस्यता लें | JWT |\n| ऑडिट लॉग देखें | Mind Key |\n\n## सरल नियम\n\n> [!TIP]\n> **यदि यह एकल mind के डेटा को छूता है → Mind Key।**\n> **यदि यह खाता या mind मेटाडेटा प्रबंधित करता है → JWT।**\n\n## Mind Key — डेटा एक्सेस टोकन\n\nMind Key **एक mind के डेटा** तक पहुँच प्रदान करती है। यह एक दीर्घ-जीवित टोकन है जो कभी समाप्त नहीं होता (जब तक mind हटाया न जाए)। इनके लिए आदर्श:\n\n- सत्रों में मेमोरीज़ बनाए रखने वाले LLM एजेंट्स\n- बैकग्राउंड cron कार्य\n- MCP server कॉन्फ़िगरेशन\n- Webhook इंटीग्रेशन\n- मेमोरी पढ़ने वाले मोबाइल ऐप्स\n\n### Mind Key क्या कर सकती है\n\n- `GET /memory/recall` — इस mind में सभी मेमोरीज़ पढ़ें\n- `POST /memory` — मेमोरीज़ स्टोर/अपडेट करें\n- `GET /chat/poll` — चैट संदेश पढ़ें\n- `POST /chat/reply` — चैट संदेश भेजें\n- `GET /mind/tasks` — कार्य सूचीबद्ध करें\n- `POST /mind/task` — कार्य बनाएँ\n- `POST /script` — स्क्रिप्ट्स स्टोर करें\n- `POST /webhooks` — webhooks पंजीकृत करें\n- `POST /computers/:id/commands` — कंप्यूटर कमांड्स कतारबद्ध करें\n\n### Mind Key क्या नहीं कर सकती\n\n- Minds बनाना / सूचीबद्ध करना / हटाना (JWT चाहिए)\n- अन्य उपयोगकर्ता के साथ mind साझा करना (JWT चाहिए)\n- उपयोगकर्ता खाता जानकारी देखना (JWT चाहिए)\n- Web push की सदस्यता लेना (JWT चाहिए)\n\n## JWT — खाता प्रबंधन टोकन\n\nJWT **उपयोगकर्ता खाते** को प्रमाणित करता है। यह 7 दिनों के बाद समाप्त होता है और खाता-स्तरीय ऑपरेशन्स के लिए उपयोग किया जाता है जो कई minds तक फैले या अन्य उपयोगकर्ताओं को शामिल करें।\n\n### JWT क्या कर सकता है\n\n- `POST /minds` — नया mind बनाएँ (नई Mind Key लौटाता है)\n- `GET /minds` — इस उपयोगकर्ता के सभी minds सूचीबद्ध करें\n- `DELETE /minds/:id` — mind हटाएँ\n- `POST /sharing` — अन्य उपयोगकर्ता के साथ mind साझा करें\n- `POST /push/subscribe` — web push सूचनाओं की सदस्यता लें\n- `GET /sharing` — mind shares सूचीबद्ध करें\n\n### JWT क्या नहीं कर सकता\n\n- मेमोरीज़ पढ़ना / लिखना (Mind Key चाहिए)\n- चैट संदेश भेजना (Mind Key चाहिए)\n- कार्य प्रबंधित करना (Mind Key चाहिए)\n- Webhooks पंजीकृत करना (Mind Key चाहिए)\n\n## विशेष मामला: Computer Token\n\n`/computers/me/*` एंडपॉइंट्स (एजेंट-सामने, screen-remote-agent के लिए) तीसरे टोकन प्रकार का उपयोग करते हैं: **Computer Token**। यह टोकन इंस्टॉल कोड रिडीम करते समय `POST /computers/register` द्वारा लौटाया जाता है, और एक पंजीकृत कंप्यूटर के लिए विशिष्ट है।\n\n| एंडपॉइंट | प्रमाणीकरण |\n|----------|------|\n| `GET /computers/me/poll` | Computer Token |\n| `POST /computers/me/commands/:cid/result` | Computer Token |\n| `GET /computers/list` | Mind Key या JWT |\n| `POST /computers/:id/commands` | Mind Key या JWT |\n\n## सामान्य पैटर्न\n\n### पैटर्न 1: एकल LLM एजेंट\n\n1. एक बार पंजीकरण करें → JWT प्राप्त करें\n2. एक mind बनाएँ → Mind Key प्राप्त करें\n3. LLM सब कुछ के लिए Mind Key का उपयोग करता है\n\n### पैटर्न 2: मल्टी-परियोजना एजेंट\n\n1. एक बार पंजीकरण करें → JWT प्राप्त करें\n2. कई minds बनाएँ (work, personal, project-x) → कई Mind Keys प्राप्त करें\n3. LLM संदर्भ के आधार पर भिन्न Mind Key लोड करता है\n\n### पैटर्न 3: टीम साझाकरण\n\n1. उपयोगकर्ता A एक mind बनाता है → Mind Key A प्राप्त करता है\n2. उपयोगकर्ता A JWT के माध्यम से उपयोगकर्ता B के साथ साझा करता है (`POST /sharing`)\n3. उपयोगकर्ता B अब अपने JWT के माध्यम से एक्सेस कर सकता है\n4. LLM एक्सेस के लिए, उपयोगकर्ता B को अपनी Mind Key बनानी होगी (या A की उपयोग करें)\n\n### पैटर्न 4: MCP Server\n\nMCP servers हमेशा Mind Key का उपयोग करते हैं (`SYNAPSE_MIND_KEY` env var के माध्यम से सेट)। एक MCP server इंस्टेंस = एक mind। मल्टी-mind एक्सेस के लिए, कई MCP इंस्टेंस चलाएँ या क्लाइंट-साइड mind-स्विचिंग लागू करें।\n\n## टोकन प्रारूप चीट शीट\n\n| टोकन | प्रारूप | उदाहरण |\n|-------|--------|---------|\n| Mind Key | `mk_` + 36 chars | `mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789` |\n| JWT | `eyJ` + base64 | `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` |\n| Computer Token | `ct_` + 36 chars | `ct_xYzAbCdEfGhIjKlMnOpQrStUvWxYz0123456789` |\n\n## अगले कदम\n\n- [प्रमाणीकरण](/docs/getting-started/authentication) — पूर्ण प्रमाणीकरण गाइड\n- [User और Minds API](/docs/api/user) — JWT-सुरक्षित एंडपॉइंट्स\n- [Memory API](/docs/api/memory) — Mind Key-सुरक्षित एंडपॉइंट्स\n","content_html":"<h1>Mind Key बनाम JWT — क्या कब?</h1>\n<p>Synapse में दो प्रमाणीकरण टोकन हैं। गलत चुनने से 401 त्रुटियाँ होती हैं। यह गाइड आपको स्पष्ट निर्णय ढाँचा देता है।</p>\n<h2>त्वरित निर्णय तालिका</h2>\n<table>\n<thead>\n<tr>\n<th>आप क्या चाहते हैं...</th>\n<th>उपयोग करें</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>मेमोरीज़ स्टोर / रिकॉल</td>\n<td>Mind Key</td>\n</tr>\n<tr>\n<td>चैट संदेश भेजें / poll</td>\n<td>Mind Key</td>\n</tr>\n<tr>\n<td>कार्य प्रबंधित करें</td>\n<td>Mind Key</td>\n</tr>\n<tr>\n<td>स्क्रिप्ट्स स्टोर करें</td>\n<td>Mind Key</td>\n</tr>\n<tr>\n<td>Webhooks पंजीकृत करें</td>\n<td>Mind Key</td>\n</tr>\n<tr>\n<td>कंप्यूटर्स नियंत्रित करें</td>\n<td>Mind Key (उपयोगकर्ता-साइड) / Computer Token (एजेंट-साइड)</td>\n</tr>\n<tr>\n<td>उपयोगकर्ता खाता पंजीकृत करें</td>\n<td>कोई नहीं (सार्वजनिक)</td>\n</tr>\n<tr>\n<td>लॉगिन</td>\n<td>कोई नहीं (सार्वजनिक)</td>\n</tr>\n<tr>\n<td>Minds बनाएँ / सूचीबद्ध करें / हटाएँ</td>\n<td>JWT</td>\n</tr>\n<tr>\n<td>अन्य उपयोगकर्ता के साथ mind साझा करें</td>\n<td>JWT</td>\n</tr>\n<tr>\n<td>Web push सूचनाओं की सदस्यता लें</td>\n<td>JWT</td>\n</tr>\n<tr>\n<td>ऑडिट लॉग देखें</td>\n<td>Mind Key</td>\n</tr>\n</tbody></table>\n<h2>सरल नियम</h2>\n<div class=\"callout callout-ok\">**यदि यह एकल mind के डेटा को छूता है → Mind Key।**\n**यदि यह खाता या mind मेटाडेटा प्रबंधित करता है → JWT।**</div><h2>Mind Key — डेटा एक्सेस टोकन</h2>\n<p>Mind Key <strong>एक mind के डेटा</strong> तक पहुँच प्रदान करती है। यह एक दीर्घ-जीवित टोकन है जो कभी समाप्त नहीं होता (जब तक mind हटाया न जाए)। इनके लिए आदर्श:</p>\n<ul>\n<li>सत्रों में मेमोरीज़ बनाए रखने वाले LLM एजेंट्स</li>\n<li>बैकग्राउंड cron कार्य</li>\n<li>MCP server कॉन्फ़िगरेशन</li>\n<li>Webhook इंटीग्रेशन</li>\n<li>मेमोरी पढ़ने वाले मोबाइल ऐप्स</li>\n</ul>\n<h3>Mind Key क्या कर सकती है</h3>\n<ul>\n<li><code>GET /memory/recall</code> — इस mind में सभी मेमोरीज़ पढ़ें</li>\n<li><code>POST /memory</code> — मेमोरीज़ स्टोर/अपडेट करें</li>\n<li><code>GET /chat/poll</code> — चैट संदेश पढ़ें</li>\n<li><code>POST /chat/reply</code> — चैट संदेश भेजें</li>\n<li><code>GET /mind/tasks</code> — कार्य सूचीबद्ध करें</li>\n<li><code>POST /mind/task</code> — कार्य बनाएँ</li>\n<li><code>POST /script</code> — स्क्रिप्ट्स स्टोर करें</li>\n<li><code>POST /webhooks</code> — webhooks पंजीकृत करें</li>\n<li><code>POST /computers/:id/commands</code> — कंप्यूटर कमांड्स कतारबद्ध करें</li>\n</ul>\n<h3>Mind Key क्या नहीं कर सकती</h3>\n<ul>\n<li>Minds बनाना / सूचीबद्ध करना / हटाना (JWT चाहिए)</li>\n<li>अन्य उपयोगकर्ता के साथ mind साझा करना (JWT चाहिए)</li>\n<li>उपयोगकर्ता खाता जानकारी देखना (JWT चाहिए)</li>\n<li>Web push की सदस्यता लेना (JWT चाहिए)</li>\n</ul>\n<h2>JWT — खाता प्रबंधन टोकन</h2>\n<p>JWT <strong>उपयोगकर्ता खाते</strong> को प्रमाणित करता है। यह 7 दिनों के बाद समाप्त होता है और खाता-स्तरीय ऑपरेशन्स के लिए उपयोग किया जाता है जो कई minds तक फैले या अन्य उपयोगकर्ताओं को शामिल करें।</p>\n<h3>JWT क्या कर सकता है</h3>\n<ul>\n<li><code>POST /minds</code> — नया mind बनाएँ (नई Mind Key लौटाता है)</li>\n<li><code>GET /minds</code> — इस उपयोगकर्ता के सभी minds सूचीबद्ध करें</li>\n<li><code>DELETE /minds/:id</code> — mind हटाएँ</li>\n<li><code>POST /sharing</code> — अन्य उपयोगकर्ता के साथ mind साझा करें</li>\n<li><code>POST /push/subscribe</code> — web push सूचनाओं की सदस्यता लें</li>\n<li><code>GET /sharing</code> — mind shares सूचीबद्ध करें</li>\n</ul>\n<h3>JWT क्या नहीं कर सकता</h3>\n<ul>\n<li>मेमोरीज़ पढ़ना / लिखना (Mind Key चाहिए)</li>\n<li>चैट संदेश भेजना (Mind Key चाहिए)</li>\n<li>कार्य प्रबंधित करना (Mind Key चाहिए)</li>\n<li>Webhooks पंजीकृत करना (Mind Key चाहिए)</li>\n</ul>\n<h2>विशेष मामला: Computer Token</h2>\n<p><code>/computers/me/*</code> एंडपॉइंट्स (एजेंट-सामने, screen-remote-agent के लिए) तीसरे टोकन प्रकार का उपयोग करते हैं: <strong>Computer Token</strong>। यह टोकन इंस्टॉल कोड रिडीम करते समय <code>POST /computers/register</code> द्वारा लौटाया जाता है, और एक पंजीकृत कंप्यूटर के लिए विशिष्ट है।</p>\n<table>\n<thead>\n<tr>\n<th>एंडपॉइंट</th>\n<th>प्रमाणीकरण</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>GET /computers/me/poll</code></td>\n<td>Computer Token</td>\n</tr>\n<tr>\n<td><code>POST /computers/me/commands/:cid/result</code></td>\n<td>Computer Token</td>\n</tr>\n<tr>\n<td><code>GET /computers/list</code></td>\n<td>Mind Key या JWT</td>\n</tr>\n<tr>\n<td><code>POST /computers/:id/commands</code></td>\n<td>Mind Key या JWT</td>\n</tr>\n</tbody></table>\n<h2>सामान्य पैटर्न</h2>\n<h3>पैटर्न 1: एकल LLM एजेंट</h3>\n<ol>\n<li>एक बार पंजीकरण करें → JWT प्राप्त करें</li>\n<li>एक mind बनाएँ → Mind Key प्राप्त करें</li>\n<li>LLM सब कुछ के लिए Mind Key का उपयोग करता है</li>\n</ol>\n<h3>पैटर्न 2: मल्टी-परियोजना एजेंट</h3>\n<ol>\n<li>एक बार पंजीकरण करें → JWT प्राप्त करें</li>\n<li>कई minds बनाएँ (work, personal, project-x) → कई Mind Keys प्राप्त करें</li>\n<li>LLM संदर्भ के आधार पर भिन्न Mind Key लोड करता है</li>\n</ol>\n<h3>पैटर्न 3: टीम साझाकरण</h3>\n<ol>\n<li>उपयोगकर्ता A एक mind बनाता है → Mind Key A प्राप्त करता है</li>\n<li>उपयोगकर्ता A JWT के माध्यम से उपयोगकर्ता B के साथ साझा करता है (<code>POST /sharing</code>)</li>\n<li>उपयोगकर्ता B अब अपने JWT के माध्यम से एक्सेस कर सकता है</li>\n<li>LLM एक्सेस के लिए, उपयोगकर्ता B को अपनी Mind Key बनानी होगी (या A की उपयोग करें)</li>\n</ol>\n<h3>पैटर्न 4: MCP Server</h3>\n<p>MCP servers हमेशा Mind Key का उपयोग करते हैं (<code>SYNAPSE_MIND_KEY</code> env var के माध्यम से सेट)। एक MCP server इंस्टेंस = एक mind। मल्टी-mind एक्सेस के लिए, कई MCP इंस्टेंस चलाएँ या क्लाइंट-साइड mind-स्विचिंग लागू करें।</p>\n<h2>टोकन प्रारूप चीट शीट</h2>\n<table>\n<thead>\n<tr>\n<th>टोकन</th>\n<th>प्रारूप</th>\n<th>उदाहरण</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Mind Key</td>\n<td><code>mk_</code> + 36 chars</td>\n<td><code>mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789</code></td>\n</tr>\n<tr>\n<td>JWT</td>\n<td><code>eyJ</code> + base64</td>\n<td><code>eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...</code></td>\n</tr>\n<tr>\n<td>Computer Token</td>\n<td><code>ct_</code> + 36 chars</td>\n<td><code>ct_xYzAbCdEfGhIjKlMnOpQrStUvWxYz0123456789</code></td>\n</tr>\n</tbody></table>\n<h2>अगले कदम</h2>\n<ul>\n<li><a href=\"/docs/getting-started/authentication\">प्रमाणीकरण</a> — पूर्ण प्रमाणीकरण गाइड</li>\n<li><a href=\"/docs/api/user\">User और Minds API</a> — JWT-सुरक्षित एंडपॉइंट्स</li>\n<li><a href=\"/docs/api/memory\">Memory API</a> — Mind Key-सुरक्षित एंडपॉइंट्स</li>\n</ul>\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"]}