Skip to main content

MCP ใน Claude Desktop

เชื่อมต่อ Synapse กับ Claude Desktop ใน 2 นาที Claude ได้ Synapse tool 79 ตัวแบบ native


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

{
  "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"
      }
    }
  }
}
หากคุณมี 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 คืออะไร?

การแก้ปัญหา

ไม่มี 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

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

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

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