Claude Desktop MCP कॉन्फ़िग: फ़ाइल लोकेशन, JSON उदाहरण और सेटअप
Windows और macOS पर claude_desktop_config.json ढूँढें, MSIX पाथ वाले जाल से बचें, एक काम करने वाला mcpServers उदाहरण चिपकाएँ, ऐप को सही तरीके से रीस्टार्ट करें और जब कोई सर्वर लोड होने से मना करे तो MCP लॉग पढ़ें। इसमें PicassoIA पर Claude मॉडल की मदद से अपने JSON को डीबग करने का ट्यूटोरियल भी शामिल है।
आपने JSON बदला, ऐप रीस्टार्ट किया, और कुछ नहीं हुआ। न हैमर आइकन, न नए टूल, न कोई एरर मैसेज। Claude Desktop MCP कॉन्फ़िग के साथ यही चुपचाप होने वाली विफलता सबसे आम कहानी है, और इसकी जड़ लगभग हमेशा तीन कारणों में से एक होती है: आपने गलत फ़ाइल बदली, JSON में छोटी सी सिंटैक्स गलती है, या ऐप को पूरी तरह रीस्टार्ट नहीं किया गया। यह लेख तीनों को उसी क्रम में समझाता है जिस क्रम में आप इनसे टकराएँगे।
आपको Windows और macOS पर claude_desktop_config.json की सटीक लोकेशन मिलेगी (इसमें Windows का MSIX जाल भी शामिल है, जो आपके बदलाव ऐसी फ़ाइल में भेज देता है जिसे कोई नहीं पढ़ता), एक काम करने वाला JSON उदाहरण जो आप आज ही चिपका सकते हैं, यह पक्का करने का तरीका कि कोई सर्वर सच में कनेक्ट हुआ या नहीं, और MCP लॉग पर आधारित एक छोटी ट्रबलशूटिंग दिनचर्या। लेख के आख़िर में Claude Sonnet 5 का इस्तेमाल करके अपने कॉन्फ़िग को डीबग करने का ट्यूटोरियल है, साथ ही प्लंबिंग काम करने के बाद इमेज और वीडियो जनरेटर जोड़ने की एक झलक भी।
💡 छोटा सार: फ़ाइल claude_desktop_config.json पर है, इसे एक टॉप-लेवल mcpServers ऑब्जेक्ट चाहिए, उसके अंदर हर पाथ एब्सोल्यूट होना चाहिए, और हर बदलाव के बाद ऐप को पूरी तरह बंद करके फिर से खोलना होगा।
कॉन्फ़िग फ़ाइल कहाँ रहती है
Claude Desktop लॉन्च के समय एक JSON फ़ाइल पढ़ता है, ताकि पता चले कि उसे कौन से MCP सर्वर (Model Context Protocol servers) शुरू करने हैं। यह फ़ाइल तब तक मौजूद नहीं होती जब तक आप इसे सेटिंग्स स्क्रीन से न खोलें या हाथ से न बनाएँ, इसलिए नई इंस्टॉल की गई ऐप को अभी कुछ नहीं मिलेगा। इसकी लोकेशन आपके ऑपरेटिंग सिस्टम पर निर्भर करती है, और Windows पर इस बात पर भी कि आपने ऐप कैसे इंस्टॉल किया।
Windows पाथ और MSIX जाल
एक सामान्य Windows इंस्टॉल पर फ़ाइल यहाँ रहती है:
%APPDATA%\Claude\claude_desktop_config.json
पूरा रूप C:\Users\<your name>\AppData\Roaming\Claude\claude_desktop_config.json है। Win+R दबाएँ, पहला रूप चिपकाएँ और सही फ़ोल्डर खोलने के लिए Enter दबाएँ।
यही वह जाल है। जब Claude Desktop MSIX पैकेज के रूप में इंस्टॉल होता है (Microsoft Store और कुछ WinGet इंस्टॉल इसी तरह काम करते हैं), तो Windows उस ऐप के लिए AppData फ़ोल्डर को वर्चुअलाइज़ कर देता है। कई सार्वजनिक बग रिपोर्ट एक ही नतीजा बताती हैं: Edit Config बटन सामान्य %APPDATA% फ़ाइल खोलता है, जबकि ऐप खुद पैकेज फ़ोल्डर के अंदर दबी एक कॉपी पढ़ता है:
अगर यह True प्रिंट करता है, तो अपना mcpServers ब्लॉक पैकेज वाले पाथ में डालें, रीस्टार्ट करें और देखें कि सर्वर दिखता है या नहीं। पैकेज फ़ोल्डर के नाम रिलीज़ के साथ बदल सकते हैं, इसलिए ऊपर के पाथ को शुरुआती बिंदु मानें। अगर वह मेल न खाए, तो %LOCALAPPDATA%\Packages के अंदर ऐसा फ़ोल्डर खोजें जिसका नाम Claude_ से शुरू होता हो।
macOS पाथ और Linux नोट्स
Mac पर फ़ाइल Library फ़ोल्डर के अंदर रहती है, जिसे Finder डिफ़ॉल्ट रूप से छिपा देता है:
Finder में Go, फिर Go to Folder चुनें और ~/Library/Application Support/Claude चिपकाएँ। Terminal से open ~/Library/Application\ Support/Claude वही काम करता है।
Claude Desktop का कोई आधिकारिक Linux बिल्ड नहीं है। कम्युनिटी बिल्ड आम तौर पर XDG परंपरा का पालन करते हैं और ~/.config/Claude/claude_desktop_config.json पढ़ते हैं, लेकिन उस पाथ पर भरोसा करने से पहले आप जो बिल्ड इस्तेमाल करते हैं उसके नोट्स ज़रूर देखें।
सेटिंग्स से खोलें
सबसे कम गलती वाला रास्ता ऐप खुद है:
सिस्टम मेन्यू बार में Claude मेन्यू पर क्लिक करें (चैट विंडो के अंदर की सेटिंग्स पर नहीं)।
Settings चुनें।
बाएँ साइडबार में Developer टैब खोलें।
Edit Config पर क्लिक करें।
फ़ाइल न हो तो यह उसे बना देता है और आपकी फ़ाइल मैनेजर में दिखा देता है। Windows MSIX इंस्टॉल पर इस पर भरोसा करने से पहले खुले फ़ोल्डर की तुलना ऊपर दिए पैकेज वाले पाथ से ज़रूर करें।
पूरी फ़ाइल एक JSON ऑब्जेक्ट है। Claude Desktop एक टॉप-लेवल प्रॉपर्टी ढूँढता है जिसका नाम mcpServers है। उसके अंदर हर प्रॉपर्टी एक सर्वर है, और प्रॉपर्टी का नाम वही लेबल है जो आप ऐप में देखते हैं। हर एंट्री आपके कंप्यूटर पर एक प्रोग्राम शुरू करने की छोटी रेसिपी है, और Claude उस प्रोग्राम से standard input और output के ज़रिए बात करता है।
फ़ील्ड
ज़रूरी है
क्या करता है
command
हाँ
लॉन्च होने वाली एक्ज़िक्यूटेबल, जैसे npx या node
args
आम तौर पर
आर्गुमेंट्स का एक array, हर आइटम एक string
env
नहीं
उस प्रोसेस को दिए गए environment variables
सही command इस पर निर्भर करता है कि सर्वर कैसे लिखा गया है। npm पर प्रकाशित Node.js सर्वर npx से शुरू होते हैं। जो सर्वर आपने खुद बनाए या क्लोन किए हैं, वे node से शुरू होते हैं, उसके बाद कम्पाइल की गई फ़ाइल का पाथ आता है। Python सर्वर आम तौर पर uvx के ज़रिए लॉन्च होते हैं, जिसके लिए uv टूल इंस्टॉल होना चाहिए। हर हाल में नियम एक ही है: command के रूप में आप जो भी लिखें, वह टर्मिनल में टाइप करने पर काम करना चाहिए, क्योंकि Claude Desktop ठीक यही आपकी ओर से करता है।
अगर Claude Desktop ने फ़ाइल में पहले से दूसरी टॉप-लेवल एंट्री जोड़ी हुई है (नए बिल्ड वहाँ कुछ प्राथमिकताएँ रख सकते हैं), तो उन्हें छोड़ दें और mcpServers को उनके बगल में जोड़ें। चिपकाए गए स्निपेट से पूरी फ़ाइल बदल देने से ही लोग वे सेटिंग्स खो देते हैं।
macOS और Windows के उदाहरण
Mac पर आधिकारिक फ़ाइलसिस्टम सर्वर का उदाहरण यह है। username को अपने असली अकाउंट नाम से बदलें:
यहाँ तीन विवरण ज़्यादातर काम करते हैं। -y फ़्लैग npx को सर्वर पैकेज बिना ऐसा सवाल पूछे इंस्टॉल करने देता है जिसका जवाब देने वाला कोई नहीं होता। पैकेज नाम के बाद के फ़ोल्डर ही वे एकमात्र जगहें हैं जिन्हें सर्वर छू सकता है। और ये सारे पाथ एब्सोल्यूट हैं, क्योंकि रिलेटिव पाथ सर्वर के कभी शुरू न होने का एक क्लासिक कारण हैं।
आपको Node.js भी चाहिए, क्योंकि npx उसी के साथ आता है। टर्मिनल में node --version चलाएँ; अगर वह वर्ज़न नंबर प्रिंट करे, तो आप तैयार हैं, और LTS रिलीज़ सुरक्षित चुनाव है।
💡 टिप:mcpServers में लेबल इंसानों के लिए चुनें, मशीन के लिए नहीं। filesystem, notes या weather सभी ठीक हैं, और यह नाम सिर्फ़ मेन्यू में और लॉग फ़ाइल के नाम में दिखता है।
सर्वर और सीक्रेट्स सुरक्षित तरीके से जोड़ें
सीक्रेट्स के लिए Environment Variables
असली सर्वरों को अक्सर कोई क्रेडेंशियल चाहिए होता है। उसे उस सर्वर के env ऑब्जेक्ट में रखें, args में कभी नहीं, क्योंकि वहाँ वह process lists में दिख जाएगा। यह उदाहरण दो सर्वर साथ-साथ चलाता है:
दोनों सर्वर ब्लॉक के बीच का कॉमा ध्यान दें, और आख़िरी ब्लॉक के बाद कॉमा न होना भी। ये दो जगहें बाकी किसी भी चीज़ से ज़्यादा टूटी फ़ाइलें बनाती हैं।
कॉन्फ़िग फ़ाइल सादा टेक्स्ट है, इसलिए इसे पासवर्ड फ़ाइल की तरह समझें। इसे किसी सार्वजनिक रिपॉज़िटरी में कमिट न करें, न किसी चैट में या ऐसे स्क्रीनशॉट में चिपकाएँ जिसमें टोकन दिख रहा हो, और फ़ोल्डर एक्सेस को सीमित रखें। सर्वर आपके यूज़र अकाउंट की अनुमतियों के साथ चलता है, यानी वह वह सब कर सकता है जो आप हाथ से कर सकते हैं। फ़ाइलसिस्टम सर्वर को पूरी होम डायरेक्टरी पर नहीं, बल्कि एक प्रोजेक्ट फ़ोल्डर पर रखें।
रिमोट सर्वर के लिए इसकी जगह Connectors
JSON फ़ाइल लोकल प्रोसेस लॉन्च करती है। होस्टेड, रिमोट MCP सर्वर अलग चीज़ है: वह कहीं और पहले से चल रहा होता है और आप उस तक URL से पहुँचते हैं। Claude Desktop चाहता है कि ऐसे सर्वर Settings, फिर Connectors से जोड़े जाएँ, न कि claude_desktop_config.json में एंट्री के रूप में। command में URL चिपकाना उन चुपचाप होने वाली तरीकों में से एक है जिनसे कोई सर्वर कभी लोड नहीं होता।
लोकल सर्वर
रिमोट सर्वर
कहाँ चलता है
आपके कंप्यूटर पर
होस्टेड मशीन पर
कैसे जोड़ें
JSON फ़ाइल में mcpServers
Settings, फिर Connectors
Node.js चाहिए
अक्सर
नहीं
आम विफलता
गलत पाथ या खराब JSON
साइन-इन या अनुमति की समस्या
रीस्टार्ट करें और पक्का करें कि काम करता है
पूरी तरह बंद करें, फिर खोलें
Claude Desktop कॉन्फ़िग को लॉन्च के समय सिर्फ़ एक बार पढ़ता है। फ़ाइल सेव करने भर से कुछ नहीं होता। विंडो बंद करना भी काफ़ी नहीं है, क्योंकि ऐप बैकग्राउंड में चलता रह सकता है। macOS पर Cmd+Q दबाएँ या Claude, फिर Quit चुनें। Windows पर अगर ऐप टास्क ट्रे में अटका हो तो वहीं के आइकन से बंद करें। फिर उसे दोबारा खोलें।
छोटे कदमों में काम करें। एक सर्वर जोड़ें, रीस्टार्ट करें, पक्का करें, फिर अगला जोड़ें। जब आप एक साथ पाँच सर्वर चिपकाते हैं और फ़ाइल लोड होने से मना कर देती है, तब आपके पास यह जानने का कोई तरीका नहीं होता कि कौन सा ब्लॉक उसे तोड़ गया।
Connectors मेन्यू जाँचें
ऐप वापस आने पर चैट इनपुट बॉक्स देखें और Add files, connectors, and more बटन पर क्लिक करें। Connectors पर होवर करें, Manage connectors पर क्लिक करें और सूची से अपना सर्वर चुनें। काम करने वाला सर्वर वे टूल दिखाता है जो वह देता है। उदाहरण के लिए फ़ाइलसिस्टम सर्वर फ़ाइलें पढ़ने, लिखने, उन्हें ले जाने और खोजने के टूल दिखाता है।
फिर "List the files in my Downloads folder." जैसे प्रॉम्प्ट से एक असली टेस्ट चलाएँ। Claude किसी टूल को कॉल करने से पहले अनुमति माँगता है। कॉल को मंज़ूरी दें, और जवाब में असली फ़ाइल नाम आने चाहिए। अगर वह कहे कि उसके पास आपकी फ़ाइलों तक पहुँच नहीं है, तो सर्वर कनेक्ट नहीं हुआ।
लोड होने से रोकने वाली गलतियाँ ठीक करें
JSON सिंटैक्स की गड़बड़ी
एक गलत जगह पर लगा कैरेक्टर पूरी फ़ाइल को लोड होने से रोक देता है। ये सबसे आम गलतियाँ हैं:
आख़िरी प्रॉपर्टी या array आइटम के बाद ट्रेलिंग कॉमा।
कमेंट। JSON में कमेंट नहीं होते, इसलिए // लाइनें गलती हैं।
वेब पेज या वर्ड प्रोसेसर से चिपकाए गए स्मार्ट कोट्स, सामान्य सीधे कोट्स की जगह।
Windows पाथ में अकेला बैकस्लैश।
सर्वर ब्लॉक हटाने के बाद छूटा हुआ ब्रेस या ब्रैकेट।
यह स्निपेट कुछ लाइनों में इनमें से तीन गलतियाँ भर देता है। क्या आप इन्हें पहचान सकते हैं?
पाथ में अकेले बैकस्लैश हैं, array बंद होने वाले ब्रैकेट से पहले कॉमा के साथ खत्म होता है, और args लाइन बंद होने वाले ब्रेस से पहले कॉमा के साथ खत्म होती है। तीनों ठीक कर दें तो फ़ाइल पार्स हो जाती है।
रीस्टार्ट से पहले फ़ाइल को वैलिडेट करें। कोई भी JSON लिंटर काम करता है, या आप Node.js इस्तेमाल कर सकते हैं, जो आपके पास पहले से है:
अगर यह valid प्रिंट करे, तो सिंटैक्स ठीक है और समस्या कहीं और है।
Command Not Found की समस्याएँ
जब JSON वैध हो फिर भी सर्वर विफल हो, तो दोषी आम तौर पर command होता है। डेस्कटॉप ऐप आपकी shell profile नहीं पढ़ता, इसलिए version manager से इंस्टॉल किया गया Node.js उसके लिए अदृश्य हो सकता है। टर्मिनल में which npx चलाएँ और command फ़ील्ड में npx की जगह पूरा पाथ डालें।
पहले कमांड को हाथ से चलाकर देखें कि क्या वह ऐप के बाहर काम करता है:
Windows पर अगर लॉग में किसी पाथ के अंदर ${APPDATA} से जुड़ी गलती है, तो उस सर्वर के %APPDATA% ब्लॉक में env का विस्तारित मान जोड़ें, जैसे "APPDATA": "C:\\Users\\username\\AppData\\Roaming\\"। यह भी जाँचें कि %APPDATA%\npm मौजूद है। अगर नहीं है, तो npm install -g npm से npm ग्लोबली इंस्टॉल करें, फिर ऐप रीस्टार्ट करें।
MCP लॉग पढ़ें
लॉग बताते हैं कि ऐप ने क्या देखा। ऊपर की टेबल से लॉग फ़ोल्डर खोलें और दो तरह की फ़ाइलें देखें। mcp.log कनेक्शन और विफलताओं के बारे में आम संदेश रखती है। mcp-server-NAME.log नाम की फ़ाइलों में हर सर्वर का stderr आउटपुट होता है, और असली एरर मैसेज अक्सर वहीं होता है। Mac पर आप इन्हें लाइव देख सकते हैं:
रीस्टार्ट के बाद भी न बदलने वाला लॉग अपने आप में एक सुराग है: ऐप शायद उस कॉन्फ़िग फ़ाइल के बजाय कोई दूसरी फ़ाइल पढ़ रहा है जिसे आपने बदला था, और यही आपको MSIX पाथ तक वापस ले आता है।
गलत जगह पर लगा कॉमा पकड़ने का सबसे तेज़ तरीका किसी और की नज़र डालना है। PicassoIA पर Claude Sonnet 5 एक टेक्स्ट मॉडल है जो चिपकाए गए JSON, स्टैक ट्रेस और यहाँ तक कि एरर के स्क्रीनशॉट भी पढ़ता है, इसलिए यह कॉन्फ़िग रिव्यूअर के रूप में अच्छा काम करता है।
मॉडल पेज खोलें
Large Language Models कलेक्शन में Claude Sonnet 5 पेज पर जाएँ और प्रॉम्प्ट बॉक्स खोलें। मॉडल के लिए एक ब्राउज़र टैब और अपने एडिटर के लिए एक टैब रखें, ताकि आप आगे-पीछे चिपका सकें।
Effort और आउटपुट की लंबाई सेट करें
मॉडल कुछ सेटिंग्स देता है, और उनमें से कुछ यहाँ मायने रखती हैं:
effort: डिफ़ॉल्ट low है, जो सबसे तेज़ जवाब के लिए थिंकिंग बंद रखता है। सिंटैक्स जाँच के लिए यह काफ़ी है। जब आपको कई सर्वरों के पाथ पर रीज़निंग चाहिए हो, तब medium या high पर जाएँ।
max_tokens: 8,192 का डिफ़ॉल्ट एक पूरी सुधारी हुई फ़ाइल के लिए काफ़ी है।
system_prompt: इसे एक बार सेट करें, जैसे "You review claude_desktop_config.json files. Name the exact line that is wrong, then return the corrected file."
image: एरर का स्क्रीनशॉट अटैच करें। अगर लॉग का टेक्स्ट छोटा हो तो max_image_resolution को उसके 0.5 megapixel डिफ़ॉल्ट से ऊपर बढ़ाएँ।
हाँ-या-ना वाली तेज़ जाँचों के लिए Claude 4.5 Haiku तेज़ जवाब देता है। किसी ज़िद्दी, कई-फ़ाइल वाली पहेली के लिए Claude Opus 4.7 भारी विकल्प है।
कॉन्फ़िग चिपकाएँ और पूछें
पहले हर टोकन को प्लेसहोल्डर से बदलें। फिर फ़ाइल चिपकाएँ और कुछ साफ़-साफ़ पूछें:
This claude_desktop_config.json is on Windows. The filesystem server never
appears in Claude Desktop. Check the JSON syntax, check the path escaping,
and tell me which line to fix first.
जवाब को बिना सोचे वापस चिपकाने के बजाय अपनी फ़ाइल से लाइन-दर-लाइन मिलाएँ, और नतीजे पर पहले बताया गया Node.js वैलिडेटर चलाएँ।
इमेज और वीडियो टूल्स जोड़ें
आपका सेटअप काम करने लगे, तो दिलचस्प हिस्सा शुरू होता है: Claude को ऐसे टूल देना जो चीज़ें बनाते हैं। PicassoIA एक डेवलपर API और एक MCP कनेक्शन देता है, जो इस लेख के लिखे जाने के समय चार मॉडल तक सीमित हैं:
PicassoIA के MCP कनेक्शन लॉग इन करने के बाद picassoia.com पर आपके अकाउंट पेज से बनाए जाते हैं। ये होस्टेड हैं, इसलिए पहले बताया गया connector का रास्ता लागू होता है: इन्हें Settings, फिर Connectors से जोड़ें, न कि mcpServers एंट्री के रूप में। जॉब एसिंक्रोनस चलते हैं। एक अनुरोध prediction शुरू करता है, और परिणाम पूरा होने पर लाया जाता है। हर अकाउंट एक साथ 5 predictions चला सकता है, और यह सीमा आपके हर MCP कनेक्शन में साझा है, इसलिए Claude से आया बैच अनुरोध खुद अपने पीछे कतार में लग सकता है।
💡 टिप: पहले एक इमेज माँगें, नतीजा जाँचें, फिर बढ़ाएँ। एक 16:9 फ़ोटो प्रॉम्प्ट यह दस-इमेज बैच से जल्दी बता देता है कि कनेक्शन और अनुमतियाँ सही हैं या नहीं।
एक अच्छा पहला अनुरोध ठोस होता है: "Create a 16:9 photo of a ceramic mug on an oak desk in soft morning light, using PicassoIA Image." Claude टूल चुनता है, जॉब पूरा होने का इंतज़ार करता है और आपको लिंक देता है। अगर वह हर बार अनुमति माँगे, तो यह वही मंज़ूरी का कदम है जो आपने फ़ाइलसिस्टम सर्वर के साथ देखा था, और यह ठीक से काम कर रहा है।
अगले कदम में अपनी इमेज बनाएँ
आपकी कॉन्फ़िग फ़ाइल अब वही करती है जो उसे करना चाहिए: यह सही जगह की ओर इशारा करती है, साफ़ तरह से पार्स होती है, अपने सर्वर शुरू करती है और यह लॉग करती है कि क्या गड़बड़ हुई। AI टूल्स के साथ काम करने का यह उबाऊ हिस्सा है, और इसे आपको सिर्फ़ एक बार करना होता है।
मज़ेदार हिस्सा बनाने का है। PicassoIA Image खोलें और किसी ऐसी चीज़ के बारे में एक प्रॉम्प्ट लिखें जो आपके लिए मायने रखती हो, कोई जानी-पहचानी गली या कोई उत्पाद जो आप बेचते हैं। PicassoIA Image Editor Pro से उसे दोबारा तैयार करें, फिर सबसे अच्छे नतीजे को PicassoIA Video से एनिमेट करें। हर मॉडल picassoia.com/en/all-models पर देखें, कोई ऐसा मॉडल चुनें जो आपने अभी तक आज़माया नहीं है, और आज ही अपनी पहली इमेज बनाएँ।