{"title":"MCP di Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Hubungkan Synapse ke Claude Desktop dalam 2 menit. Claude mendapat 79 alat Synapse secara native.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":384,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n             %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"id","translated":true,"requested_lang":"id","content_markdown":"\n# MCP di Claude Desktop\n\nClaude Desktop adalah aplikasi desktop Anthropic untuk macOS dan Windows.\nDengan Synapse MCP server dikonfigurasi, Claude mendapatkan akses native ke\nsemua 79 alat Synapse — ia dapat menyimpan memori, recall, mengelola tugas,\nchat dengan Anda, dan lebih banyak.\n\n## Prasyarat\n\n- Aplikasi Claude Desktop (macOS atau Windows)\n- Node.js 18+ terpasang (`node --version`)\n- Mind Key Synapse Anda\n\n## Langkah 1: Buka File Konfigurasi\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nJika file tidak ada, buatlah.\n\n## Langkah 2: Tambahkan Synapse MCP Server\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_YOUR_MIND_KEY_HERE\",\n        \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n      }\n    }\n  }\n}\n```\n\n> [!TIP]\n> Jika Anda sudah memiliki MCP server lain yang dikonfigurasi, cukup tambahkan\n> blok `\"synapse\"` di dalam objek `\"mcpServers\"` yang ada.\n\n## Langkah 3: Mulai Ulang Claude Desktop\n\n1. Keluar sepenuhnya dari Claude Desktop (Cmd+Q di macOS, bukan hanya tutup jendela)\n2. Buka kembali Claude Desktop\n3. Mulai chat baru\n4. Cari ikon plug 🔌 di kiri bawah — harus tertulis \"79 tools\"\n\n## Langkah 4: Tes\n\nDi chat baru, ketik:\n\n```\nmemory_recall aufrufen\n```\n\nClaude harus memanggil alat `memory_recall` dan merespons dengan ringkasan\nmemori tersimpan Anda (atau \"No memories yet\" jika mind Anda kosong).\n\n## Alat yang Tersedia (Pilihan)\n\n| Alat | Deskripsi |\n|------|-------------|\n| `memory_recall` | Recall semua memori |\n| `memory_store` | Simpan memori baru |\n| `memory_search` | Cari memori |\n| `task_list` | Daftar tugas |\n| `task_create` | Buat tugas |\n| `chat_poll` | Periksa pesan baru |\n| `chat_reply` | Balas pesan |\n| `browser_new` | Buka tab browser |\n| `computer_list` | Daftar komputer terdaftar |\n\nDaftar lengkap: [Apa itu MCP?](/docs/mcp/what-is-mcp)\n\n## Troubleshooting\n\n### Tidak ada alat yang muncul di Claude Desktop\n\n1. Verifikasi versi Node.js: `node --version` (harus ≥ 18)\n2. Periksa file konfigurasi adalah JSON yang valid (tanpa koma berlebih)\n3. Mulai ulang Claude Desktop sepenuhnya (Cmd+Q, bukan hanya tutup)\n4. Periksa log Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### Error \"Mind Key invalid\"\n\n- Verifikasi `SYNAPSE_MIND_KEY` dimulai dengan `mk_`\n- Dapatkan key baru via `POST /minds` (memerlukan JWT dari `/login`)\n- Tidak ada tanda kutip di sekitar key dalam JSON\n\n### npx tidak ditemukan\n\n- Pasang Node.js 18+: <https://nodejs.org/>\n- Mulai ulang terminal setelah pasang\n- Di macOS dengan Homebrew: `brew install node`\n\n### Alat muncul tetapi panggilan gagal\n\n- Periksa `SYNAPSE_URL` dapat dijangkau: `curl https://synapse.schaefer.zone/health`\n- Verifikasi Mind Key Anda berfungsi: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Lihat [MCP Troubleshooting](/docs/mcp/troubleshooting)\n\n## Tool Profiles (Hemat Token)\n\nJika Anda menggunakan LLM yang lebih kecil atau ingin menghemat token konteks, tetapkan tool profile:\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_...\",\n        \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n        \"MCP_PROFILE\": \"standard\"\n      }\n    }\n  }\n}\n```\n\nProfile: `minimal` (8 alat), `standard` (25), `full` (119, default).\n\n## Langkah Berikutnya\n\n- [Pengaturan Claude Code](/docs/mcp/claude-code)\n- [Pengaturan Cursor](/docs/mcp/cursor)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"<h1>MCP di Claude Desktop</h1>\n<p>Claude Desktop adalah aplikasi desktop Anthropic untuk macOS dan Windows.\nDengan Synapse MCP server dikonfigurasi, Claude mendapatkan akses native ke\nsemua 79 alat Synapse — ia dapat menyimpan memori, recall, mengelola tugas,\nchat dengan Anda, dan lebih banyak.</p>\n<h2>Prasyarat</h2>\n<ul>\n<li>Aplikasi Claude Desktop (macOS atau Windows)</li>\n<li>Node.js 18+ terpasang (<code>node --version</code>)</li>\n<li>Mind Key Synapse Anda</li>\n</ul>\n<h2>Langkah 1: Buka File Konfigurasi</h2>\n<ul>\n<li><strong>macOS:</strong> <code>~/Library/Application Support/Claude/claude_desktop_config.json</code></li>\n<li><strong>Windows:</strong> <code>%APPDATA%\\Claude\\claude_desktop_config.json</code></li>\n</ul>\n<p>Jika file tidak ada, buatlah.</p>\n<h2>Langkah 2: Tambahkan Synapse MCP Server</h2>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_YOUR_MIND_KEY_HERE&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><div class=\"callout callout-ok\">Jika Anda sudah memiliki MCP server lain yang dikonfigurasi, cukup tambahkan\nblok `\"synapse\"` di dalam objek `\"mcpServers\"` yang ada.</div><h2>Langkah 3: Mulai Ulang Claude Desktop</h2>\n<ol>\n<li>Keluar sepenuhnya dari Claude Desktop (Cmd+Q di macOS, bukan hanya tutup jendela)</li>\n<li>Buka kembali Claude Desktop</li>\n<li>Mulai chat baru</li>\n<li>Cari ikon plug 🔌 di kiri bawah — harus tertulis &quot;79 tools&quot;</li>\n</ol>\n<h2>Langkah 4: Tes</h2>\n<p>Di chat baru, ketik:</p>\n<pre><code class=\"hljs language-plaintext\">memory_recall aufrufen</code></pre><p>Claude harus memanggil alat <code>memory_recall</code> dan merespons dengan ringkasan\nmemori tersimpan Anda (atau &quot;No memories yet&quot; jika mind Anda kosong).</p>\n<h2>Alat yang Tersedia (Pilihan)</h2>\n<table>\n<thead>\n<tr>\n<th>Alat</th>\n<th>Deskripsi</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>memory_recall</code></td>\n<td>Recall semua memori</td>\n</tr>\n<tr>\n<td><code>memory_store</code></td>\n<td>Simpan memori baru</td>\n</tr>\n<tr>\n<td><code>memory_search</code></td>\n<td>Cari memori</td>\n</tr>\n<tr>\n<td><code>task_list</code></td>\n<td>Daftar tugas</td>\n</tr>\n<tr>\n<td><code>task_create</code></td>\n<td>Buat tugas</td>\n</tr>\n<tr>\n<td><code>chat_poll</code></td>\n<td>Periksa pesan baru</td>\n</tr>\n<tr>\n<td><code>chat_reply</code></td>\n<td>Balas pesan</td>\n</tr>\n<tr>\n<td><code>browser_new</code></td>\n<td>Buka tab browser</td>\n</tr>\n<tr>\n<td><code>computer_list</code></td>\n<td>Daftar komputer terdaftar</td>\n</tr>\n</tbody></table>\n<p>Daftar lengkap: <a href=\"/docs/mcp/what-is-mcp\">Apa itu MCP?</a></p>\n<h2>Troubleshooting</h2>\n<h3>Tidak ada alat yang muncul di Claude Desktop</h3>\n<ol>\n<li>Verifikasi versi Node.js: <code>node --version</code> (harus ≥ 18)</li>\n<li>Periksa file konfigurasi adalah JSON yang valid (tanpa koma berlebih)</li>\n<li>Mulai ulang Claude Desktop sepenuhnya (Cmd+Q, bukan hanya tutup)</li>\n<li>Periksa log Claude Desktop: <code>~/Library/Logs/Claude/mcp.log</code> (macOS)</li>\n</ol>\n<h3>Error &quot;Mind Key invalid&quot;</h3>\n<ul>\n<li>Verifikasi <code>SYNAPSE_MIND_KEY</code> dimulai dengan <code>mk_</code></li>\n<li>Dapatkan key baru via <code>POST /minds</code> (memerlukan JWT dari <code>/login</code>)</li>\n<li>Tidak ada tanda kutip di sekitar key dalam JSON</li>\n</ul>\n<h3>npx tidak ditemukan</h3>\n<ul>\n<li>Pasang Node.js 18+: <a href=\"https://nodejs.org/\">https://nodejs.org/</a></li>\n<li>Mulai ulang terminal setelah pasang</li>\n<li>Di macOS dengan Homebrew: <code>brew install node</code></li>\n</ul>\n<h3>Alat muncul tetapi panggilan gagal</h3>\n<ul>\n<li>Periksa <code>SYNAPSE_URL</code> dapat dijangkau: <code>curl https://synapse.schaefer.zone/health</code></li>\n<li>Verifikasi Mind Key Anda berfungsi: <code>curl -H &quot;Authorization: Bearer mk_...&quot; https://synapse.schaefer.zone/memory/recall</code></li>\n<li>Lihat <a href=\"/docs/mcp/troubleshooting\">MCP Troubleshooting</a></li>\n</ul>\n<h2>Tool Profiles (Hemat Token)</h2>\n<p>Jika Anda menggunakan LLM yang lebih kecil atau ingin menghemat token konteks, tetapkan tool profile:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_...&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;MCP_PROFILE&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;standard&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><p>Profile: <code>minimal</code> (8 alat), <code>standard</code> (25), <code>full</code> (119, default).</p>\n<h2>Langkah Berikutnya</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-code\">Pengaturan Claude Code</a></li>\n<li><a href=\"/docs/mcp/cursor\">Pengaturan Cursor</a></li>\n<li><a href=\"/docs/mcp/troubleshooting\">MCP Troubleshooting</a></li>\n</ul>\n","urls":{"html":"/docs/mcp/claude-desktop","text":"/docs/mcp/claude-desktop?format=text","json":"/docs/mcp/claude-desktop?format=json","llm":"/docs/mcp/claude-desktop?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}