MCP di Claude Desktop

Claude Desktop adalah aplikasi desktop Anthropic untuk macOS dan Windows. Dengan Synapse MCP server dikonfigurasi, Claude mendapatkan akses native ke semua 79 alat Synapse — ia dapat menyimpan memori, recall, mengelola tugas, chat dengan Anda, dan lebih banyak.

Prasyarat

• Aplikasi Claude Desktop (macOS atau Windows)
• Node.js 18+ terpasang (node --version)
• Mind Key Synapse Anda

Langkah 1: Buka File Konfigurasi

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Jika file tidak ada, buatlah.

Langkah 2: Tambahkan Synapse MCP Server

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

Langkah 3: Mulai Ulang Claude Desktop

1. Keluar sepenuhnya dari Claude Desktop (Cmd+Q di macOS, bukan hanya tutup jendela)
2. Buka kembali Claude Desktop
3. Mulai chat baru
4. Cari ikon plug 🔌 di kiri bawah — harus tertulis "79 tools"

Langkah 4: Tes

Di chat baru, ketik:

memory_recall aufrufen

Claude harus memanggil alat memory_recall dan merespons dengan ringkasan memori tersimpan Anda (atau "No memories yet" jika mind Anda kosong).

Alat yang Tersedia (Pilihan)

Daftar lengkap: Apa itu MCP?

Troubleshooting

Tidak ada alat yang muncul di Claude Desktop

1. Verifikasi versi Node.js: node --version (harus ≥ 18)
2. Periksa file konfigurasi adalah JSON yang valid (tanpa koma berlebih)
3. Mulai ulang Claude Desktop sepenuhnya (Cmd+Q, bukan hanya tutup)
4. Periksa log Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)

Error "Mind Key invalid"

• Verifikasi SYNAPSE_MIND_KEY dimulai dengan mk_
• Dapatkan key baru via POST /minds (memerlukan JWT dari /login)
• Tidak ada tanda kutip di sekitar key dalam JSON

npx tidak ditemukan

• Pasang Node.js 18+: https://nodejs.org/
• Mulai ulang terminal setelah pasang
• Di macOS dengan Homebrew: brew install node

Alat muncul tetapi panggilan gagal

• Periksa SYNAPSE_URL dapat dijangkau: curl https://synapse.schaefer.zone/health
• Verifikasi Mind Key Anda berfungsi: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Lihat MCP Troubleshooting

Tool Profiles (Hemat Token)

Jika Anda menggunakan LLM yang lebih kecil atau ingin menghemat token konteks, tetapkan tool profile:

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

Profile: minimal (8 alat), standard (25), full (119, default).

Langkah Berikutnya

• Pengaturan Claude Code
• Pengaturan Cursor
• MCP Troubleshooting