# ट्रबलशूटिंग FAQ
SUMMARY: सामान्य Synapse समस्याओं के समाधान — प्रमाणीकरण, नेटवर्क, डेटा, परिनियोजन।

ट्रबलशूटिंग FAQ
सामान्य Synapse समस्याओं के समाधान।
मैं लॉगिन नहीं कर पा रहा
लक्षण
-  401 लौटाता है
- "Invalid email or password"
समाधान
1. ईमेल सही है सत्यापित करें — केस संवेदनशील
2. पासवर्ड जाँचें — न्यूनतम 6 अक्षर
3. पहले पंजीकरण करें यदि आपके पास खाता नहीं है: 
4. पासवर्ड रीसेट करें (यदि SMTP कॉन्फ़िगर है) वेब UI के माध्यम से
मैंने अपनी Mind Key खो दी
लक्षण
- मेमोरीज़ एक्सेस नहीं कर सकते
- Mind Key हटा दी गई/खो गई
समाधान
Mind Keys पुनः प्राप्त नहीं की जा सकतीं। आपको ये करना होगा:
1. JWT प्राप्त करने के लिए लॉगिन करें: 
2. Minds की सूची बनाएँ:  (JWT के साथ)
3. नया mind बनाएँ: 
4. नई Mind Key सहेजें
5. (वैकल्पिक) पुराना mind हटाएँ: 
पुराने mind का डेटा खो गया जब तक आप Mind Key न ढूँढ लें।
API कॉल्स 401 लौटाते हैं
लक्षण
- सभी API कॉल्स 401 Unauthorized लौटाते हैं
- "Mind Key fehlt oder ungültig"
समाधान
1. हेडर प्रारूप सत्यापित करें: 
2. जाँचें Mind Key  से शुरू होती है (न कि  जो JWT है)
3. सीधे परीक्षण करें:
   [CODE BLOCK]
4. Mind Key रद्द हो सकती है — नया mind बनाएँ
प्रमाणीकरण देखें।
API कॉल्स 404 लौटाते हैं
लक्षण
- 404 Not Found
- "Route not found"
समाधान
> [!CRITICAL]
> एंडपॉइंट पाथ का अनुमान न लगाएँ। केवल  में पाथ मौजूद हैं।
1. वैध एंडपॉइंट्स जाँचें: 
2. URL सटीक तुलना करें — केस संवेदनशील, कोई अनुगामी स्लैश नहीं
3. HTTP विधि जाँचें —  बनाम  भिन्न हैं
API कॉल्स 429 लौटाते हैं
लक्षण
- 429 Too Many Requests
- "Rate limit exceeded"
समाधान
1. हेडर प्रमाणीकरण पर स्विच करें (कोई रेट लिमिट नहीं):
   [CODE BLOCK]
2. यदि आपको  उपयोग करना ही है तो  सेकंड प्रतीक्षा करें
रेट लिमिट देखें।
मेमोरी खोज कोई परिणाम नहीं लौटाती
लक्षण
-  खाली लौटाता है
- जानते हैं मेमोरीज़ मौजूद हैं
समाधान
1. मेमोरीज़ मौजूद हैं सत्यापित करें: 
2. खोज सिंटैक्स जाँचें — FTS5 की विशिष्ट सिंटैक्स है
3. सरल क्वेरी आज़माएँ —  के बजाय 
4. वैचारिक क्वेरीज़ के लिए सिमेंटिक खोज का उपयोग करें: 
FTS5 Search देखें।
मेमोरीज़ बनी नहीं रह रहीं
लक्षण
- POST /memory success लौटाता है
- GET /memory/recall उन्हें नहीं दिखाता
समाधान
1. समान Mind Key सत्यापित करें — भिन्न कुंजी = भिन्न minds
2. प्रतिक्रिया जाँचें — POST  लौटाता है
3. /memory/recall (टेक्स्ट) के बजाय GET /memory (JSON सूची) आज़माएँ
4. फ़िल्टर जाँचें —  या  उन्हें छिपा सकते हैं
Claude Desktop में टूल्स दिखाई नहीं दे रहे
लक्षण
- Claude Desktop 0 टूल्स दिखाता है
- कोई 🔌 आइकन नहीं
समाधान
1. Claude Desktop पूरी तरह रीस्टार्ट करें (Cmd+Q)
2. सत्यापित करें कॉन्फ़िग फ़ाइल वैध JSON है
3. Node.js 18+ इंस्टॉल जाँचें
4. MCP मैन्युअली चलाएँ: 
5. लॉग जाँचें: 
MCP ट्रबलशूटिंग देखें।
Synapse ऑफ़लाइन है
लक्षण
- synapse.schaefer.zone तक नहीं पहुँच सकते
- curl समय समाप्त होता है
समाधान
1. अपना इंटरनेट जाँचें — किसी अन्य साइट का प्रयास करें
2. Synapse स्वास्थ्य जाँचें: 
3. प्रतीक्षा करें — अस्थायी आउटेज या परिनियोजन हो सकता है
4. स्टेटस पृष्ठ जाँचें (यदि उपलब्ध हो)
सेल्फ-होस्टेड के लिए: Docker कंटेनर स्थिति, डेटाबेस कनेक्शन जाँचें।
डेटाबेस त्रुटियाँ
लक्षण
- 500 Internal Server Error
- "Database connection failed"
समाधान
सेल्फ-होस्टेड के लिए:
1. PostgreSQL चल रहा है जाँचें: 
2. env में DATABASEURL जाँचें
3. माइग्रेशन जाँचें: 
4. डिस्क स्थान जाँचें: 
होस्टेड के लिए: सहायता को रिपोर्ट करें।
Webhook सक्रिय नहीं हो रहा
लक्षण
- Webhook पंजीकृत किया लेकिन कॉलबैक नहीं मिल रहे
- आपके URL पर कोई POST नहीं
समाधान
1. URL पहुँच योग्य है सत्यापित करें: 
2. events फ़िल्टर जाँचें —  सभी मेमोरी घटनाओं से मेल खाता है
3. webhook परीक्षण: 
4. webhook सक्षम है जाँचें: 
5. SSL सत्यापित करें — Synapse को webhook URLs के लिए वैध HTTPS चाहिए
Webhooks API देखें।
Cron कार्य नहीं चल रहा
लक्षण
- Cron कार्य बनाया लेकिन सक्रिय नहीं हो रहा
-  अपडेट नहीं हो रहा
समाधान
1. शेड्यूल सिंटैक्स जाँचें — वैध 5-फ़ील्ड cron या पूर्णांक सेकंड होना चाहिए
2. एंडपॉइंट अनुमत है सत्यापित करें — http(s) होना चाहिए, कोई निजी IP नहीं
3. कार्य सक्षम है जाँचें: 
4. अगले शेड्यूल किए गए समय की प्रतीक्षा करें — cron तुरंत नहीं होता
Cron और Scheduler देखें।
और सहायता चाहिए?
1. मौजूदा दस्तावेज़ जाँचें: <https://synapse.schaefer.zone/docs>
2. दस्तावेज़ खोजें: 
3. Issue खोलें: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. संपर्क:  पृष्ठ देखें
अगले कदम
- त्रुटियाँ और त्रुटि प्रबंधन
- API FAQ
- MCP ट्रबलशूटिंग