# 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?](/docs/mcp/what-is-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?](/docs/mcp/what-is-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](/docs/mcp/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`:

```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](/docs/mcp/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](/docs/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](/docs/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:

```bash
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](/docs/mcp/custom-client).

## 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?](/docs/mcp/what-is-mcp)
- [Pengaturan Claude Desktop](/docs/mcp/claude-desktop)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)