# การแก้ปัญหา MCP
SUMMARY: แก้ปัญหา integration MCP ทั่วไป — server ไม่เริ่ม, tool ไม่ปรากฏ, error auth

KEY CONTEXT:
Common issues:
1. Node.js < 18 → upgrade to 18+
2. Mind Key invalid → check format (mk_...), get fresh via POST /minds
3. npx not found → install Node.js
4. Tools not appearing → restart client, check config JSON validity
5. SYNAPSE_URL unreachable → curl /health to verify
6. MCP server crashes → check logs, run npx manually to see error
Debug steps: run `npx -y synapse-mcp-api@latest` manually, check stderr
Logs: Claude Desktop ~/Library/Logs/Claude/mcp.log, Cursor ~/.cursor/logs/

การแก้ปัญหา MCP
ปัญหาและวิธีแก้ทั่วไปเมื่อผสานรวม Synapse MCP กับ LLM client ของคุณ
Checklist Diagnostic ด่วน
1. ✅ ติดตั้ง Node.js 18+? ()
2. ✅ Mind Key ขึ้นต้นด้วย ? (ไม่ใช่ JWT )
3. ✅ เข้าถึง Synapse API ได้? ()
4. ✅ Mind Key ทำงาน? ()
5. ✅ Config file เป็น JSON ที่ถูกต้อง? (ไม่มี trailing comma, ไม่มี comment)
6. ✅ รีสตาร์ท client หลังเปลี่ยน config?
7. ✅ MCP server เริ่มด้วยตนเอง? ()
ปัญหา: ไม่มี tool ปรากฏใน Client
อาการ
- Claude Desktop / Cursor / Continue แสดง 0 tool
- ไม่มีไอคอน 🔌 หรือรายการ "synapse" ในรายการ MCP server
วิธีแก้
1. รีสตาร์ท client ให้เต็มรูปแบบ — Cmd+Q บน macOS (ไม่ใช่แค่ปิดหน้าต่าง)
2. ตรวจตำแหน่ง config file:
   - Claude Desktop macOS: 
   - Claude Desktop Windows: 
   - Cursor: 
   - Continue: 
3. ตรวจ JSON ให้ถูกต้อง — วาง config ใน <https://jsonlint.com>
4. ตรวจ log client หา error MCP:
   - Claude Desktop:  (macOS)
   - Cursor: View → Output → MCP
5. รัน MCP server ด้วยตนเอง เพื่อดู startup error:
   [CODE BLOCK]
ปัญหา: Error "Mind Key invalid"
อาการ
- tool ปรากฏแต่การเรียกล้มเหลวด้วย "401 Unauthorized"
- Error: "Mind Key fehlt oder ungültig"
วิธีแก้
1. ตรวจรูปแบบ Mind Key — ขึ้นต้นด้วย , 40 ตัวอักษร
2. ทดสอบโดยตรง:
   [CODE BLOCK]
3. ตรวจ env var ตั้งแล้ว — สำหรับ transport stdio, env var ต้องอยู่ใน MCP server config, ไม่ใช่ shell ของคุณ
4. รับ Mind Key ใหม่:
   [CODE BLOCK]
ปัญหา: ไม่พบ npx
อาการ
- Error: "npx: command not found"
- MCP server ล้มเหลวตอนเริ่ม
วิธีแก้
1. ติดตั้ง Node.js 18+:
   - macOS:  หรือดาวน์โหลดจาก <https://nodejs.org>
   - Linux: 
   - Windows: ดาวน์โหลดจาก <https://nodejs.org>
2. รีสตาร์ท terminal หลังติดตั้ง
3. ตรวจสอบ: 
ปัญหา: SYNAPSEURL เข้าถึงไม่ได้
อาการ
- MCP server เริ่มแต่การเรียก tool หมดเวลา
- Error: "fetch failed" หรือ "ECONNREFUSED"
วิธีแก้
1. ทดสอบการเชื่อมต่อ:
   [CODE BLOCK]
2. ตรวจ corporate firewall — อาจบล็อก HTTPS ขาออก
3. ลอง URL ทางเลือก:
   - Production: 
   - MCP server: 
4. สำหรับ self-hosted: ตรวจว่า instance Synapse ของคุณรันและเข้าถึงได้
ปัญหา: MCP Server Crash
อาการ
- MCP server ออกทันทีหลังเริ่ม
- Log client แสดง "MCP server disconnected"
วิธีแก้
1. รันด้วยตนเองเพื่อดู error:
   [CODE BLOCK]
2. ตรวจ conflict port — MCP server ใช้ port 13100 โดยค่าเริ่มต้น
3. ล้าง npx cache:
   [CODE BLOCK]
4. อัปเดตเป็นเวอร์ชันล่าสุด:
   [CODE BLOCK]
ปัญหา: การเรียก Tool ส่งกลับ 429
อาการ
- Error: "Rate limit exceeded"
วิธีแก้
สิ่งนี้ไม่ควรเกิดกับ MCP (ใช้ header auth, ไม่จำกัดอัตรา) หากเกิด:
1. ตรวจว่าคุณใช้  ที่ไหน — เปลี่ยนเป็น header auth
2. ตรวจ  — ตรวจให้แน่ใจว่าชี้ไปยัง instance ที่ถูกต้อง
3. ติดต่อ support หากปัญหายังคงอยู่
ปัญหา: Tool ปรากฏแต่ไม่ทำงาน
อาการ
- tool อยู่ในรายการ client
- การเรียก tool ส่งกลับ error หรือไม่มีผลลัพธ์
วิธีแก้
1. ตรวจชื่อ tool — ต้องตรง (เช่น , ไม่ใช่ )
2. ตรวจ arguments — ตรวจ input schema ของ tool
3. ทดสอบผ่าน API โดยตรง:
   [CODE BLOCK]
4. ตรวจสุขภาพ Synapse:
   [CODE BLOCK]
การขอความช่วยเหลือ
หากไม่มีวิธีข้างต้นแก้ปัญหาของคุณ:
1. ตรวจ issue ที่มี: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>
2. เปิด issue ใหม่ พร้อม:
   - เวอร์ชัน MCP server ()
   - ชื่อและเวอร์ชัน client
   - ระบบปฏิบัติการ
   - ส่วนที่เกี่ยวข้องของ log
   - ขั้นตอนการ reproduce
ขั้นตอนถัดไป
- Claude Desktop Setup
- Claude Code Setup
- API Errors