# MCP ใน Claude Desktop

Claude Desktop เป็น desktop app ของ Anthropic สำหรับ macOS และ Windows ด้วย Synapse MCP server ที่กำหนดค่า Claude ได้สิทธิ์ native เข้าถึง Synapse tool ทั้ง 79 ตัว — สามารถเก็บ memory, recall, จัดการ task, แช็ตกับคุณ และอื่น ๆ

## ข้อกำหนดเบื้องต้น

- Claude Desktop app (macOS หรือ Windows)
- Node.js 18+ ติดตั้ง (`node --version`)
- Synapse Mind Key ของคุณ

## ขั้นตอนที่ 1: เปิด Config File

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

หากไฟล์ไม่มี ให้สร้างขึ้นมา

## ขั้นตอนที่ 2: เพิ่ม 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]
> หากคุณมี MCP server อื่นที่กำหนดค่าแล้ว เพียงเพิ่ม block `"synapse"` ใน object `"mcpServers"` ที่มีอยู่

## ขั้นตอนที่ 3: รีสตาร์ท Claude Desktop

1. ออกจาก Claude Desktop ให้เต็มรูปแบบ (Cmd+Q บน macOS, ไม่ใช่แค่ปิดหน้าต่าง)
2. เปิด Claude Desktop อีกครั้ง
3. เริ่มแช็ตใหม่
4. มองหาไอคอน 🔌 plug ที่มุมล่างซ้าย — ควรบอกว่า "79 tools"

## ขั้นตอนที่ 4: ทดสอบ

ในแช็ตใหม่ พิมพ์:

```
memory_recall aufrufen
```

Claude ควรเรียก tool `memory_recall` และตอบกลับด้วยสรุปของ memory ที่เก็บไว้ของคุณ (หรือ "No memories yet" หาก mind ของคุณว่าง)

## Tool ที่ใช้ได้ (ส่วนหนึ่ง)

| Tool | คำอธิบาย |
|------|-------------|
| `memory_recall` | Recall memory ทั้งหมด |
| `memory_store` | เก็บ memory ใหม่ |
| `memory_search` | ค้นหา memory |
| `task_list` | รายการ task |
| `task_create` | สร้าง task |
| `chat_poll` | ตรวจข้อความใหม่ |
| `chat_reply` | ตอบกลับข้อความ |
| `browser_new` | เปิด browser tab |
| `computer_list` | รายการ computer ที่ลงทะเบียน |

รายการเต็ม: [MCP คืออะไร?](/docs/mcp/what-is-mcp)

## การแก้ปัญหา

### ไม่มี tool ปรากฏใน Claude Desktop

1. ตรวจสอบเวอร์ชัน Node.js: `node --version` (ต้อง ≥ 18)
2. ตรวจสอบ config file เป็น JSON ที่ถูกต้อง (ไม่มี trailing comma)
3. รีสตาร์ท Claude Desktop ให้เต็มรูปแบบ (Cmd+Q, ไม่ใช่แค่ปิด)
4. ตรวจ log Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)

### Error "Mind Key invalid"

- ตรวจ `SYNAPSE_MIND_KEY` ขึ้นต้นด้วย `mk_`
- รับ key ใหม่ผ่าน `POST /minds` (ต้องใช้ JWT จาก `/login`)
- ไม่มีเครื่องหมายคำพูดรอบ key ใน JSON

### ไม่พบ npx

- ติดตั้ง Node.js 18+: <https://nodejs.org/>
- รีสตาร์ท terminal หลังติดตั้ง
- บน macOS ด้วย Homebrew: `brew install node`

### tool แสดงแต่การเรียกล้มเหลว

- ตรวจ `SYNAPSE_URL` เข้าถึงได้: `curl https://synapse.schaefer.zone/health`
- ตรวจ Mind Key ทำงาน: `curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall`
- ดู [MCP Troubleshooting](/docs/mcp/troubleshooting)

## Tool Profile (ประหยัด Token)

หากคุณใช้ LLM ที่เล็กกว่าหรือต้องการประหยัด context token ตั้ง 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 tool), `standard` (25), `full` (119, ค่าเริ่มต้น)

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

- [Claude Code Setup](/docs/mcp/claude-code)
- [Cursor Setup](/docs/mcp/cursor)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)