{"title":"MCP समस्या निवारण","slug":"troubleshooting","category":"mcp","summary":"सामान्य MCP एकीकरण समस्याओं को हल करें — server शुरू नहीं हो रहा, टूल दिखाई नहीं दे रहे, auth त्रुटियाँ।","audience":["human","llm"],"tags":["mcp","troubleshooting","errors","debugging"],"difficulty":"intermediate","updated":"2026-06-27","word_count":662,"read_minutes":3,"llm_context":"Common issues:\n1. Node.js < 18 → upgrade to 18+\n2. Mind Key invalid → check format (mk_...), get fresh via POST /minds\n3. npx not found → install Node.js\n4. Tools not appearing → restart client, check config JSON validity\n5. SYNAPSE_URL unreachable → curl /health to verify\n6. MCP server crashes → check logs, run npx manually to see error\nDebug steps: run `npx -y synapse-mcp-api@latest` manually, check stderr\nLogs: Claude Desktop ~/Library/Logs/Claude/mcp.log, Cursor ~/.cursor/logs/\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# MCP समस्या निवारण\n\nSynapse MCP को अपने LLM client के साथ एकीकृत करते समय सामान्य समस्याएँ और समाधान।\n\n## त्वरित डायग्नोस्टिक चेकलिस्ट\n\n1. ✅ Node.js 18+ इंस्टॉल है? (`node --version`)\n2. ✅ Mind Key `mk_` से शुरू होती है? (JWT `eyJ...` नहीं)\n3. ✅ Synapse API पहुँच योग्य है? (`curl https://synapse.schaefer.zone/health`)\n4. ✅ Mind Key काम करती है? (`curl -H \"Authorization: Bearer mk_...\" .../memory/recall`)\n5. ✅ कॉन्फ़िग फ़ाइल वैध JSON है? (कोई ट्रेलिंग कॉमा नहीं, कोई टिप्पणी नहीं)\n6. ✅ कॉन्फ़िग परिवर्तन के बाद client पुनः आरंभ किया?\n7. ✅ MCP server मैन्युअली शुरू होता है? (`npx -y synapse-mcp-api@latest`)\n\n## समस्या: Client में कोई टूल दिखाई नहीं देता\n\n### लक्षण\n\n- Claude Desktop / Cursor / Continue 0 टूल दिखाता है\n- MCP servers सूची में कोई 🔌 आइकन या \"synapse\" एंट्री नहीं\n\n### समाधान\n\n1. **Client पूरी तरह पुनः आरंभ करें** — macOS पर Cmd+Q (केवल विंडो बंद न करें)\n2. **कॉन्फ़िग फ़ाइल स्थान जाँचें**:\n - Claude Desktop macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n - Claude Desktop Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n - Cursor: `~/.cursor/config.json`\n - Continue: `~/.continue/config.json`\n3. **JSON को मान्य करें** — कॉन्फ़िग को में पेस्ट करें\n4. **MCP त्रुटियों के लिए client लॉग जाँचें**:\n - Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n - Cursor: View → Output → MCP\n5. **स्टार्टअप त्रुटियाँ देखने के लिए MCP server मैन्युअली चलाएँ**:\n ```bash\n SYNAPSE_MIND_KEY=mk_... npx -y synapse-mcp-api@latest\n ```\n\n## समस्या: \"Mind Key invalid\" त्रुटि\n\n### लक्षण\n\n- टूल दिखाई देते हैं लेकिन कॉल \"401 Unauthorized\" के साथ विफल होते हैं\n- त्रुटि: \"Mind Key fehlt oder ungültig\"\n\n### समाधान\n\n1. **Mind Key प्रारूप सत्यापित करें** — `mk_` से शुरू, ~40 अक्षर\n2. **सीधे टेस्ट करें**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n3. **जाँचें कि env var सेट है** — stdio ट्रांसपोर्ट के लिए, env var आपके शेल में नहीं, MCP server कॉन्फ़िग में होना चाहिए\n4. **नई Mind Key प्राप्त करें**:\n ```bash\n # Login to get JWT\n curl -X POST .../login -d '{\"email\":\"...\",\"password\":\"...\"}'\n # Create new mind\n curl -X POST .../minds -H \"Authorization: Bearer YOUR_JWT\" -d '{\"name\":\"new mind\"}'\n ```\n\n## समस्या: npx नहीं मिला\n\n### लक्षण\n\n- त्रुटि: \"npx: command not found\"\n- MCP server शुरू होने में विफल\n\n### समाधान\n\n1. **Node.js 18+ इंस्टॉल करें**:\n - macOS: `brew install node` या से डाउनलोड करें\n - Linux: `curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs`\n - Windows: से डाउनलोड करें\n2. **इंस्टॉल के बाद टर्मिनल पुनः आरंभ करें**\n3. **सत्यापित करें**: `node --version && npx --version`\n\n## समस्या: SYNAPSE_URL पहुँच योग्य नहीं\n\n### लक्षण\n\n- MCP server शुरू होता है लेकिन टूल कॉल टाइमआउट हो जाते हैं\n- त्रुटि: \"fetch failed\" या \"ECONNREFUSED\"\n\n### समाधान\n\n1. **कनेक्टिविटी टेस्ट करें**:\n ```bash\n curl https://synapse.schaefer.zone/health\n ```\n2. **कॉर्पोरेट फ़ायरवॉल जाँचें** — आउटबाउंड HTTPS को ब्लॉक कर सकता है\n3. **वैकल्पिक URL आज़माएँ**:\n - Production: `https://synapse.schaefer.zone`\n - MCP server: `https://synapse-mcp.schaefer.zone`\n4. **सेल्फ-होस्टेड के लिए**: सुनिश्चित करें कि आपका Synapse इंस्टेंस चल रहा है और पहुँच योग्य है\n\n## समस्या: MCP Server क्रैश\n\n### लक्षण\n\n- MCP server शुरू होने के तुरंत बाद बाहर निकलता है\n- Client लॉग \"MCP server disconnected\" दिखाते हैं\n\n### समाधान\n\n1. **त्रुटि देखने के लिए मैन्युअली चलाएँ**:\n ```bash\n SYNAPSE_MIND_KEY=mk_... SYNAPSE_URL=https://synapse.schaefer.zone \\\n npx -y synapse-mcp-api@latest\n ```\n2. **पोर्ट संघर्ष की जाँच करें** — MCP server डिफ़ॉल्ट रूप से पोर्ट 13100 का उपयोग करता है\n3. **npx कैश साफ़ करें**:\n ```bash\n npx clear-npx-cache\n # or\n rm -rf ~/.npm/_npx\n ```\n4. **नवीनतम में अपडेट करें**:\n ```bash\n npx -y synapse-mcp-api@latest --version\n ```\n\n## समस्या: टूल कॉल 429 लौटाते हैं\n\n### लक्षण\n\n- त्रुटि: \"Rate limit exceeded\"\n\n### समाधान\n\nयह MCP के साथ नहीं होना चाहिए (हेडर auth का उपयोग करता है, कोई रेट लिमिट नहीं)। यदि होता है:\n\n1. **जाँचें कि कहीं आप `?key=` का उपयोग तो नहीं कर रहे** — हेडर auth पर स्विच करें\n2. **`SYNAPSE_URL` सत्यापित करें** — सुनिश्चित करें कि यह सही इंस्टेंस की ओर इशारा करता है\n3. **सहायता से संपर्क करें** यदि समस्या बनी रहे\n\n## समस्या: टूल दिखाई देते हैं लेकिन काम नहीं करते\n\n### लक्षण\n\n- Client में टूल सूचीबद्ध हैं\n- टूल कॉल करने पर त्रुटि या कोई परिणाम नहीं\n\n### समाधान\n\n1. **टूल नाम जाँचें** — सटीक होना चाहिए (जैसे `memory_recall`, न कि `memory.recall`)\n2. **आर्ग्युमेंट सत्यापित करें** — टूल के इनपुट स्कीमा की जाँच करें\n3. **सीधे API के माध्यम से टेस्ट करें**:\n ```bash\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer mk_...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"category\":\"fact\",\"key\":\"test\",\"content\":\"hello\"}'\n ```\n4. **Synapse हेल्थ जाँचें**:\n ```bash\n curl https://synapse.schaefer.zone/health\n ```\n\n## सहायता प्राप्त करना\n\nयदि उपरोक्त में से कुछ भी आपकी समस्या हल नहीं करता:\n\n1. **मौजूदा issues जाँचें**: \n2. **नया issue खोलें** इनके साथ:\n - MCP server संस्करण (`npx -y synapse-mcp-api@latest --version`)\n - Client नाम और संस्करण\n - ऑपरेटिंग सिस्टम\n - संबंधित लॉग अंश\n - पुनः उत्पन्न करने के चरण\n\n## अगले कदम\n\n- [Claude Desktop Setup](/docs/mcp/claude-desktop)\n- [Claude Code Setup](/docs/mcp/claude-code)\n- [API Errors](/docs/api/errors)\n","content_html":"

MCP समस्या निवारण

\n

Synapse MCP को अपने LLM client के साथ एकीकृत करते समय सामान्य समस्याएँ और समाधान।

\n

त्वरित डायग्नोस्टिक चेकलिस्ट

\n
    \n
  1. ✅ Node.js 18+ इंस्टॉल है? (node --version)
    2. \n
  2. ✅ Mind Key mk_ से शुरू होती है? (JWT eyJ... नहीं)
    3. \n
  3. ✅ Synapse API पहुँच योग्य है? (curl https://synapse.schaefer.zone/health)
    4. \n
  4. ✅ Mind Key काम करती है? (curl -H "Authorization: Bearer mk_..." .../memory/recall)
    5. \n
  5. ✅ कॉन्फ़िग फ़ाइल वैध JSON है? (कोई ट्रेलिंग कॉमा नहीं, कोई टिप्पणी नहीं)
    6. \n
  6. ✅ कॉन्फ़िग परिवर्तन के बाद client पुनः आरंभ किया?
    7. \n
  7. ✅ MCP server मैन्युअली शुरू होता है? (npx -y synapse-mcp-api@latest)
    8. \n
\n

समस्या: Client में कोई टूल दिखाई नहीं देता

\n

लक्षण

\n
    \n
  • Claude Desktop / Cursor / Continue 0 टूल दिखाता है
    • \n
  • MCP servers सूची में कोई 🔌 आइकन या "synapse" एंट्री नहीं
    • \n
\n

समाधान

\n
    \n
  1. Client पूरी तरह पुनः आरंभ करें — macOS पर Cmd+Q (केवल विंडो बंद न करें)
    2. \n
  2. कॉन्फ़िग फ़ाइल स्थान जाँचें:
      \n
    • Claude Desktop macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • \n
    • Claude Desktop Windows: %APPDATA%\\Claude\\claude_desktop_config.json
      • \n
    • Cursor: ~/.cursor/config.json
      • \n
    • Continue: ~/.continue/config.json
      • \n
    \n
    3. \n
  3. JSON को मान्य करें — कॉन्फ़िग को https://jsonlint.com में पेस्ट करें
    4. \n
  4. MCP त्रुटियों के लिए client लॉग जाँचें:
      \n
    • Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)
      • \n
    • Cursor: View → Output → MCP
      • \n
    \n
    5. \n
  5. स्टार्टअप त्रुटियाँ देखने के लिए MCP server मैन्युअली चलाएँ:
    SYNAPSE_MIND_KEY=mk_... npx -y synapse-mcp-api@latest
    6. \n
\n

समस्या: "Mind Key invalid" त्रुटि

\n

लक्षण

\n
    \n
  • टूल दिखाई देते हैं लेकिन कॉल "401 Unauthorized" के साथ विफल होते हैं
    • \n
  • त्रुटि: "Mind Key fehlt oder ungültig"
    • \n
\n

समाधान

\n
    \n
  1. Mind Key प्रारूप सत्यापित करें — mk_ से शुरू, ~40 अक्षर
    2. \n
  2. सीधे टेस्ट करें:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    3. \n
  3. जाँचें कि env var सेट है — stdio ट्रांसपोर्ट के लिए, env var आपके शेल में नहीं, MCP server कॉन्फ़िग में होना चाहिए
    4. \n
  4. नई Mind Key प्राप्त करें:
    # Login to get JWT\ncurl -X POST .../login -d '{"email":"...","password":"..."}'\n# Create new mind\ncurl -X POST .../minds -H "Authorization: Bearer YOUR_JWT" -d '{"name":"new mind"}'
    5. \n
\n

समस्या: npx नहीं मिला

\n

लक्षण

\n
    \n
  • त्रुटि: "npx: command not found"
    • \n
  • MCP server शुरू होने में विफल
    • \n
\n

समाधान

\n
    \n
  1. Node.js 18+ इंस्टॉल करें:
      \n
    • macOS: brew install node या https://nodejs.org से डाउनलोड करें
      • \n
    • Linux: curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs
      • \n
    • Windows: https://nodejs.org से डाउनलोड करें
      • \n
    \n
    2. \n
  2. इंस्टॉल के बाद टर्मिनल पुनः आरंभ करें
    3. \n
  3. सत्यापित करें: node --version && npx --version
    4. \n
\n

समस्या: SYNAPSE_URL पहुँच योग्य नहीं

\n

लक्षण

\n
    \n
  • MCP server शुरू होता है लेकिन टूल कॉल टाइमआउट हो जाते हैं
    • \n
  • त्रुटि: "fetch failed" या "ECONNREFUSED"
    • \n
\n

समाधान

\n
    \n
  1. कनेक्टिविटी टेस्ट करें:
    curl https://synapse.schaefer.zone/health
    2. \n
  2. कॉर्पोरेट फ़ायरवॉल जाँचें — आउटबाउंड HTTPS को ब्लॉक कर सकता है
    3. \n
  3. वैकल्पिक URL आज़माएँ:
      \n
    • Production: https://synapse.schaefer.zone
      • \n
    • MCP server: https://synapse-mcp.schaefer.zone
      • \n
    \n
    4. \n
  4. सेल्फ-होस्टेड के लिए: सुनिश्चित करें कि आपका Synapse इंस्टेंस चल रहा है और पहुँच योग्य है
    5. \n
\n

समस्या: MCP Server क्रैश

\n

लक्षण

\n
    \n
  • MCP server शुरू होने के तुरंत बाद बाहर निकलता है
    • \n
  • Client लॉग "MCP server disconnected" दिखाते हैं
    • \n
\n

समाधान

\n
    \n
  1. त्रुटि देखने के लिए मैन्युअली चलाएँ:
    SYNAPSE_MIND_KEY=mk_... SYNAPSE_URL=https://synapse.schaefer.zone \\\n  npx -y synapse-mcp-api@latest
    2. \n
  2. पोर्ट संघर्ष की जाँच करें — MCP server डिफ़ॉल्ट रूप से पोर्ट 13100 का उपयोग करता है
    3. \n
  3. npx कैश साफ़ करें:
    npx clear-npx-cache\n# or\nrm -rf ~/.npm/_npx
    4. \n
  4. नवीनतम में अपडेट करें:
    npx -y synapse-mcp-api@latest --version
    5. \n
\n

समस्या: टूल कॉल 429 लौटाते हैं

\n

लक्षण

\n
    \n
  • त्रुटि: "Rate limit exceeded"
    • \n
\n

समाधान

\n

यह MCP के साथ नहीं होना चाहिए (हेडर auth का उपयोग करता है, कोई रेट लिमिट नहीं)। यदि होता है:

\n
    \n
  1. जाँचें कि कहीं आप ?key= का उपयोग तो नहीं कर रहे — हेडर auth पर स्विच करें
    2. \n
  2. SYNAPSE_URL सत्यापित करें — सुनिश्चित करें कि यह सही इंस्टेंस की ओर इशारा करता है
    3. \n
  3. सहायता से संपर्क करें यदि समस्या बनी रहे
    4. \n
\n

समस्या: टूल दिखाई देते हैं लेकिन काम नहीं करते

\n

लक्षण

\n
    \n
  • Client में टूल सूचीबद्ध हैं
    • \n
  • टूल कॉल करने पर त्रुटि या कोई परिणाम नहीं
    • \n
\n

समाधान

\n
    \n
  1. टूल नाम जाँचें — सटीक होना चाहिए (जैसे memory_recall, न कि memory.recall)
    2. \n
  2. आर्ग्युमेंट सत्यापित करें — टूल के इनपुट स्कीमा की जाँच करें
    3. \n
  3. सीधे API के माध्यम से टेस्ट करें:
    curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer mk_..." \\\n  -H "Content-Type: application/json" \\\n  -d '{"category":"fact","key":"test","content":"hello"}'
    4. \n
  4. Synapse हेल्थ जाँचें:
    curl https://synapse.schaefer.zone/health
    5. \n
\n

सहायता प्राप्त करना

\n

यदि उपरोक्त में से कुछ भी आपकी समस्या हल नहीं करता:

\n
    \n
  1. मौजूदा issues जाँचें: https://gitlab.com/schaefer-services/synapse-mcp/-/issues
    2. \n
  2. नया issue खोलें इनके साथ:
      \n
    • MCP server संस्करण (npx -y synapse-mcp-api@latest --version)
      • \n
    • Client नाम और संस्करण
      • \n
    • ऑपरेटिंग सिस्टम
      • \n
    • संबंधित लॉग अंश
      • \n
    • पुनः उत्पन्न करने के चरण
      • \n
    \n
    3. \n
\n

अगले कदम

\n\n","urls":{"html":"/docs/mcp/troubleshooting","text":"/docs/mcp/troubleshooting?format=text","json":"/docs/mcp/troubleshooting?format=json","llm":"/docs/mcp/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"]}