คำถามที่พบบ่อยเกี่ยวกับการแก้ปัญหา

วิธีแก้ปัญหา Synapse ทั่วไป

ฉันล็อกอินไม่ได้

อาการ

• POST /login ส่งกลับ 401
• "Invalid email or password"

วิธีแก้

1. ตรวจสอบ email ถูกต้อง — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่
2. ตรวจสอบรหัสผ่าน — ขั้นต่ำ 6 ตัวอักษร
3. สมัครก่อน หากคุณยังไม่มีบัญชี: POST /register
4. รีเซ็ตรหัสผ่าน (หากกำหนดค่า SMTP แล้ว) ผ่าน web UI

ฉันสูญเสีย Mind Key

อาการ

• เข้าถึง memory ไม่ได้
• Mind Key ถูกลบ/สูญหาย

วิธีแก้

Mind Key กู้คืนไม่ได้ คุณต้อง:

1. ล็อกอินเพื่อรับ JWT: POST /login
2. รายการ mind: GET /minds (ด้วย JWT)
3. สร้าง mind ใหม่: POST /minds
4. บันทึก Mind Key ใหม่
5. (ตัวเลือก) ลบ mind เก่า: DELETE /minds/:id

ข้อมูลใน mind เก่าสูญหาย เว้นแต่คุณหา Mind Key ได้

API call ส่งกลับ 401

อาการ

• API call ทั้งหมดส่งกลับ 401 Unauthorized
• "Mind Key fehlt oder ungültig"

วิธีแก้

1. ตรวจสอบรูปแบบ header: Authorization: Bearer mk_...
2. ตรวจ Mind Key ขึ้นต้นด้วย mk_ (ไม่ใช่ eyJ ซึ่งเป็น JWT)
3. ทดสอบโดยตรง:

   curl -H "Authorization: Bearer mk_YOUR_KEY" \
        https://synapse.schaefer.zone/memory/recall

4. Mind Key อาจถูกเพิกถอน — สร้าง mind ใหม่

ดู Authentication

API call ส่งกลับ 404

อาการ

• 404 Not Found
• "Route not found"

วิธีแก้

1. ตรวจสอบ endpoint ที่ถูกต้อง: curl https://synapse.schaefer.zone/endpoints
2. เปรียบเทียบ URL ตรงตัว — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่, ไม่มี trailing slash
3. ตรวจสอบ HTTP method — GET /memory กับ POST /memory ต่างกัน

API call ส่งกลับ 429

อาการ

• 429 Too Many Requests
• "Rate limit exceeded"

วิธีแก้

1. เปลี่ยนไปใช้ header auth (ไม่จำกัดอัตรา):

   # Don't
   curl ".../memory/recall?key=mk_..."
   
   # Do
   curl -H "Authorization: Bearer mk_..." .../memory/recall

2. รอ Retry-After วินาที หากต้องใช้ ?key=

ดู Rate Limits

การค้นหา memory ส่งกลับไม่มีผลลัพธ์

อาการ

• GET /memory/search?q=... ส่งกลับว่าง
• รู้ว่ามี memory อยู่

วิธีแก้

1. ตรวจสอบ memory มีอยู่: GET /memory/recall
2. ตรวจสอบไวยากรณ์ search — FTS5 มีไวยากรณ์เฉพาะ
3. ลอง query ที่ง่ายกว่า — ?q=docker แทน ?q=docker+swarm+deployment
4. ใช้ semantic search สำหรับ query เชิงแนวคิด: GET /memory/semantic-search?q=...

ดู FTS5 Search

memory ไม่คงอยู่

อาการ

• POST /memory ส่งกลับสำเร็จ
• GET /memory/recall ไม่แสดง memory เหล่านั้น

วิธีแก้

1. ตรวจสอบ Mind Key เดียวกัน — key ต่างกัน = mind ต่างกัน
2. ตรวจสอบ response — POST ส่งกลับ { "id": "mem_...", "status": "stored" }
3. ลอง GET /memory (รายการ JSON) แทน /memory/recall (text)
4. ตรวจสอบ filter — ?category= หรือ ?tag= อาจซ่อนไว้

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

อาการ

• Claude Desktop แสดง 0 tool
• ไม่มีไอคอน 🔌

วิธีแก้

1. รีสตาร์ท Claude Desktop ให้เต็มรูปแบบ (Cmd+Q)
2. ตรวจสอบ config file เป็น JSON ที่ถูกต้อง
3. ตรวจ Node.js 18+ ติดตั้ง
4. รัน MCP ด้วยตนเอง: npx -y synapse-mcp-api@latest
5. ตรวจ log: ~/Library/Logs/Claude/mcp.log

ดู MCP Troubleshooting

Synapse ออฟไลน์

อาการ

• เข้าถึง synapse.schaefer.zone ไม่ได้
• curl หมดเวลา

วิธีแก้

1. ตรวจสอบอินเทอร์เน็ต — ลองเว็บไซต์อื่น
2. ตรวจสอบสุขภาพ Synapse: curl https://synapse.schaefer.zone/health
3. รอ — อาจเป็น outage ชั่วคราวหรือ deployment
4. ตรวจสอบหน้าสถานะ (หากมี)

สำหรับ self-host: ตรวจสอบสถานะ Docker container, การเชื่อมต่อฐานข้อมูล

ข้อผิดพลาดฐานข้อมูล

อาการ

• 500 Internal Server Error
• "Database connection failed"

วิธีแก้

สำหรับ self-host:

1. ตรวจ PostgreSQL รันอยู่: docker ps | grep postgres
2. ตรวจ DATABASE_URL ใน env
3. ตรวจ migration: npm run migrate:check
4. ตรวจพื้นที่ดิสก์: df -h

สำหรับโฮสต์: รายงานไปยัง support

Webhook ไม่ทำงาน

อาการ

• ลงทะเบียน webhook แล้วแต่ไม่ได้รับ callback
• ไม่มี POST ไปยัง URL ของคุณ

วิธีแก้

1. ตรวจสอบ URL เข้าถึงได้: curl -X POST your-url -d '{}'
2. ตรวจสอบ filter event — memory.* ตรงทุก memory event
3. ทดสอบ webhook: POST /webhooks/:id/test
4. ตรวจ webhook เปิดใช้งาน: GET /webhooks/:id
5. ตรวจสอบ SSL — Synapse ต้องการ HTTPS ที่ถูกต้องสำหรับ webhook URL

ดู Webhooks API

Cron job ไม่รัน

อาการ

• สร้าง cron job แล้วแต่ไม่ทำงาน
• next_run ไม่อัปเดต

วิธีแก้

1. ตรวจไวยากรณ์ schedule — ต้องเป็น 5-field cron หรือ integer วินาที
2. ตรวจ endpoint ได้รับอนุญาต — ต้องเป็น http(s), ไม่มี private IP
3. ตรวจ job เปิดใช้งาน: GET /cron
4. รอเวลาที่ตั้งเวลาไว้ถัดไป — cron ไม่ใช่ทันที

ดู Cron & Scheduler

ต้องการความช่วยเหลือเพิ่มเติม?

1. ตรวจเอกสารที่มี: https://synapse.schaefer.zone/docs
2. ค้นหาเอกสาร: GET /docs/search?q=your+question
3. เปิด issue: https://gitlab.com/schaefer-services/synapse/-/issues
4. ติดต่อ: ดูหน้า /support

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

• Errors & Error Handling
• คำถามที่พบบ่อยเกี่ยวกับ API
• MCP Troubleshooting