# FAQ khắc phục sự cố SUMMARY: Giải pháp cho các vấn đề Synapse phổ biến — xác thực, mạng, dữ liệu, triển khai. FAQ khắc phục sự cố Giải pháp cho các vấn đề Synapse phổ biến. Tôi không thể đăng nhập Triệu chứng - trả về 401 - "Invalid email or password" Giải pháp 1. Xác minh email chính xác — phân biệt chữ hoa chữ thường 2. Kiểm tra mật khẩu — tối thiểu 6 ký tự 3. Đăng ký trước nếu bạn không có tài khoản: 4. Đặt lại mật khẩu (nếu SMTP được cấu hình) qua giao diện web Tôi mất Mind Key Triệu chứng - Không thể truy cập bộ nhớ - Mind Key đã bị xóa/mất Giải pháp Mind Key không thể khôi phục. Bạn phải: 1. Đăng nhập để lấy JWT: 2. Liệt kê mind: (với JWT) 3. Tạo mind mới: 4. Lưu Mind Key mới 5. (Tùy chọn) Xóa mind cũ: Dữ liệu trong mind cũ bị mất trừ khi bạn có thể tìm thấy Mind Key. Lệnh gọi API trả về 401 Triệu chứng - Tất cả lệnh gọi API trả về 401 Unauthorized - "Mind Key fehlt oder ungültig" Giải pháp 1. Xác minh định dạng header: 2. Kiểm tra Mind Key bắt đầu bằng (không phải là JWT) 3. Kiểm tra trực tiếp: [CODE BLOCK] 4. Mind Key có thể bị thu hồi — tạo mind mới Xem Xác thực. Lệnh gọi API trả về 404 Triệu chứng - 404 Not Found - "Route not found" Giải pháp > [!CRITICAL] > Không đoán đường dẫn endpoint. Chỉ đường dẫn trong mới tồn tại. 1. Kiểm tra endpoint hợp lệ: 2. So sánh URL chính xác — phân biệt chữ hoa chữ thường, không có dấu gạch chéo cuối 3. Kiểm tra phương thức HTTP — khác với Lệnh gọi API trả về 429 Triệu chứng - 429 Too Many Requests - "Rate limit exceeded" Giải pháp 1. Chuyển sang xác thực header (không giới hạn tốc độ): [CODE BLOCK] 2. Đợi giây nếu bạn phải dùng Xem Giới hạn tốc độ. Tìm kiếm bộ nhớ không trả về kết quả Triệu chứng - trả về rỗng - Biết bộ nhớ tồn tại Giải pháp 1. Xác minh bộ nhớ tồn tại: 2. Kiểm tra cú pháp tìm kiếm — FTS5 có cú pháp cụ thể 3. Thử truy vấn đơn giản hơn — thay vì 4. Sử dụng tìm kiếm ngữ nghĩa cho truy vấn khái niệm: Xem Tìm kiếm FTS5. Bộ nhớ không tồn tại Triệu chứng - POST /memory trả về thành công - GET /memory/recall không hiển thị chúng Giải pháp 1. Xác minh cùng Mind Key — key khác = mind khác 2. Kiểm tra phản hồi — POST trả về 3. Thử GET /memory (danh sách JSON) thay vì /memory/recall (văn bản) 4. Kiểm tra bộ lọc — hoặc có thể ẩn chúng Công cụ không xuất hiện trong Claude Desktop Triệu chứng - Claude Desktop hiển thị 0 công cụ - Không có biểu tượng 🔌 Giải pháp 1. Khởi động lại Claude Desktop hoàn toàn (Cmd+Q) 2. Xác minh tệp cấu hình là JSON hợp lệ 3. Kiểm tra Node.js 18+ đã cài đặt 4. Chạy MCP thủ công: 5. Kiểm tra nhật ký: Xem Khắc phục sự cố MCP. Synapse ngoại tuyến Triệu chứng - Không thể truy cập synapse.schaefer.zone - curl hết thời gian chờ Giải pháp 1. Kiểm tra internet của bạn — thử một trang khác 2. Kiểm tra sức khỏe Synapse: 3. Đợi — có thể là sự cố tạm thời hoặc triển khai 4. Kiểm tra trang trạng thái (nếu có) Cho tự lưu trữ: kiểm tra trạng thái Docker container, kết nối database. Lỗi database Triệu chứng - 500 Internal Server Error - "Database connection failed" Giải pháp Cho tự lưu trữ: 1. Kiểm tra PostgreSQL đang chạy: 2. Kiểm tra DATABASEURL trong env 3. Kiểm tra migration: 4. Kiểm tra không gian đĩa: Cho phiên bản được lưu trữ: báo cáo cho hỗ trợ. Webhook không kích hoạt Triệu chứng - Đã đăng ký webhook nhưng không nhận callback - Không có POST đến URL của bạn Giải pháp 1. Xác minh URL có thể truy cập: 2. Kiểm tra bộ lọc sự kiện — khớp tất cả sự kiện memory 3. Kiểm tra webhook: 4. Kiểm tra webhook được bật: 5. Xác minh SSL — Synapse yêu cầu HTTPS hợp lệ cho URL webhook Xem Webhooks API. Cron job không chạy Triệu chứng - Đã tạo cron job nhưng không kích hoạt - không cập nhật Giải pháp 1. Kiểm tra cú pháp lịch — phải là cron 5 trường HOẶC số nguyên giây hợp lệ 2. Xác minh endpoint được phép — phải là http(s), không IP riêng 3. Kiểm tra job được bật: 4. Đợi thời gian lên lịch tiếp theo — cron không tức thời Xem Cron & Scheduler. Cần thêm trợ giúp? 1. Kiểm tra tài liệu hiện có: 2. Tìm kiếm tài liệu: 3. Mở issue: 4. Liên hệ: xem trang Bước tiếp theo - Lỗi & Xử lý lỗi - FAQ API - Khắc phục sự cố MCP