# คำถามที่พบบ่อยเกี่ยวกับการแก้ปัญหา
SUMMARY: วิธีแก้ปัญหา Synapse ทั่วไป — auth, เครือข่าย, ข้อมูล, deployment

คำถามที่พบบ่อยเกี่ยวกับการแก้ปัญหา
วิธีแก้ปัญหา Synapse ทั่วไป
ฉันล็อกอินไม่ได้
อาการ
-  ส่งกลับ 401
- "Invalid email or password"
วิธีแก้
1. ตรวจสอบ email ถูกต้อง — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่
2. ตรวจสอบรหัสผ่าน — ขั้นต่ำ 6 ตัวอักษร
3. สมัครก่อน หากคุณยังไม่มีบัญชี: 
4. รีเซ็ตรหัสผ่าน (หากกำหนดค่า SMTP แล้ว) ผ่าน web UI
ฉันสูญเสีย Mind Key
อาการ
- เข้าถึง memory ไม่ได้
- Mind Key ถูกลบ/สูญหาย
วิธีแก้
Mind Key กู้คืนไม่ได้ คุณต้อง:
1. ล็อกอินเพื่อรับ JWT: 
2. รายการ mind:  (ด้วย JWT)
3. สร้าง mind ใหม่: 
4. บันทึก Mind Key ใหม่
5. (ตัวเลือก) ลบ mind เก่า: 
ข้อมูลใน mind เก่าสูญหาย เว้นแต่คุณหา Mind Key ได้
API call ส่งกลับ 401
อาการ
- API call ทั้งหมดส่งกลับ 401 Unauthorized
- "Mind Key fehlt oder ungültig"
วิธีแก้
1. ตรวจสอบรูปแบบ header: 
2. ตรวจ Mind Key ขึ้นต้นด้วย  (ไม่ใช่  ซึ่งเป็น JWT)
3. ทดสอบโดยตรง:
   [CODE BLOCK]
4. Mind Key อาจถูกเพิกถอน — สร้าง mind ใหม่
ดู Authentication
API call ส่งกลับ 404
อาการ
- 404 Not Found
- "Route not found"
วิธีแก้
> [!CRITICAL]
> อย่าเดา endpoint path มีเพียง path ใน  เท่านั้นที่มีอยู่
1. ตรวจสอบ endpoint ที่ถูกต้อง: 
2. เปรียบเทียบ URL ตรงตัว — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่, ไม่มี trailing slash
3. ตรวจสอบ HTTP method —  กับ  ต่างกัน
API call ส่งกลับ 429
อาการ
- 429 Too Many Requests
- "Rate limit exceeded"
วิธีแก้
1. เปลี่ยนไปใช้ header auth (ไม่จำกัดอัตรา):
   [CODE BLOCK]
2. รอ  วินาที หากต้องใช้ 
ดู Rate Limits
การค้นหา memory ส่งกลับไม่มีผลลัพธ์
อาการ
-  ส่งกลับว่าง
- รู้ว่ามี memory อยู่
วิธีแก้
1. ตรวจสอบ memory มีอยู่: 
2. ตรวจสอบไวยากรณ์ search — FTS5 มีไวยากรณ์เฉพาะ
3. ลอง query ที่ง่ายกว่า —  แทน 
4. ใช้ semantic search สำหรับ query เชิงแนวคิด: 
ดู FTS5 Search
memory ไม่คงอยู่
อาการ
- POST /memory ส่งกลับสำเร็จ
- GET /memory/recall ไม่แสดง memory เหล่านั้น
วิธีแก้
1. ตรวจสอบ Mind Key เดียวกัน — key ต่างกัน = mind ต่างกัน
2. ตรวจสอบ response — POST ส่งกลับ 
3. ลอง GET /memory (รายการ JSON) แทน /memory/recall (text)
4. ตรวจสอบ filter —  หรือ  อาจซ่อนไว้
tool ไม่ปรากฏใน Claude Desktop
อาการ
- Claude Desktop แสดง 0 tool
- ไม่มีไอคอน 🔌
วิธีแก้
1. รีสตาร์ท Claude Desktop ให้เต็มรูปแบบ (Cmd+Q)
2. ตรวจสอบ config file เป็น JSON ที่ถูกต้อง
3. ตรวจ Node.js 18+ ติดตั้ง
4. รัน MCP ด้วยตนเอง: 
5. ตรวจ log: 
ดู MCP Troubleshooting
Synapse ออฟไลน์
อาการ
- เข้าถึง synapse.schaefer.zone ไม่ได้
- curl หมดเวลา
วิธีแก้
1. ตรวจสอบอินเทอร์เน็ต — ลองเว็บไซต์อื่น
2. ตรวจสอบสุขภาพ Synapse: 
3. รอ — อาจเป็น outage ชั่วคราวหรือ deployment
4. ตรวจสอบหน้าสถานะ (หากมี)
สำหรับ self-host: ตรวจสอบสถานะ Docker container, การเชื่อมต่อฐานข้อมูล
ข้อผิดพลาดฐานข้อมูล
อาการ
- 500 Internal Server Error
- "Database connection failed"
วิธีแก้
สำหรับ self-host:
1. ตรวจ PostgreSQL รันอยู่: 
2. ตรวจ DATABASEURL ใน env
3. ตรวจ migration: 
4. ตรวจพื้นที่ดิสก์: 
สำหรับโฮสต์: รายงานไปยัง support
Webhook ไม่ทำงาน
อาการ
- ลงทะเบียน webhook แล้วแต่ไม่ได้รับ callback
- ไม่มี POST ไปยัง URL ของคุณ
วิธีแก้
1. ตรวจสอบ URL เข้าถึงได้: 
2. ตรวจสอบ filter event —  ตรงทุก memory event
3. ทดสอบ webhook: 
4. ตรวจ webhook เปิดใช้งาน: 
5. ตรวจสอบ SSL — Synapse ต้องการ HTTPS ที่ถูกต้องสำหรับ webhook URL
ดู Webhooks API
Cron job ไม่รัน
อาการ
- สร้าง cron job แล้วแต่ไม่ทำงาน
-  ไม่อัปเดต
วิธีแก้
1. ตรวจไวยากรณ์ schedule — ต้องเป็น 5-field cron หรือ integer วินาที
2. ตรวจ endpoint ได้รับอนุญาต — ต้องเป็น http(s), ไม่มี private IP
3. ตรวจ job เปิดใช้งาน: 
4. รอเวลาที่ตั้งเวลาไว้ถัดไป — cron ไม่ใช่ทันที
ดู Cron & Scheduler
ต้องการความช่วยเหลือเพิ่มเติม?
1. ตรวจเอกสารที่มี: <https://synapse.schaefer.zone/docs>
2. ค้นหาเอกสาร: 
3. เปิด issue: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. ติดต่อ: ดูหน้า 
ขั้นตอนถัดไป
- Errors & Error Handling
- คำถามที่พบบ่อยเกี่ยวกับ API
- MCP Troubleshooting