{"title":"FAQ MCP","slug":"mcp-faq","category":"faq","summary":"Pertanyaan umum tentang integrasi MCP — alat, transport, troubleshooting.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":439,"read_minutes":2,"lang":"id","translated":true,"requested_lang":"id","content_markdown":"\n# FAQ MCP\n\nPertanyaan umum tentang Synapse MCP server.\n\n## Apa itu MCP?\n\nMCP (Model Context Protocol) adalah standar terbuka oleh Anthropic untuk\nintegrasi LLM-alat. Alih-alih menempelkan dokumentasi API ke dalam prompt, Anda\nmendaftarkan alat dengan MCP server, dan LLM memanggilnya sebagai fungsi native.\n\nLihat [Apa itu MCP?](/docs/mcp/what-is-mcp).\n\n## Berapa banyak alat yang diekspos Synapse MCP?\n\n**79 alat** dalam 12 kategori: memori, chat, scheduler, tugas, skrip,\nkomputer, push, pengguna, utilitas, visualisasi, berbagi, webhooks, browser.\n\nLihat [Apa itu MCP?](/docs/mcp/what-is-mcp) untuk daftar lengkap.\n\n## Klien MCP mana yang didukung?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Klien apa pun yang kompatibel dengan MCP\n\nLihat [Pengaturan Claude Desktop](/docs/mcp/claude-desktop) untuk contoh konfigurasi.\n\n## Transport apa yang didukung?\n\n1. **stdio** (lokal, disarankan untuk desktop)\n2. **HTTP/SSE** (remote, multi-tenant)\n3. **WebSocket** (mobile, volume tinggi)\n\n## Bagaimana cara mengonfigurasi Claude Desktop?\n\nEdit `claude_desktop_config.json`:\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_KEY\",\n        \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n      }\n    }\n  }\n}\n```\n\nLihat [Pengaturan Claude Desktop](/docs/mcp/claude-desktop).\n\n## Mengapa alat tidak muncul di Claude Desktop?\n\n1. **Mulai ulang Claude Desktop sepenuhnya** (Cmd+Q di macOS)\n2. **Periksa file konfigurasi adalah JSON yang valid**\n3. **Verifikasi Node.js 18+** terpasang\n4. **Periksa log MCP**: `~/Library/Logs/Claude/mcp.log`\n\nLihat [MCP Troubleshooting](/docs/mcp/troubleshooting).\n\n## Bagaimana cara menggunakan mind yang berbeda?\n\nUbah `SYNAPSE_MIND_KEY` di konfigurasi MCP Anda dan mulai ulang klien.\n\nUntuk beberapa mind, jalankan beberapa instansi MCP server dengan Mind Key berbeda.\n\n## Bisakah saya membatasi alat mana yang diekspos?\n\nYa, gunakan **Tool Profiles**:\n\n- `minimal`: 8 alat komposit (~500 token)\n- `standard`: 25 alat (~2.500 token)\n- `full`: 119 alat (~8.250 token, default)\n\nAtur melalui env var `MCP_PROFILE` atau header `Mcp-Tool-Profile`.\n\n## Bagaimana cara men-debug masalah MCP?\n\n1. **Jalankan MCP server secara manual**: `npx -y synapse-mcp-api@latest`\n2. **Periksa log klien** (bervariasi per klien)\n3. **Verifikasi Mind Key berfungsi**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Periksa health Synapse**: `curl https://synapse.schaefer.zone/health`\n\nLihat [MCP Troubleshooting](/docs/mcp/troubleshooting).\n\n## Apakah MCP server gratis?\n\nYa. Paket npm `synapse-mcp-api` adalah open source. MCP server hosted\ndi `synapse-mcp.schaefer.zone` gratis untuk penggunaan publik.\n\n## Bisakah saya melakukan self-host MCP server?\n\nYa:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## Bagaimana MCP berbeda dari pemanggilan API langsung?\n\n| Aspek | API Langsung | MCP |\n|--------|-----------|-----|\n| LLM perlu tahu | URL, header, auth | Hanya nama alat |\n| Penanganan auth | Manual | Otomatis (env var) |\n| Penemuan alat | Baca /endpoints | Otomatis via protokol MCP |\n| Penanganan error | Manual | Terstandarisasi |\n| Terbaik untuk | Integrasi khusus | Agen LLM |\n\n## Bisakah saya membangun klien MCP saya sendiri?\n\nYa. Gunakan SDK MCP resmi:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nLihat [Klien MCP Khusus](/docs/mcp/custom-client).\n\n## Bagaimana cara melaporkan bug MCP?\n\nBuka issue: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>\n\nSertakan:\n\n- Versi MCP server\n- Nama dan versi klien\n- Sistem operasi\n- Log yang relevan\n- Langkah reproduksi\n\n## Langkah Berikutnya\n\n- [Apa itu MCP?](/docs/mcp/what-is-mcp)\n- [Pengaturan Claude Desktop](/docs/mcp/claude-desktop)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"<h1>FAQ MCP</h1>\n<p>Pertanyaan umum tentang Synapse MCP server.</p>\n<h2>Apa itu MCP?</h2>\n<p>MCP (Model Context Protocol) adalah standar terbuka oleh Anthropic untuk\nintegrasi LLM-alat. Alih-alih menempelkan dokumentasi API ke dalam prompt, Anda\nmendaftarkan alat dengan MCP server, dan LLM memanggilnya sebagai fungsi native.</p>\n<p>Lihat <a href=\"/docs/mcp/what-is-mcp\">Apa itu MCP?</a>.</p>\n<h2>Berapa banyak alat yang diekspos Synapse MCP?</h2>\n<p><strong>79 alat</strong> dalam 12 kategori: memori, chat, scheduler, tugas, skrip,\nkomputer, push, pengguna, utilitas, visualisasi, berbagi, webhooks, browser.</p>\n<p>Lihat <a href=\"/docs/mcp/what-is-mcp\">Apa itu MCP?</a> untuk daftar lengkap.</p>\n<h2>Klien MCP mana yang didukung?</h2>\n<ul>\n<li>Claude Desktop (macOS, Windows)</li>\n<li>Claude Code (terminal)</li>\n<li>Cursor (IDE)</li>\n<li>Continue.dev (VS Code, JetBrains)</li>\n<li>Cline (VS Code)</li>\n<li>Klien apa pun yang kompatibel dengan MCP</li>\n</ul>\n<p>Lihat <a href=\"/docs/mcp/claude-desktop\">Pengaturan Claude Desktop</a> untuk contoh konfigurasi.</p>\n<h2>Transport apa yang didukung?</h2>\n<ol>\n<li><strong>stdio</strong> (lokal, disarankan untuk desktop)</li>\n<li><strong>HTTP/SSE</strong> (remote, multi-tenant)</li>\n<li><strong>WebSocket</strong> (mobile, volume tinggi)</li>\n</ol>\n<h2>Bagaimana cara mengonfigurasi Claude Desktop?</h2>\n<p>Edit <code>claude_desktop_config.json</code>:</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_YOUR_KEY&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><p>Lihat <a href=\"/docs/mcp/claude-desktop\">Pengaturan Claude Desktop</a>.</p>\n<h2>Mengapa alat tidak muncul di Claude Desktop?</h2>\n<ol>\n<li><strong>Mulai ulang Claude Desktop sepenuhnya</strong> (Cmd+Q di macOS)</li>\n<li><strong>Periksa file konfigurasi adalah JSON yang valid</strong></li>\n<li><strong>Verifikasi Node.js 18+</strong> terpasang</li>\n<li><strong>Periksa log MCP</strong>: <code>~/Library/Logs/Claude/mcp.log</code></li>\n</ol>\n<p>Lihat <a href=\"/docs/mcp/troubleshooting\">MCP Troubleshooting</a>.</p>\n<h2>Bagaimana cara menggunakan mind yang berbeda?</h2>\n<p>Ubah <code>SYNAPSE_MIND_KEY</code> di konfigurasi MCP Anda dan mulai ulang klien.</p>\n<p>Untuk beberapa mind, jalankan beberapa instansi MCP server dengan Mind Key berbeda.</p>\n<h2>Bisakah saya membatasi alat mana yang diekspos?</h2>\n<p>Ya, gunakan <strong>Tool Profiles</strong>:</p>\n<ul>\n<li><code>minimal</code>: 8 alat komposit (~500 token)</li>\n<li><code>standard</code>: 25 alat (~2.500 token)</li>\n<li><code>full</code>: 119 alat (~8.250 token, default)</li>\n</ul>\n<p>Atur melalui env var <code>MCP_PROFILE</code> atau header <code>Mcp-Tool-Profile</code>.</p>\n<h2>Bagaimana cara men-debug masalah MCP?</h2>\n<ol>\n<li><strong>Jalankan MCP server secara manual</strong>: <code>npx -y synapse-mcp-api@latest</code></li>\n<li><strong>Periksa log klien</strong> (bervariasi per klien)</li>\n<li><strong>Verifikasi Mind Key berfungsi</strong>: <code>curl -H &quot;Authorization: Bearer mk_...&quot; .../memory/recall</code></li>\n<li><strong>Periksa health Synapse</strong>: <code>curl https://synapse.schaefer.zone/health</code></li>\n</ol>\n<p>Lihat <a href=\"/docs/mcp/troubleshooting\">MCP Troubleshooting</a>.</p>\n<h2>Apakah MCP server gratis?</h2>\n<p>Ya. Paket npm <code>synapse-mcp-api</code> adalah open source. MCP server hosted\ndi <code>synapse-mcp.schaefer.zone</code> gratis untuk penggunaan publik.</p>\n<h2>Bisakah saya melakukan self-host MCP server?</h2>\n<p>Ya:</p>\n<pre><code class=\"hljs language-bash\">npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api</code></pre><h2>Bagaimana MCP berbeda dari pemanggilan API langsung?</h2>\n<table>\n<thead>\n<tr>\n<th>Aspek</th>\n<th>API Langsung</th>\n<th>MCP</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>LLM perlu tahu</td>\n<td>URL, header, auth</td>\n<td>Hanya nama alat</td>\n</tr>\n<tr>\n<td>Penanganan auth</td>\n<td>Manual</td>\n<td>Otomatis (env var)</td>\n</tr>\n<tr>\n<td>Penemuan alat</td>\n<td>Baca /endpoints</td>\n<td>Otomatis via protokol MCP</td>\n</tr>\n<tr>\n<td>Penanganan error</td>\n<td>Manual</td>\n<td>Terstandarisasi</td>\n</tr>\n<tr>\n<td>Terbaik untuk</td>\n<td>Integrasi khusus</td>\n<td>Agen LLM</td>\n</tr>\n</tbody></table>\n<h2>Bisakah saya membangun klien MCP saya sendiri?</h2>\n<p>Ya. Gunakan SDK MCP resmi:</p>\n<ul>\n<li>TypeScript: <code>@modelcontextprotocol/sdk</code></li>\n<li>Python: <code>mcp</code></li>\n</ul>\n<p>Lihat <a href=\"/docs/mcp/custom-client\">Klien MCP Khusus</a>.</p>\n<h2>Bagaimana cara melaporkan bug MCP?</h2>\n<p>Buka issue: <a href=\"https://gitlab.com/schaefer-services/synapse-mcp/-/issues\">https://gitlab.com/schaefer-services/synapse-mcp/-/issues</a></p>\n<p>Sertakan:</p>\n<ul>\n<li>Versi MCP server</li>\n<li>Nama dan versi klien</li>\n<li>Sistem operasi</li>\n<li>Log yang relevan</li>\n<li>Langkah reproduksi</li>\n</ul>\n<h2>Langkah Berikutnya</h2>\n<ul>\n<li><a href=\"/docs/mcp/what-is-mcp\">Apa itu MCP?</a></li>\n<li><a href=\"/docs/mcp/claude-desktop\">Pengaturan Claude Desktop</a></li>\n<li><a href=\"/docs/mcp/troubleshooting\">MCP Troubleshooting</a></li>\n</ul>\n","urls":{"html":"/docs/faq/mcp-faq","text":"/docs/faq/mcp-faq?format=text","json":"/docs/faq/mcp-faq?format=json","llm":"/docs/faq/mcp-faq?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}