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

วิธีแก้ปัญหา 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. **ทดสอบโดยตรง**:
   ```bash
   curl -H "Authorization: Bearer mk_YOUR_KEY" \
        https://synapse.schaefer.zone/memory/recall
   ```
4. **Mind Key อาจถูกเพิกถอน** — สร้าง mind ใหม่

ดู [Authentication](/docs/getting-started/authentication)

## API call ส่งกลับ 404

### อาการ

- 404 Not Found
- "Route not found"

### วิธีแก้

> [!CRITICAL]
> อย่าเดา endpoint path มีเพียง path ใน `GET /endpoints` เท่านั้นที่มีอยู่

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** (ไม่จำกัดอัตรา):
   ```bash
   # Don't
   curl ".../memory/recall?key=mk_..."
   
   # Do
   curl -H "Authorization: Bearer mk_..." .../memory/recall
   ```
2. **รอ `Retry-After` วินาที** หากต้องใช้ `?key=`

ดู [Rate Limits](/docs/api/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](/docs/concepts/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](/docs/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](/docs/api/webhooks)

## 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](/docs/api/cron)

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

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](/docs/api/errors)
- [คำถามที่พบบ่อยเกี่ยวกับ API](/docs/faq/api-faq)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)