{"title":"Kimlik Doğrulama & Mind Key'ler","slug":"authentication","category":"getting-started","summary":"Synapse kimlik doğrulaması nasıl çalışır: ajanlar için Mind Key, insanlar için JWT, yalnızca URL kullanan araçlar için ?key=.","audience":["human","llm"],"tags":["auth","mind-key","jwt","security"],"difficulty":"beginner","updated":"2026-06-27","word_count":469,"read_minutes":2,"llm_context":"Two auth methods: Mind Key (token-scoped, never expires) and JWT (user-scoped, 7-day expiry).\nMind Key: Authorization: Bearer mk_xxx OR ?key=mk_xxx (60 req/min limit on query)\nJWT: Authorization: Bearer eyJ... (no rate limit, used for /register, /login, /minds, /sharing)\nMind Key is shown only once at creation. Store it permanently.\nEach mind has exactly one Mind Key. Multiple minds = multiple keys.\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Kimlik Doğrulama & Mind Key'ler\n\nSynapse, her biri farklı bir kullanım senaryosu için optimize edilmiş iki kimlik doğrulama yöntemi kullanır. Güvenilir entegrasyonlar oluşturmak için farkı anlamak esastır.\n\n## İki Kimlik Doğrulama Yöntemi\n\n| Yöntem | Kullanım Senaryosu | Hız Sınırı | Son Kullanma |\n|--------|----------|------------|--------|\n| **Mind Key** | LLM ajanları, otomatik araçlar | Yok (header) / 60 dk (sorgu) | Asla |\n| **JWT** | İnsana yönelik arayüz, hesap işlemleri | Yok | 7 gün |\n\n## Mind Key (Ajanlar için)\n\nMind Key, kiracı kapsamlı bir API token'ıdır. Tek bir mind'in verilerini (bellekler, görevler, sohbet, betikler vb.) doğrular. Şunlar için kullanın:\n\n- API çağrısı yapan LLM ajanları\n- Arka plan otomasyon betikleri\n- MCP sunucu yapılandırması\n- Herhangi bir uzun ömürlü entegrasyon\n\n### Header kimlik doğrulaması (önerilir)\n\n```bash\ncurl -H \"Authorization: Bearer mk_yourMindKeyHere\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n### Sorgu parametresi (yalnızca URL kullanan araçlar için)\n\n```bash\ncurl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere\n```\n\n> [!WARNING]\n> `?key=` sorgu parametresi **dakikada 60 istek** ile sınırlıdır. Bearer header'ın hız sınırı yoktur. İstemciniz özel başlıkları desteklediğinde header'ı kullanın.\n\n### Mind Key Oluşturma\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\": \"Work Mind\", \"description\": \"Project memories\"}'\n```\n\nYanıt `mind_key` içerir — **hemen kaydedin**, yalnızca bir kez gösterilir.\n\n### Mind'lerinizi listeleme\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\n### Bir mind'i silme (geri alınamaz!)\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n## JWT (İnsanlar için)\n\nJWT'ler belirli bir mind'i değil, **kullanıcı hesabını** doğrular. Şunlar için kullanın:\n\n- Hesap kaydı ve giriş\n- Mind oluşturma / listeleme / silme\n- Mind'leri diğer kullanıcılarla paylaşma\n- Web Push abonelik yönetimi\n\n### Kaydol\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\"email\": \"you@example.com\", \"password\": \"secret\"}'\n```\n\nDöndürür: `{ \"jwt\": \"eyJ...\", \"user\": {...} }`\n\n### Giriş\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/login \\\n -H \"Content-Type: application/json\" \\\n -d '{\"email\": \"you@example.com\", \"password\": \"secret\"}'\n```\n\nDöndürür: `{ \"jwt\": \"eyJ...\", \"user\": {...} }`\n\n### JWT son kullanma\n\nJWT'ler **7 gün** sonra sona erer. Bir JWT sona erdiğinde, yenisini almak için `/login` çağırın. Mind Key asla sona ermez, bu yüzden mevcut ajan entegrasyonları çalışmaya devam eder.\n\n## Güvenlik En İyi Uygulamaları\n\n> [!CRITICAL]\n> - **Mind Key'leri asla git'e commit etmeyin.** Ortam değişkenleri kullanın.\n> - **Mind Key'leri asla loglamayın.** Loglarda maskeleyin (`mk_***...***xyz`).\n> - Bir sızıntıdan şüphelenirseniz **anahtarları döndürün** (mind'i silin, yeni oluşturun).\n> - Bir anahtar sızarsa etki alanını sınırlamak için **proje başına bir mind** kullanın.\n\n### Ortam değişkeni deseni\n\n```bash\n# .env (NEVER commit this file)\nSYNAPSE_MIND_KEY=mk_yourMindKeyHere\nSYNAPSE_URL=https://synapse.schaefer.zone\n```\n\n```typescript\n// Node.js\nconst mindKey = process.env.SYNAPSE_MIND_KEY;\nconst url = process.env.SYNAPSE_URL;\nawait fetch(`${url}/memory/recall`, {\n headers: { Authorization: `Bearer ${mindKey}` },\n});\n```\n\n### MCP sunucu yapılandırması\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_yourMindKeyHere\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n## Çoklu Mind Deseni\n\nHer kullanıcı birden çok mind'e sahip olabilir. Yaygın desenler:\n\n| Mind Adı | Amaç |\n|-----------|---------|\n| `work` | İşle ilgili bellekler |\n| `personal` | Kişisel tercihler, aile |\n| `project-synapse` | Belirli proje bağlamı |\n| `learning-german` | Öğrenme ilerlemesi |\n| `assistant-default` | Genel amaçlı yedek |\n\nBağlamları izole tutmak için farklı LLM oturumlarında farklı Mind Key'ler kullanın.\n\n## Hız Sınırları\n\n| Kimlik Doğrulama Yöntemi | Sınır | Kapsam |\n|-------------|-------|-------|\n| Mind Key (header) | Yok | Mind başına |\n| Mind Key (?key=) | 60/dakika | IP başına |\n| JWT (header) | Yok | Kullanıcı başına |\n| Herkese açık uç noktalar | Yok | Global |\n\nHız sınırı başlıkları (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`) uygun olduğunda yanıtlara dahil edilir.\n\n## Sonraki Adımlar\n\n- [Mind Key ve JWT](/docs/getting-started/mind-key-vs-jwt) — hangisi ne zaman kullanılır\n- [Memory API](/docs/api/memory) — bir Mind Key ile neler yapabilirsiniz\n- [User API](/docs/api/user) — JWT'lerle hesap yönetimi\n","content_html":"

Kimlik Doğrulama & Mind Key'ler

\n

Synapse, her biri farklı bir kullanım senaryosu için optimize edilmiş iki kimlik doğrulama yöntemi kullanır. Güvenilir entegrasyonlar oluşturmak için farkı anlamak esastır.

\n

İki Kimlik Doğrulama Yöntemi

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
YöntemKullanım SenaryosuHız SınırıSon Kullanma
Mind KeyLLM ajanları, otomatik araçlarYok (header) / 60 dk (sorgu)Asla
JWTİnsana yönelik arayüz, hesap işlemleriYok7 gün
\n

Mind Key (Ajanlar için)

\n

Mind Key, kiracı kapsamlı bir API token'ıdır. Tek bir mind'in verilerini (bellekler, görevler, sohbet, betikler vb.) doğrular. Şunlar için kullanın:

\n\n

Header kimlik doğrulaması (önerilir)

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

Sorgu parametresi (yalnızca URL kullanan araçlar için)

\n
curl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere
`?key=` sorgu parametresi **dakikada 60 istek** ile sınırlıdır. Bearer header'ın hız sınırı yoktur. İstemciniz özel başlıkları desteklediğinde header'ı kullanın.

Mind Key Oluşturma

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

Yanıt mind_key içerir — hemen kaydedin, yalnızca bir kez gösterilir.

\n

Mind'lerinizi listeleme

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

Bir mind'i silme (geri alınamaz!)

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

JWT (İnsanlar için)

\n

JWT'ler belirli bir mind'i değil, kullanıcı hesabını doğrular. Şunlar için kullanın:

\n\n

Kaydol

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

Döndürür: { "jwt": "eyJ...", "user": {...} }

\n

Giriş

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

Döndürür: { "jwt": "eyJ...", "user": {...} }

\n

JWT son kullanma

\n

JWT'ler 7 gün sonra sona erer. Bir JWT sona erdiğinde, yenisini almak için /login çağırın. Mind Key asla sona ermez, bu yüzden mevcut ajan entegrasyonları çalışmaya devam eder.

\n

Güvenlik En İyi Uygulamaları

\n

Ortam değişkeni deseni

\n
# .env (NEVER commit this file)\nSYNAPSE_MIND_KEY=mk_yourMindKeyHere\nSYNAPSE_URL=https://synapse.schaefer.zone
// Node.js\nconst mindKey = process.env.SYNAPSE_MIND_KEY;\nconst url = process.env.SYNAPSE_URL;\nawait fetch(`${url}/memory/recall`, {\n  headers: { Authorization: `Bearer ${mindKey}` },\n});

MCP sunucu yapılandırması

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

Çoklu Mind Deseni

\n

Her kullanıcı birden çok mind'e sahip olabilir. Yaygın desenler:

\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
Mind AdıAmaç
workİşle ilgili bellekler
personalKişisel tercihler, aile
project-synapseBelirli proje bağlamı
learning-germanÖğrenme ilerlemesi
assistant-defaultGenel amaçlı yedek
\n

Bağlamları izole tutmak için farklı LLM oturumlarında farklı Mind Key'ler kullanın.

\n

Hız Sınırları

\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
Kimlik Doğrulama YöntemiSınırKapsam
Mind Key (header)YokMind başına
Mind Key (?key=)60/dakikaIP başına
JWT (header)YokKullanıcı başına
Herkese açık uç noktalarYokGlobal
\n

Hız sınırı başlıkları (X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After) uygun olduğunda yanıtlara dahil edilir.

\n

Sonraki Adımlar

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