# 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

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> Jika Anda sudah memiliki MCP server lain yang dikonfigurasi, cukup tambahkan
> blok `"synapse"` di dalam objek `"mcpServers"` yang ada.

## 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)

| Alat | Deskripsi |
|------|-------------|
| `memory_recall` | Recall semua memori |
| `memory_store` | Simpan memori baru |
| `memory_search` | Cari memori |
| `task_list` | Daftar tugas |
| `task_create` | Buat tugas |
| `chat_poll` | Periksa pesan baru |
| `chat_reply` | Balas pesan |
| `browser_new` | Buka tab browser |
| `computer_list` | Daftar komputer terdaftar |

Daftar lengkap: [Apa itu MCP?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

## Tool Profiles (Hemat Token)

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

```json
{
  "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](/docs/mcp/claude-code)
- [Pengaturan Cursor](/docs/mcp/cursor)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)