FAQ MCP

Pertanyaan umum tentang Synapse MCP server.

Apa itu MCP?

MCP (Model Context Protocol) adalah standar terbuka oleh Anthropic untuk integrasi LLM-alat. Alih-alih menempelkan dokumentasi API ke dalam prompt, Anda mendaftarkan alat dengan MCP server, dan LLM memanggilnya sebagai fungsi native.

Lihat Apa itu MCP?.

Berapa banyak alat yang diekspos Synapse MCP?

79 alat dalam 12 kategori: memori, chat, scheduler, tugas, skrip, komputer, push, pengguna, utilitas, visualisasi, berbagi, webhooks, browser.

Lihat Apa itu MCP? untuk daftar lengkap.

Klien MCP mana yang didukung?

• Claude Desktop (macOS, Windows)
• Claude Code (terminal)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Klien apa pun yang kompatibel dengan MCP

Lihat Pengaturan Claude Desktop untuk contoh konfigurasi.

Transport apa yang didukung?

1. stdio (lokal, disarankan untuk desktop)
2. HTTP/SSE (remote, multi-tenant)
3. WebSocket (mobile, volume tinggi)

Bagaimana cara mengonfigurasi Claude Desktop?

Edit claude_desktop_config.json:

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

Lihat Pengaturan Claude Desktop.

Mengapa alat tidak muncul di Claude Desktop?

1. Mulai ulang Claude Desktop sepenuhnya (Cmd+Q di macOS)
2. Periksa file konfigurasi adalah JSON yang valid
3. Verifikasi Node.js 18+ terpasang
4. Periksa log MCP: ~/Library/Logs/Claude/mcp.log

Lihat MCP Troubleshooting.

Bagaimana cara menggunakan mind yang berbeda?

Ubah SYNAPSE_MIND_KEY di konfigurasi MCP Anda dan mulai ulang klien.

Untuk beberapa mind, jalankan beberapa instansi MCP server dengan Mind Key berbeda.

Bisakah saya membatasi alat mana yang diekspos?

Ya, gunakan Tool Profiles:

• minimal: 8 alat komposit (~500 token)
• standard: 25 alat (~2.500 token)
• full: 119 alat (~8.250 token, default)

Atur melalui env var MCP_PROFILE atau header Mcp-Tool-Profile.

Bagaimana cara men-debug masalah MCP?

1. Jalankan MCP server secara manual: npx -y synapse-mcp-api@latest
2. Periksa log klien (bervariasi per klien)
3. Verifikasi Mind Key berfungsi: curl -H "Authorization: Bearer mk_..." .../memory/recall
4. Periksa health Synapse: curl https://synapse.schaefer.zone/health

Lihat MCP Troubleshooting.

Apakah MCP server gratis?

Ya. Paket npm synapse-mcp-api adalah open source. MCP server hosted di synapse-mcp.schaefer.zone gratis untuk penggunaan publik.

Bisakah saya melakukan self-host MCP server?

Ya:

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

Bagaimana MCP berbeda dari pemanggilan API langsung?

Aspek	API Langsung	MCP
LLM perlu tahu	URL, header, auth	Hanya nama alat
Penanganan auth	Manual	Otomatis (env var)
Penemuan alat	Baca /endpoints	Otomatis via protokol MCP
Penanganan error	Manual	Terstandarisasi
Terbaik untuk	Integrasi khusus	Agen LLM

Bisakah saya membangun klien MCP saya sendiri?

Ya. Gunakan SDK MCP resmi:

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

Lihat Klien MCP Khusus.

Bagaimana cara melaporkan bug MCP?

Buka issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

Sertakan:

• Versi MCP server
• Nama dan versi klien
• Sistem operasi
• Log yang relevan
• Langkah reproduksi

Langkah Berikutnya

• Apa itu MCP?
• Pengaturan Claude Desktop
• MCP Troubleshooting