{"title":"ट्रबलशूटिंग FAQ","slug":"troubleshooting","category":"faq","summary":"सामान्य Synapse समस्याओं के समाधान — प्रमाणीकरण, नेटवर्क, डेटा, परिनियोजन।","audience":["human","llm"],"tags":["faq","troubleshooting","problems","solutions"],"difficulty":"beginner","updated":"2026-06-27","word_count":727,"read_minutes":4,"lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# ट्रबलशूटिंग FAQ\n\nसामान्य Synapse समस्याओं के समाधान।\n\n## मैं लॉगिन नहीं कर पा रहा\n\n### लक्षण\n\n- `POST /login` 401 लौटाता है\n- \"Invalid email or password\"\n\n### समाधान\n\n1. **ईमेल सही है सत्यापित करें** — केस संवेदनशील\n2. **पासवर्ड जाँचें** — न्यूनतम 6 अक्षर\n3. **पहले पंजीकरण करें** यदि आपके पास खाता नहीं है: `POST /register`\n4. **पासवर्ड रीसेट करें** (यदि SMTP कॉन्फ़िगर है) वेब UI के माध्यम से\n\n## मैंने अपनी Mind Key खो दी\n\n### लक्षण\n\n- मेमोरीज़ एक्सेस नहीं कर सकते\n- Mind Key हटा दी गई/खो गई\n\n### समाधान\n\nMind Keys पुनः प्राप्त नहीं की जा सकतीं। आपको ये करना होगा:\n\n1. JWT प्राप्त करने के लिए लॉगिन करें: `POST /login`\n2. Minds की सूची बनाएँ: `GET /minds` (JWT के साथ)\n3. नया mind बनाएँ: `POST /minds`\n4. नई Mind Key सहेजें\n5. (वैकल्पिक) पुराना mind हटाएँ: `DELETE /minds/:id`\n\n**पुराने mind का डेटा खो गया** जब तक आप Mind Key न ढूँढ लें।\n\n## API कॉल्स 401 लौटाते हैं\n\n### लक्षण\n\n- सभी API कॉल्स 401 Unauthorized लौटाते हैं\n- \"Mind Key fehlt oder ungültig\"\n\n### समाधान\n\n1. **हेडर प्रारूप सत्यापित करें**: `Authorization: Bearer mk_...`\n2. **जाँचें Mind Key `mk_` से शुरू होती है** (न कि `eyJ` जो JWT है)\n3. **सीधे परीक्षण करें**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n4. **Mind Key रद्द हो सकती है** — नया mind बनाएँ\n\n[प्रमाणीकरण](/docs/getting-started/authentication) देखें।\n\n## API कॉल्स 404 लौटाते हैं\n\n### लक्षण\n\n- 404 Not Found\n- \"Route not found\"\n\n### समाधान\n\n> [!CRITICAL]\n> एंडपॉइंट पाथ का अनुमान न लगाएँ। केवल `GET /endpoints` में पाथ मौजूद हैं।\n\n1. **वैध एंडपॉइंट्स जाँचें**: `curl https://synapse.schaefer.zone/endpoints`\n2. **URL सटीक तुलना करें** — केस संवेदनशील, कोई अनुगामी स्लैश नहीं\n3. **HTTP विधि जाँचें** — `GET /memory` बनाम `POST /memory` भिन्न हैं\n\n## API कॉल्स 429 लौटाते हैं\n\n### लक्षण\n\n- 429 Too Many Requests\n- \"Rate limit exceeded\"\n\n### समाधान\n\n1. **हेडर प्रमाणीकरण पर स्विच करें** (कोई रेट लिमिट नहीं):\n ```bash\n # Don't\n curl \".../memory/recall?key=mk_...\"\n \n # Do\n curl -H \"Authorization: Bearer mk_...\" .../memory/recall\n ```\n2. **यदि आपको `?key=` उपयोग करना ही है तो `Retry-After` सेकंड प्रतीक्षा करें**\n\n[रेट लिमिट](/docs/api/rate-limits) देखें।\n\n## मेमोरी खोज कोई परिणाम नहीं लौटाती\n\n### लक्षण\n\n- `GET /memory/search?q=...` खाली लौटाता है\n- जानते हैं मेमोरीज़ मौजूद हैं\n\n### समाधान\n\n1. **मेमोरीज़ मौजूद हैं सत्यापित करें**: `GET /memory/recall`\n2. **खोज सिंटैक्स जाँचें** — FTS5 की विशिष्ट सिंटैक्स है\n3. **सरल क्वेरी आज़माएँ** — `?q=docker+swarm+deployment` के बजाय `?q=docker`\n4. **वैचारिक क्वेरीज़ के लिए सिमेंटिक खोज का उपयोग करें**: `GET /memory/semantic-search?q=...`\n\n[FTS5 Search](/docs/concepts/fts5-search) देखें।\n\n## मेमोरीज़ बनी नहीं रह रहीं\n\n### लक्षण\n\n- POST /memory success लौटाता है\n- GET /memory/recall उन्हें नहीं दिखाता\n\n### समाधान\n\n1. **समान Mind Key सत्यापित करें** — भिन्न कुंजी = भिन्न minds\n2. **प्रतिक्रिया जाँचें** — POST `{ \"id\": \"mem_...\", \"status\": \"stored\" }` लौटाता है\n3. **/memory/recall (टेक्स्ट) के बजाय GET /memory (JSON सूची) आज़माएँ**\n4. **फ़िल्टर जाँचें** — `?category=` या `?tag=` उन्हें छिपा सकते हैं\n\n## Claude Desktop में टूल्स दिखाई नहीं दे रहे\n\n### लक्षण\n\n- Claude Desktop 0 टूल्स दिखाता है\n- कोई 🔌 आइकन नहीं\n\n### समाधान\n\n1. **Claude Desktop पूरी तरह रीस्टार्ट करें** (Cmd+Q)\n2. **सत्यापित करें कॉन्फ़िग फ़ाइल** वैध JSON है\n3. **Node.js 18+ इंस्टॉल जाँचें**\n4. **MCP मैन्युअली चलाएँ**: `npx -y synapse-mcp-api@latest`\n5. **लॉग जाँचें**: `~/Library/Logs/Claude/mcp.log`\n\n[MCP ट्रबलशूटिंग](/docs/mcp/troubleshooting) देखें।\n\n## Synapse ऑफ़लाइन है\n\n### लक्षण\n\n- synapse.schaefer.zone तक नहीं पहुँच सकते\n- curl समय समाप्त होता है\n\n### समाधान\n\n1. **अपना इंटरनेट जाँचें** — किसी अन्य साइट का प्रयास करें\n2. **Synapse स्वास्थ्य जाँचें**: `curl https://synapse.schaefer.zone/health`\n3. **प्रतीक्षा करें** — अस्थायी आउटेज या परिनियोजन हो सकता है\n4. **स्टेटस पृष्ठ जाँचें** (यदि उपलब्ध हो)\n\nसेल्फ-होस्टेड के लिए: Docker कंटेनर स्थिति, डेटाबेस कनेक्शन जाँचें।\n\n## डेटाबेस त्रुटियाँ\n\n### लक्षण\n\n- 500 Internal Server Error\n- \"Database connection failed\"\n\n### समाधान\n\nसेल्फ-होस्टेड के लिए:\n\n1. **PostgreSQL चल रहा है जाँचें**: `docker ps | grep postgres`\n2. **env में DATABASE_URL जाँचें**\n3. **माइग्रेशन जाँचें**: `npm run migrate:check`\n4. **डिस्क स्थान जाँचें**: `df -h`\n\nहोस्टेड के लिए: सहायता को रिपोर्ट करें।\n\n## Webhook सक्रिय नहीं हो रहा\n\n### लक्षण\n\n- Webhook पंजीकृत किया लेकिन कॉलबैक नहीं मिल रहे\n- आपके URL पर कोई POST नहीं\n\n### समाधान\n\n1. **URL पहुँच योग्य है सत्यापित करें**: `curl -X POST your-url -d '{}'`\n2. **events फ़िल्टर जाँचें** — `memory.*` सभी मेमोरी घटनाओं से मेल खाता है\n3. **webhook परीक्षण**: `POST /webhooks/:id/test`\n4. **webhook सक्षम है जाँचें**: `GET /webhooks/:id`\n5. **SSL सत्यापित करें** — Synapse को webhook URLs के लिए वैध HTTPS चाहिए\n\n[Webhooks API](/docs/api/webhooks) देखें।\n\n## Cron कार्य नहीं चल रहा\n\n### लक्षण\n\n- Cron कार्य बनाया लेकिन सक्रिय नहीं हो रहा\n- `next_run` अपडेट नहीं हो रहा\n\n### समाधान\n\n1. **शेड्यूल सिंटैक्स जाँचें** — वैध 5-फ़ील्ड cron या पूर्णांक सेकंड होना चाहिए\n2. **एंडपॉइंट अनुमत है सत्यापित करें** — http(s) होना चाहिए, कोई निजी IP नहीं\n3. **कार्य सक्षम है जाँचें**: `GET /cron`\n4. **अगले शेड्यूल किए गए समय की प्रतीक्षा करें** — cron तुरंत नहीं होता\n\n[Cron और Scheduler](/docs/api/cron) देखें।\n\n## और सहायता चाहिए?\n\n1. **मौजूदा दस्तावेज़ जाँचें**: \n2. **दस्तावेज़ खोजें**: `GET /docs/search?q=your+question`\n3. **Issue खोलें**: \n4. **संपर्क**: `/support` पृष्ठ देखें\n\n## अगले कदम\n\n- [त्रुटियाँ और त्रुटि प्रबंधन](/docs/api/errors)\n- [API FAQ](/docs/faq/api-faq)\n- [MCP ट्रबलशूटिंग](/docs/mcp/troubleshooting)\n","content_html":"

ट्रबलशूटिंग FAQ

\n

सामान्य Synapse समस्याओं के समाधान।

\n

मैं लॉगिन नहीं कर पा रहा

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. ईमेल सही है सत्यापित करें — केस संवेदनशील
    2. \n
  2. पासवर्ड जाँचें — न्यूनतम 6 अक्षर
    3. \n
  3. पहले पंजीकरण करें यदि आपके पास खाता नहीं है: POST /register
    4. \n
  4. पासवर्ड रीसेट करें (यदि SMTP कॉन्फ़िगर है) वेब UI के माध्यम से
    5. \n
\n

मैंने अपनी Mind Key खो दी

\n

लक्षण

\n\n

समाधान

\n

Mind Keys पुनः प्राप्त नहीं की जा सकतीं। आपको ये करना होगा:

\n
    \n
  1. JWT प्राप्त करने के लिए लॉगिन करें: POST /login
    2. \n
  2. Minds की सूची बनाएँ: GET /minds (JWT के साथ)
    3. \n
  3. नया mind बनाएँ: POST /minds
    4. \n
  4. नई Mind Key सहेजें
    5. \n
  5. (वैकल्पिक) पुराना mind हटाएँ: DELETE /minds/:id
    6. \n
\n

पुराने mind का डेटा खो गया जब तक आप Mind Key न ढूँढ लें।

\n

API कॉल्स 401 लौटाते हैं

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. हेडर प्रारूप सत्यापित करें: Authorization: Bearer mk_...
    2. \n
  2. जाँचें Mind Key mk_ से शुरू होती है (न कि eyJ जो JWT है)
    3. \n
  3. सीधे परीक्षण करें:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    4. \n
  4. Mind Key रद्द हो सकती है — नया mind बनाएँ
    5. \n
\n

प्रमाणीकरण देखें।

\n

API कॉल्स 404 लौटाते हैं

\n

लक्षण

\n\n

समाधान

\n
एंडपॉइंट पाथ का अनुमान न लगाएँ। केवल `GET /endpoints` में पाथ मौजूद हैं।
    \n
  1. वैध एंडपॉइंट्स जाँचें: curl https://synapse.schaefer.zone/endpoints
    2. \n
  2. URL सटीक तुलना करें — केस संवेदनशील, कोई अनुगामी स्लैश नहीं
    3. \n
  3. HTTP विधि जाँचें — GET /memory बनाम POST /memory भिन्न हैं
    4. \n
\n

API कॉल्स 429 लौटाते हैं

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. हेडर प्रमाणीकरण पर स्विच करें (कोई रेट लिमिट नहीं):
    # Don't\ncurl ".../memory/recall?key=mk_..."\n\n# Do\ncurl -H "Authorization: Bearer mk_..." .../memory/recall
    2. \n
  2. यदि आपको ?key= उपयोग करना ही है तो Retry-After सेकंड प्रतीक्षा करें
    3. \n
\n

रेट लिमिट देखें।

\n

मेमोरी खोज कोई परिणाम नहीं लौटाती

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. मेमोरीज़ मौजूद हैं सत्यापित करें: GET /memory/recall
    2. \n
  2. खोज सिंटैक्स जाँचें — FTS5 की विशिष्ट सिंटैक्स है
    3. \n
  3. सरल क्वेरी आज़माएँ — ?q=docker+swarm+deployment के बजाय ?q=docker
    4. \n
  4. वैचारिक क्वेरीज़ के लिए सिमेंटिक खोज का उपयोग करें: GET /memory/semantic-search?q=...
    5. \n
\n

FTS5 Search देखें।

\n

मेमोरीज़ बनी नहीं रह रहीं

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. समान Mind Key सत्यापित करें — भिन्न कुंजी = भिन्न minds
    2. \n
  2. प्रतिक्रिया जाँचें — POST { "id": "mem_...", "status": "stored" } लौटाता है
    3. \n
  3. /memory/recall (टेक्स्ट) के बजाय GET /memory (JSON सूची) आज़माएँ
    4. \n
  4. फ़िल्टर जाँचें — ?category= या ?tag= उन्हें छिपा सकते हैं
    5. \n
\n

Claude Desktop में टूल्स दिखाई नहीं दे रहे

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. Claude Desktop पूरी तरह रीस्टार्ट करें (Cmd+Q)
    2. \n
  2. सत्यापित करें कॉन्फ़िग फ़ाइल वैध JSON है
    3. \n
  3. Node.js 18+ इंस्टॉल जाँचें
    4. \n
  4. MCP मैन्युअली चलाएँ: npx -y synapse-mcp-api@latest
    5. \n
  5. लॉग जाँचें: ~/Library/Logs/Claude/mcp.log
    6. \n
\n

MCP ट्रबलशूटिंग देखें।

\n

Synapse ऑफ़लाइन है

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. अपना इंटरनेट जाँचें — किसी अन्य साइट का प्रयास करें
    2. \n
  2. Synapse स्वास्थ्य जाँचें: curl https://synapse.schaefer.zone/health
    3. \n
  3. प्रतीक्षा करें — अस्थायी आउटेज या परिनियोजन हो सकता है
    4. \n
  4. स्टेटस पृष्ठ जाँचें (यदि उपलब्ध हो)
    5. \n
\n

सेल्फ-होस्टेड के लिए: Docker कंटेनर स्थिति, डेटाबेस कनेक्शन जाँचें।

\n

डेटाबेस त्रुटियाँ

\n

लक्षण

\n\n

समाधान

\n

सेल्फ-होस्टेड के लिए:

\n
    \n
  1. PostgreSQL चल रहा है जाँचें: docker ps | grep postgres
    2. \n
  2. env में DATABASE_URL जाँचें
    3. \n
  3. माइग्रेशन जाँचें: npm run migrate:check
    4. \n
  4. डिस्क स्थान जाँचें: df -h
    5. \n
\n

होस्टेड के लिए: सहायता को रिपोर्ट करें।

\n

Webhook सक्रिय नहीं हो रहा

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. URL पहुँच योग्य है सत्यापित करें: curl -X POST your-url -d '{}'
    2. \n
  2. events फ़िल्टर जाँचें — memory.* सभी मेमोरी घटनाओं से मेल खाता है
    3. \n
  3. webhook परीक्षण: POST /webhooks/:id/test
    4. \n
  4. webhook सक्षम है जाँचें: GET /webhooks/:id
    5. \n
  5. SSL सत्यापित करें — Synapse को webhook URLs के लिए वैध HTTPS चाहिए
    6. \n
\n

Webhooks API देखें।

\n

Cron कार्य नहीं चल रहा

\n

लक्षण

\n\n

समाधान

\n
    \n
  1. शेड्यूल सिंटैक्स जाँचें — वैध 5-फ़ील्ड cron या पूर्णांक सेकंड होना चाहिए
    2. \n
  2. एंडपॉइंट अनुमत है सत्यापित करें — http(s) होना चाहिए, कोई निजी IP नहीं
    3. \n
  3. कार्य सक्षम है जाँचें: GET /cron
    4. \n
  4. अगले शेड्यूल किए गए समय की प्रतीक्षा करें — cron तुरंत नहीं होता
    5. \n
\n

Cron और Scheduler देखें।

\n

और सहायता चाहिए?

\n
    \n
  1. मौजूदा दस्तावेज़ जाँचें: https://synapse.schaefer.zone/docs
    2. \n
  2. दस्तावेज़ खोजें: GET /docs/search?q=your+question
    3. \n
  3. Issue खोलें: https://gitlab.com/schaefer-services/synapse/-/issues
    4. \n
  4. संपर्क: /support पृष्ठ देखें
    5. \n
\n

अगले कदम

\n\n","urls":{"html":"/docs/faq/troubleshooting","text":"/docs/faq/troubleshooting?format=text","json":"/docs/faq/troubleshooting?format=json","llm":"/docs/faq/troubleshooting?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}