# MCP คืออะไร?

**Model Context Protocol (MCP)** เป็นมาตรฐานเปิดโดย Anthropic (2024) ที่ช่วยให้ LLM เรียก external tool ในรูปแบบที่มีโครงสร้าง แทนที่จะวาง API docs ลงใน prompt คุณลงทะเบียน tool กับ MCP server และ LLM เรียกตามต้องการ — เหมือน function calling แต่เป็นมาตรฐานและไม่ขึ้นกับ client

## Synapse MCP Server

Synapse มี MCP server อย่างเป็นทางการ (`synapse-mcp-api` บน npm) ที่เปิดเผย **79 tool** ครอบคลุมฟีเจอร์ Synapse ทั้งหมด:

| Category | Tool | จำนวน |
|----------|-------|-------|
| Memory | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |
| Chat | poll, reply, status, history, unread, send, upload | 7 |
| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |
| Tasks | task_list, task_get, task_create, task_update | 4 |
| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |
| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |
| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |
| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |
| Utility | time, calc, random | 3 |
| Visualization | graph, tags, compact | 3 |
| Sharing | share, list, revoke | 3 |
| Webhooks | register, list, get, update, delete | 5 |
| Browser | new, navigate, click, type, screenshot, close | 6 |
| **รวม** | | **79+** |

## วิธีการทำงาน

```
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
```

1. คุณกำหนดค่า LLM client (Claude Desktop, Cursor ฯลฯ) ให้ใช้ Synapse MCP server
2. client เริ่ม MCP server (ผ่าน `npx -y synapse-mcp-api@latest`)
3. MCP server เชื่อมต่อกับ Synapse API โดยใช้ Mind Key ของคุณ
4. LLM เห็น tool ทั้ง 79 เป็น native function ที่เรียกได้
5. เมื่อ LLM ต้องการจดจำสิ่งใด มันเรียก `memory_store` — MCP server แปลสิ่งนี้เป็น `POST /memory` บน Synapse

## Transport

Synapse MCP server รองรับสาม transport:

### stdio (local, แนะนำสำหรับ desktop)

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

### HTTP/SSE (remote, multi-tenant)

เชื่อมต่อ MCP client ของคุณกับ:

```
URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEY
```

### WebSocket (mobile, ปริมาณสูง)

```
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY
```

## Tool Profile (v1.4.0)

เพื่อลด overhead token สำหรับ LLM ที่เล็กกว่า MCP server รองรับสาม tool profile:

| Profile | Tool | Token | เหมาะกับ |
|---------|-------|--------|----------|
| `minimal` | 8 (composite dispatch) | ~500 | Self-hosted LLM ที่มี context ≤8k |
| `standard` | 25 (named) | ~2,500 | Mid-size LLM (Claude Haiku, GPT-3.5) |
| `full` | 119 (all) | ~8,250 | Large LLM (Claude Sonnet/Opus, GPT-4) — ค่าเริ่มต้น |

ควบคุมผ่าน:

- Env var: `MCP_PROFILE=minimal|standard|full`
- Header: `Mcp-Tool-Profile: minimal|standard|full`

## Client ที่รองรับ

- [Claude Desktop](/docs/mcp/claude-desktop) — desktop app ของ Anthropic
- [Claude Code](/docs/mcp/claude-code) — terminal coding agent
- [Cursor](/docs/mcp/cursor) — IDE ที่ขับเคลื่อนด้วย AI
- [Continue.dev](/docs/mcp/continue) — AI coding assistant แบบ open-source
- [Cline](/docs/mcp/claude-code) — VS Code extension
- MCP client ใดก็ตามที่เข้ากันได้

## ทำไมใช้ MCP แทน Direct API?

| วิธี | ข้อดี | ข้อเสีย |
|----------|------|------|
| Direct API | ง่าย, ไม่มีชั้นเพิ่ม | LLM ต้องรู้ URL, header, auth |
| MCP | LLM เห็น native tool, ไม่ต้องจำ URL | มี MCP server process เพิ่ม |

สำหรับกรณีใช้งาน LLM agent ส่วนใหญ่ MCP เป็นตัวเลือกที่ดีกว่า — LLM ไม่ต้องจำ path API หรือรูปแบบ auth

## ขั้นตอนถัดไป

- [Claude Desktop Setup](/docs/mcp/claude-desktop) — config 2 นาที
- [Claude Code Setup](/docs/mcp/claude-code) — integration terminal
- [Custom MCP Client](/docs/mcp/custom-client) — สร้างของคุณเอง