{"title":"Quick Start (Mensch)","slug":"quick-start","category":"getting-started","summary":"Konto registrieren, ersten Mind anlegen, ersten Memory speichern — alles in 5 Minuten.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":351,"read_minutes":2,"lang":"de","translated":true,"requested_lang":"de","content_markdown":"\n# Quick Start (Mensch)\n\nDieser Guide führt dich durch das Anlegen eines Synapse-Kontos, deinen ersten\nMind Key und das Speichern deines ersten Memories. Gesamtdauer: ~5 Minuten.\n\n## Schritt 1: Konto registrieren\n\nÖffne die Synapse-API und lege ein Konto an:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"email\": \"you@example.com\",\n    \"password\": \"your-secure-password\"\n  }'\n```\n\nAntwort:\n\n```json\n{\n  \"jwt\": \"eyJhbGci...\",\n  \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> Speichere das JWT an einem sicheren Ort — du brauchst es, um Minds anzulegen.\n> Das JWT läuft nach 7 Tagen ab; mit demselben Endpunkt erneut einloggen, um es\n> zu erneuern.\n\n## Schritt 2: Lege deinen ersten Mind an\n\nEin „Mind\" ist ein isolierter Memory-Scope. Die meisten Nutzer starten mit einem\nMind, aber du kannst mehrere haben (z. B. „work\", „personal\", „project-x\"). Jeder\nMind hat seinen eigenen, eindeutigen Mind Key.\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 '{\n    \"name\": \"My First Mind\",\n    \"description\": \"Personal assistant memory\"\n  }'\n```\n\nAntwort:\n\n```json\n{\n  \"id\": \"m_xyz789\",\n  \"name\": \"My First Mind\",\n  \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n  \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **Speichere den `mind_key` sofort.** Er wird nur einmal angezeigt und kann\n> später nicht wiederhergestellt werden. Wenn du ihn verlierst, musst du einen\n> neuen Mind anlegen.\n\n## Schritt 3: Speichere deinen ersten Memory\n\nVerwende nun den Mind Key, um einen Memory zu speichern:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n  -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"category\": \"identity\",\n    \"key\": \"user_name\",\n    \"content\": \"My name is Michael\",\n    \"tags\": [\"personal\", \"identity\"],\n    \"priority\": \"critical\"\n  }'\n```\n\nAntwort:\n\n```json\n{\n  \"id\": \"mem_001\",\n  \"status\": \"stored\",\n  \"mind_id\": \"m_xyz789\"\n}\n```\n\n## Schritt 4: Alle Memories abrufen\n\nUm alles abzurufen, was du gespeichert hast:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/memory/recall\n```\n\nAntwort (Klartext, optimiert für LLM-Konsum):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27\n```\n\n## Schritt 5: Memories durchsuchen\n\nSpezifische Memories per Keyword finden:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## Schritt 6: Verbinde dein LLM\n\nDer einfachste Weg, deinem LLM Zugriff auf Synapse zu geben, ist via MCP:\n\n- [Claude-Desktop-Setup](/docs/mcp/claude-desktop) — 2-Minuten-Config\n- [Claude-Code-Setup](/docs/mcp/claude-code) — Terminal-Integration\n- [Cursor-Setup](/docs/mcp/cursor) — IDE-Integration\n\nNach dem Setup wird dein LLM automatisch `memory_recall` zu Beginn jeder Session\naufrufen und neue Fakten via `memory_store` persistieren.\n\n## Memory-Kategorien\n\nSynapse unterstützt 8 Kategorien — wähle die spezifischste:\n\n| Kategorie | Anwendungsfall |\n|-----------|----------------|\n| `identity` | Nutzername, Rolle, Kontaktinfo |\n| `preference` | Vorlieben, Abneigungen, Arbeitsstil |\n| `fact` | Überprüfbare Fakten (Projekt-Details, Daten) |\n| `project` | Projektstatus, Meilensteine, Todos |\n| `skill` | Dinge, die der Nutzer gut kann |\n| `mistake` | Frühere Fehler — nicht wiederholen |\n| `context` | Session-relevanter Kontext |\n| `note` | Sonstige Notizen |\n\n## Prioritätsstufen\n\n- `low` — nett zu wissen\n- `normal` — Standard\n- `high` — wichtig\n- `critical` — darf nie vergessen werden (Nutzeridentität, rechtliche Infos)\n\n## Nächste Schritte\n\n- [Authentifizierung Deep-Dive](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Memory-API-Referenz](/docs/api/memory)\n- [MCP-Integration](/docs/mcp/what-is-mcp)\n","content_html":"<h1>Quick Start (Mensch)</h1>\n<p>Dieser Guide führt dich durch das Anlegen eines Synapse-Kontos, deinen ersten\nMind Key und das Speichern deines ersten Memories. Gesamtdauer: ~5 Minuten.</p>\n<h2>Schritt 1: Konto registrieren</h2>\n<p>Öffne die Synapse-API und lege ein Konto an:</p>\n<pre><code class=\"hljs language-bash\">curl -X POST https://synapse.schaefer.zone/register \\\n  -H <span class=\"hljs-string\">&quot;Content-Type: application/json&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{\n    &quot;email&quot;: &quot;you@example.com&quot;,\n    &quot;password&quot;: &quot;your-secure-password&quot;\n  }&#x27;</span></code></pre><p>Antwort:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;jwt&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;eyJhbGci...&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;user&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span> <span class=\"hljs-attr\">&quot;id&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;u_abc123&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-attr\">&quot;email&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;you@example.com&quot;</span> <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><div class=\"callout callout-ok\">Speichere das JWT an einem sicheren Ort — du brauchst es, um Minds anzulegen.\nDas JWT läuft nach 7 Tagen ab; mit demselben Endpunkt erneut einloggen, um es\nzu erneuern.</div><h2>Schritt 2: Lege deinen ersten Mind an</h2>\n<p>Ein „Mind&quot; ist ein isolierter Memory-Scope. Die meisten Nutzer starten mit einem\nMind, aber du kannst mehrere haben (z. B. „work&quot;, „personal&quot;, „project-x&quot;). Jeder\nMind hat seinen eigenen, eindeutigen Mind Key.</p>\n<pre><code class=\"hljs language-bash\">curl -X POST https://synapse.schaefer.zone/minds \\\n  -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_JWT&quot;</span> \\\n  -H <span class=\"hljs-string\">&quot;Content-Type: application/json&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{\n    &quot;name&quot;: &quot;My First Mind&quot;,\n    &quot;description&quot;: &quot;Personal assistant memory&quot;\n  }&#x27;</span></code></pre><p>Antwort:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;id&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;m_xyz789&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;name&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;My First Mind&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;mind_key&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;created_at&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;2026-06-27T...&quot;</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><div class=\"callout callout-critical\">**Speichere den `mind_key` sofort.** Er wird nur einmal angezeigt und kann\nspäter nicht wiederhergestellt werden. Wenn du ihn verlierst, musst du einen\nneuen Mind anlegen.</div><h2>Schritt 3: Speichere deinen ersten Memory</h2>\n<p>Verwende nun den Mind Key, um einen Memory zu speichern:</p>\n<pre><code class=\"hljs language-bash\">curl -X POST https://synapse.schaefer.zone/memory \\\n  -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n  -H <span class=\"hljs-string\">&quot;Content-Type: application/json&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{\n    &quot;category&quot;: &quot;identity&quot;,\n    &quot;key&quot;: &quot;user_name&quot;,\n    &quot;content&quot;: &quot;My name is Michael&quot;,\n    &quot;tags&quot;: [&quot;personal&quot;, &quot;identity&quot;],\n    &quot;priority&quot;: &quot;critical&quot;\n  }&#x27;</span></code></pre><p>Antwort:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;id&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mem_001&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;status&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;stored&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;mind_id&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;m_xyz789&quot;</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h2>Schritt 4: Alle Memories abrufen</h2>\n<p>Um alles abzurufen, was du gespeichert hast:</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/memory/recall</code></pre><p>Antwort (Klartext, optimiert für LLM-Konsum):</p>\n<pre><code class=\"hljs language-plaintext\">Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27</code></pre><h2>Schritt 5: Memories durchsuchen</h2>\n<p>Spezifische Memories per Keyword finden:</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone/memory/search?q=michael&quot;</span></code></pre><h2>Schritt 6: Verbinde dein LLM</h2>\n<p>Der einfachste Weg, deinem LLM Zugriff auf Synapse zu geben, ist via MCP:</p>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Claude-Desktop-Setup</a> — 2-Minuten-Config</li>\n<li><a href=\"/docs/mcp/claude-code\">Claude-Code-Setup</a> — Terminal-Integration</li>\n<li><a href=\"/docs/mcp/cursor\">Cursor-Setup</a> — IDE-Integration</li>\n</ul>\n<p>Nach dem Setup wird dein LLM automatisch <code>memory_recall</code> zu Beginn jeder Session\naufrufen und neue Fakten via <code>memory_store</code> persistieren.</p>\n<h2>Memory-Kategorien</h2>\n<p>Synapse unterstützt 8 Kategorien — wähle die spezifischste:</p>\n<table>\n<thead>\n<tr>\n<th>Kategorie</th>\n<th>Anwendungsfall</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>identity</code></td>\n<td>Nutzername, Rolle, Kontaktinfo</td>\n</tr>\n<tr>\n<td><code>preference</code></td>\n<td>Vorlieben, Abneigungen, Arbeitsstil</td>\n</tr>\n<tr>\n<td><code>fact</code></td>\n<td>Überprüfbare Fakten (Projekt-Details, Daten)</td>\n</tr>\n<tr>\n<td><code>project</code></td>\n<td>Projektstatus, Meilensteine, Todos</td>\n</tr>\n<tr>\n<td><code>skill</code></td>\n<td>Dinge, die der Nutzer gut kann</td>\n</tr>\n<tr>\n<td><code>mistake</code></td>\n<td>Frühere Fehler — nicht wiederholen</td>\n</tr>\n<tr>\n<td><code>context</code></td>\n<td>Session-relevanter Kontext</td>\n</tr>\n<tr>\n<td><code>note</code></td>\n<td>Sonstige Notizen</td>\n</tr>\n</tbody></table>\n<h2>Prioritätsstufen</h2>\n<ul>\n<li><code>low</code> — nett zu wissen</li>\n<li><code>normal</code> — Standard</li>\n<li><code>high</code> — wichtig</li>\n<li><code>critical</code> — darf nie vergessen werden (Nutzeridentität, rechtliche Infos)</li>\n</ul>\n<h2>Nächste Schritte</h2>\n<ul>\n<li><a href=\"/docs/getting-started/authentication\">Authentifizierung Deep-Dive</a></li>\n<li><a href=\"/docs/getting-started/mind-key-vs-jwt\">Mind Key vs JWT</a></li>\n<li><a href=\"/docs/api/memory\">Memory-API-Referenz</a></li>\n<li><a href=\"/docs/mcp/what-is-mcp\">MCP-Integration</a></li>\n</ul>\n","urls":{"html":"/docs/getting-started/quick-start","text":"/docs/getting-started/quick-start?format=text","json":"/docs/getting-started/quick-start?format=json","llm":"/docs/getting-started/quick-start?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}