Claude Code MCP Config फ़ाइल की लोकेशन और सेटिंग्स की पूरी जानकारी

आप claude mcp add चलाते हैं, सर्वर कनेक्ट हो जाता है, और एक हफ़्ते बाद कोई टीममेट पूछता है कि वह सेटिंग आख़िर गई कहाँ। Claude Code MCP कॉन्फ़िगरेशन को एक साफ़-सुथरी फ़ाइल में नहीं रखता। वह इसे ~/.claude.json, प्रोजेक्ट-लेवल .mcp.json, कई settings.json फ़ाइलों में और कंपनी सेटअप में एक मैनेज्ड पॉलिसी फ़ाइल में बाँटता है। गलत फ़ाइल बदलें तो कुछ नहीं बदलता। सही फ़ाइल बदलें पर प्रेसिडेंस का क्रम न जानें, तो कोई दूसरी परिभाषा चुपचाप जीत जाती है।

यह लेख macOS, Windows और Linux पर हर लोकेशन का नक्शा बनाता है, दिखाता है कि दो फ़ाइलों में एक ही सर्वर का नाम हो तो कौन-सी परिभाषा जीतती है, और उन कमांड, एनवायरनमेंट वेरिएबल और टाइमआउट सेटिंग्स की सूची देता है जो रोज़ के काम में मायने रखती हैं। नीचे हर पाथ और फ़्लैग को Claude Code के मौजूदा डॉक्यूमेंटेशन से मिलाया गया है, इसलिए आप उन्हें जैसे हैं वैसे कॉपी कर सकते हैं।

फ़ाइलें असल में कहाँ रहती हैं

Claude Code में वे सर्वर जो आप खुद जोड़ते हैं, उनके लिए तीन स्कोप हैं, और उनके ऊपर एक ऑर्गनाइज़ेशन लेयर है। स्कोप तय करता है दो बातें: कौन-से प्रोजेक्ट में सर्वर लोड होगा, और परिभाषा रिपॉज़िटरी के साथ सफ़र करेगी या नहीं।

तीन स्कोप, तीन लोकेशन

Local scope डिफ़ॉल्ट है। --scope के बिना जोड़ा गया सर्वर सिर्फ़ उसी प्रोजेक्ट में लोड होता है जहाँ आपने कमांड चलाई थी, और वह आपके लिए निजी रहता है। Claude Code उसे उस प्रोजेक्ट के पाथ के अंतर्गत ~/.claude.json में लिखता है:

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

प्रॉम्प्ट कॉपी करें

Project scope प्रोजेक्ट रूट में .mcp.json फ़ाइल लिखता है। इसे कमिट करने के लिए बनाया गया है, ताकि टीम में हर किसी को एक जैसे टूल मिलें। User scope परिभाषा उसी ~/.claude.json फ़ाइल में रखता है, जो किसी भी प्रोजेक्ट पाथ के बाहर है, इसलिए आपके खोले गए हर प्रोजेक्ट में वह दिखती है।

💡 त्वरित नियम: निजी या प्रयोगात्मक सर्वर लोकल स्कोप में रहता है। टीम का साझा टूल प्रोजेक्ट स्कोप में रहता है। जो पर्सनल टूल आप हर रिपॉज़िटरी में चाहते हैं, वह यूज़र स्कोप में रहता है।

Windows, macOS और Linux पर पाथ

Windows पर ~ का मतलब है %USERPROFILE%, इसलिए यूज़र-लेवल फ़ाइल %USERPROFILE%\.claude.json है। .mcp.json फ़ाइल हर सिस्टम पर आपके प्रोजेक्ट रूट के सापेक्ष रहती है। सिर्फ़ मैनेज्ड फ़ाइल ऑपरेटिंग सिस्टम के हिसाब से बदलती है, क्योंकि वह एक सिस्टम-वाइड डायरेक्टरी में रहती है जिसे एडमिनिस्ट्रेटर नियंत्रित करता है।

अगर आप होम-डायरेक्टरी की फ़ाइलें कहीं और रखना चाहते हैं, तो CLAUDE_CONFIG_DIR सेट करें। फिर Claude Code आपकी सेटिंग्स, सेशन हिस्ट्री और प्लगइन वहीं स्टोर करता है, ~/.claude में नहीं।

लोकल स्कोप के नामकरण वाला जाल

शब्द "local" Claude Code में दो अलग चीज़ों के लिए इस्तेमाल होता है। MCP local scope आपकी होम डायरेक्टरी में ~/.claude.json में रहता है। सामान्य local settings प्रोजेक्ट के अंदर .claude/settings.local.json में रहती हैं। डिफ़ॉल्ट स्कोप से जोड़े गए MCP सर्वर को settings.local.json में खोजने पर कुछ नहीं मिलता, और यही एक गड़बड़ी "मेरा सर्वर कहाँ गया" वाले सवालों के बड़े हिस्से के लिए ज़िम्मेदार है।

💡 सर्वर परिभाषाएँ .mcp.json या ~/.claude.json में जाती हैं, और claude mcp कमांड उन्हें आपके लिए लिख देते हैं। settings.json फ़ाइलें अप्रूवल, एलाउलिस्ट और डिनायलिस्ट रखती हैं, जिन पर नीचे फिर बात होगी।

.mcp.json फ़ाइल के अंदर

जब आप --scope project से सर्वर जोड़ते हैं, तो Claude Code यह फ़ाइल अपने आप बनाता या अपडेट करता है। आप इसे हाथ से भी लिखकर कमिट कर सकते हैं। इसमें एक रैपर फ़ील्ड होता है, mcpServers, और हर सर्वर के लिए एक एंट्री।

एक काम करने वाला उदाहरण

{
  "mcpServers": {
    "docs-search": {
      "type": "http",
      "url": "https://example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SERVICE_TOKEN}"
      }
    },
    "local-files": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@example/files-server"],
      "env": {
        "ROOT_DIR": "${PROJECT_ROOT:-.}"
      },
      "timeout": 600000
    }
  }
}

प्रॉम्प्ट कॉपी करें

type फ़ील्ड http, sse, stdio और ws स्वीकार करता है। नाम streamable-http http के एलियास के रूप में काम करता है, यानी किसी सर्वर के अपने डॉक्यूमेंटेशन से कॉपी किया गया स्निपेट आम तौर पर बिना बदलाव के लोड हो जाता है। stdio एंट्री को command और वैकल्पिक रूप से args और env चाहिए। रिमोट एंट्री को url और वैकल्पिक रूप से headers चाहिए।

एक बात से लोग अक्सर अटकते हैं, जब वे Claude Desktop जैसे किसी दूसरे क्लाइंट से कॉन्फ़िग पेस्ट करते हैं। वही mcpServers रैपर .mcp.json के अंदर भी काम करता है, लेकिन claude mcp add-json को रैपर खुद नहीं, बल्कि रैपर के अंदर का ऑब्जेक्ट चाहिए।

सीक्रेट की जगह एनवायरनमेंट वेरिएबल

चूँकि .mcp.json कमिट होती है, इसलिए टोकन उसमें कभी नहीं जाने चाहिए। Claude Code वेरिएबल रेफ़रेंस के दो रूप एक्सपैंड करता है:

• ${VAR} VAR की वैल्यू में एक्सपैंड होता है।
• ${VAR:-default} सेट होने पर VAR में, और न होने पर default में एक्सपैंड होता है।

एक्सपैंशन command, args, env वैल्यू, url और headers वैल्यू में काम करता है। अगर कोई वेरिएबल सेट नहीं है और उसका डिफ़ॉल्ट भी नहीं है, तो फ़ाइल फिर भी लोड होती है। Claude Code उस सर्वर के लिए claude mcp list में missing-variable चेतावनी प्रिंट करता है और ${VAR} टेक्स्ट को जैसा है वैसा इस्तेमाल करता है, इसीलिए कोई सर्वर अपने हेडर में अजीब-सा लिटरल स्ट्रिंग लेकर फ़ेल हो सकता है।

एक सुरक्षा नियम भी है। रिमोट सर्वर के url और headers में क्रेडेंशियल वाले वेरिएबल, जैसे ANTHROPIC_AUTH_TOKEN और NPM_TOKEN, खाली पढ़े जाते हैं। इससे कोई क्लोन की गई रिपॉज़िटरी आपके Claude Code या क्लाउड क्रेडेंशियल उस सर्वर को नहीं भेज पाती जिसका वह नाम लेती है।

💡 असली टोकन अपनी शेल प्रोफ़ाइल या सीक्रेट मैनेजर में एक्सपोर्ट करें, और कमिट सिर्फ़ ${SERVICE_TOKEN} रेफ़रेंस करें।

टर्मिनल से सर्वर जोड़ना

आपको शायद ही कभी JSON खुद छूना पड़ता है। claude mcp add फ़ैमिली आपके चुने स्कोप की सही फ़ाइल में लिखती है, और यह उस टाइपो से बचने का सबसे सुरक्षित तरीका है जो ~/.claude.json तोड़ सकता है।

HTTP और stdio कमांड

# Remote HTTP server with a bearer token
claude mcp add --transport http docs-search https://example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server. The -- separates Claude's options from the server command
claude mcp add --transport stdio --env SERVICE_TOKEN=abc123 local-files -- npx -y @example/files-server

# Shared with the team and written to .mcp.json
claude mcp add --scope project --transport http docs-search https://example.com/mcp

प्रॉम्प्ट कॉपी करें

stdio सर्वर के लिए डबल डैश ज़रूरी है। उससे पहले का सब कुछ Claude Code का है, और उसके बाद का सब कुछ वह कमांड है जो सर्वर को चलाता है।

रिमोट सर्वर http या sse इस्तेमाल करते हैं, जबकि लोकल प्रोसेस stdio इस्तेमाल करती है। WebSocket सर्वर के लिए कोई अलग फ़्लैग नहीं है, इसलिए उन्हें JSON से जोड़ा जाता है:

claude mcp add-json events-server '{"type":"ws","url":"wss://example.com/events"}'

प्रॉम्प्ट कॉपी करें

OAuth इस्तेमाल करने वाले सर्वर --client-id, --client-secret और --callback-port लेते हैं, और claude mcp login <name> कमांड लाइन से साइन इन करता है।

जाँचें कि क्या कनेक्ट हुआ

तीन कमांड ज़्यादातर सवालों के जवाब देते हैं: claude mcp list हर सर्वर दिखाता है, claude mcp get <name> एक सर्वर दिखाता है, और claude mcp remove <name> एक सर्वर हटाता है। सेशन के भीतर /mcp वही व्यू खोलता है और आपको ऑथेंटिकेट करने देता है।

कौन-सी परिभाषा जीतती है

जब एक ही सर्वर एक से ज़्यादा जगह दिखता है, तो Claude Code उससे एक बार कनेक्ट करता है और सबसे ऊँची प्रेसिडेंस वाला सोर्स इस्तेमाल करता है।

प्रेसिडेंस, सबसे ऊपर पहले

1. managedMcpServers मैनेज्ड सेटिंग से आया सर्वर (Claude Code v2.1.259 या बाद का)
2. लोकल स्कोप
3. प्रोजेक्ट स्कोप
4. यूज़र स्कोप
5. प्लगइन द्वारा दिए गए सर्वर
6. claude.ai कनेक्टर

Claude Code तीनों स्कोप में डुप्लिकेट को नाम से मिलाता है। प्लगइन और कनेक्टर को वह एंडपॉइंट से मिलाता है, इसलिए ऊपर के किसी सक्रिय सर्वर जैसा ही URL या कमांड रखने वाला प्लगइन या कनेक्टर डुप्लिकेट गिना जाता है।

सबसे अहम बात यह है: जीतने वाले सोर्स की पूरी एंट्री इस्तेमाल होती है, और फ़ील्ड मर्ज नहीं होते। मान लीजिए docs-search यूज़र स्कोप में Authorization हेडर के साथ है और प्रोजेक्ट स्कोप में बिना उस हेडर के। प्रोजेक्ट वाली परिभाषा पूरी तरह जीतती है, और यूज़र वाली एंट्री का हेडर कभी दिखता ही नहीं।

शेयर्ड सर्वर के लिए अप्रूवल प्रॉम्प्ट

सुरक्षा कारणों से, इंटरैक्टिव सेशन में Claude Code .mcp.json से आए प्रोजेक्ट-स्कोप सर्वर को इस्तेमाल करने से पहले अप्रूवल माँगता है। तीन सेटिंग्स नतीजा तय करती हैं:

{
  "enabledMcpjsonServers": ["docs-search"],
  "disabledMcpjsonServers": ["local-files"]
}

प्रॉम्प्ट कॉपी करें

कोई चुनाव गलत हो गया? claude mcp reset-project-choices अप्रूवल हटा देता है।

v2.1.196 से, क्लोन की गई रिपॉज़िटरी अपने सर्वरों को खुद अप्रूव नहीं कर सकती। प्रोजेक्ट की .claude/settings.json में कमिट किए गए अप्रूवल उस फ़ोल्डर में नज़रअंदाज़ होते हैं जिस पर आपने भरोसा नहीं किया, और सर्वर ⏸ Pending approval पर ही रहता है। आपकी यूज़र सेटिंग्स फ़ाइल ~/.claude/settings.json, मैनेज्ड सेटिंग्स और --settings के अप्रूवल अब भी लागू होते हैं। एक अनट्रैक्ड .claude/settings.local.json भी काम करती है, फ़ोल्डर पर भरोसा होने के बाद।

नॉन-इंटरैक्टिव रन, जैसे claude -p, बिना पूछे प्रोजेक्ट सर्वर लोड करते हैं, जब तक आप उन्हें --strict-mcp-config के साथ शुरू न करें। वह फ़्लैग Claude Code को बताता है कि सिर्फ़ --mcp-config से पास किए गए सर्वर इस्तेमाल करे।

💡 पुल रिक्वेस्ट में .mcp.json की समीक्षा वैसे ही करें जैसे किसी स्क्रिप्ट की करते। stdio एंट्री हर टीममेट की मशीन पर एक कमांड चलाती है।

सेटिंग्स फ़ाइलें और पॉलिसी कंट्रोल

सेटिंग्स फ़ाइलें, सबसे ऊँची प्राथमिकता पहले

ऊँचे स्तर की सेटिंग उसी सेटिंग को नीचे वाले स्तर पर ओवरराइड करती है। ~/.claude.json एक अलग फ़ाइल है जिसे Claude Code अपने लिए लिखता है। इसमें आपका साइन-इन सेशन, आपकी MCP सर्वर कॉन्फ़िगरेशन, ट्रस्ट डिसीज़न जैसी प्रति-प्रोजेक्ट स्थिति, और वे ग्लोबल विकल्प रहते हैं जिन्हें /config बदलता है। आपको इसे हाथ से एडिट करने की ज़रूरत नहीं है।

एलाउलिस्ट और मैनेज्ड सर्वर

जिन टीमों को नियंत्रण चाहिए, उनके पास चार टूल हैं, यहाँ सबसे हल्के से सबसे सख़्त क्रम में:

• disabledMcpServers किसी यूज़र को विशिष्ट यूज़र, प्लगइन, मैनेज्ड या claude.ai सर्वरों से opt out करने देता है।
• allowedMcpServers और deniedMcpServers सर्वर के नाम या serverUrl पैटर्न से फ़िल्टर करते हैं।
• managedMcpServers एक मैनेज्ड सेटिंग है, जो यूज़र द्वारा जोड़े गए सर्वरों के साथ-साथ सभी को सर्वर उपलब्ध कराती है।
• managed-mcp.json पहले दिखाए गए सिस्टम पाथ से सर्वरों का एक तय सेट डिप्लॉय करता है।

managed-mcp.json डिप्लॉय करने का एक साइड इफ़ेक्ट जानने लायक है। डिफ़ॉल्ट रूप से यह उन claude.ai कनेक्टर्स को दबा देता है जिन्हें Claude Code खुद फ़ेच करता है। उन्हें अपने मैनेज्ड सर्वरों के साथ लोड करने के लिए, किसी मैनेज्ड सेटिंग सोर्स में "allowAllClaudeAiMcps": true सेट करें। ENABLE_CLAUDEAI_MCP_SERVERS=false एनवायरनमेंट वेरिएबल सेट करने से कनेक्टर एक ही मशीन के लिए बंद हो जाते हैं।

टाइमआउट और आउटपुट लिमिट

स्टार्टअप और टूल टाइमआउट

दो टाइमर मायने रखते हैं, और इन्हें आसानी से एक-दूसरे से मिलाया जा सकता है।

प्रति-सर्वर timeout उस सर्वर के लिए MCP_TOOL_TIMEOUT एनवायरनमेंट वेरिएबल को ओवरराइड करता है, सिर्फ़ उसी सर्वर पर। 1000 से कम वैल्यू नज़रअंदाज़ होती हैं और MCP_TOOL_TIMEOUT पर चली जाती हैं। जब यह वेरिएबल सेट न हो, तो डिफ़ॉल्ट लगभग 28 घंटे होता है। सर्वर से आने वाली प्रोग्रेस नोटिफ़िकेशन लिमिट को नहीं बढ़ातीं।

बड़ा टूल आउटपुट

जब भी कोई MCP टूल 10,000 टोकन से ज़्यादा लौटाता है, Claude Code चेतावनी देता है, और डिफ़ॉल्ट रूप से आउटपुट 25,000 टोकन पर सीमित होता है। यह सीमा MAX_MCP_OUTPUT_TOKENS=50000 claude से बढ़ाएँ, या किसी सेटिंग्स फ़ाइल के env फ़ील्ड से इसे स्थायी करें:

{
  "env": {
    "MCP_TIMEOUT": "10000",
    "MAX_MCP_OUTPUT_TOKENS": "50000"
  }
}

प्रॉम्प्ट कॉपी करें

टूटी कॉन्फ़िग को जल्दी ठीक करना

लक्षण और समाधान

अगर ~/.claude.json कभी पार्स होने में फ़ेल हो, तो Claude Code टूटी फ़ाइल को ~/.claude/backups/.claude.json.corrupted.<timestamp> में कॉपी कर देता है और पूछता है कि बाहर निकलकर उसे हाथ से ठीक करना है या डिफ़ॉल्ट कॉन्फ़िगरेशन पर रीसेट करना है। अपनी पिछली स्थिति वापस लाने के लिए, ~/.claude/backups/ से पाँच सबसे हालिया .claude.json.backup.<timestamp> फ़ाइलों में से कोई एक उसकी जगह पर कॉपी करें।

💡 ~/.claude.json को हाथ से एडिट करना शायद ही कभी जोखिम के लायक होता है। claude mcp add, add-json और remove को प्राथमिकता दें, और किसी भी मैन्युअल बदलाव से पहले फ़ाइल की एक कॉपी रखें।

Picasso IA के साथ अपने विज़ुअल बनाएँ

कॉन्फ़िग का काम उसी पल खत्म हो जाता है जब कोई सर्वर ✔ Connected दिखाता है, लेकिन उसे डॉक्यूमेंट करने में उससे ज़्यादा समय लगता है। README के स्क्रीनशॉट, ऑनबोर्डिंग डायग्राम और टर्मिनल सेशन की छोटी क्लिप टीम को धीमा कर देते हैं। यहीं Picasso IA मदद करता है, जिसमें टेक्स्ट, इमेज और वीडियो मॉडल एक ही जगह मौजूद हैं।

PicassoIA पर Claude Sonnet 5 इस्तेमाल करें

Claude Sonnet 5 एक लैंग्वेज मॉडल है जो कोडिंग और टूल-यूज़ के कामों के लिए बना है, इसलिए कॉन्फ़िग एंट्री का ड्राफ़्ट बनाने या कमिट से पहले उसकी समीक्षा करने में काम आता है। मॉडल पेज ये इनपुट दिखाता है:

1. मॉडल पेज खोलें और अपना अनुरोध Prompt में पेस्ट करें। उदाहरण के लिए: "इस claude mcp add कमांड को एक .mcp.json एंट्री में बदलें, जिसका Authorization हेडर एक एनवायरनमेंट वेरिएबल से पढ़ा जाए।"
2. Effort सेट करें। डिफ़ॉल्ट low है, जो सबसे तेज़ और सस्ते जवाब के लिए थिंकिंग बंद रखता है। जब कोई बग कई फ़ाइलों में फैला हो, तब high या max चुनें।
3. System Prompt जोड़ें, जैसे "सिर्फ़ वैध JSON में जवाब दें, कोई टिप्पणी नहीं", और उसे पूरे सेशन में दोबारा इस्तेमाल करें।
4. Max Tokens को छोड़ दें, जब तक आउटपुट लंबा न हो। डिफ़ॉल्ट 8,192 है।
5. किसी एरर का स्क्रीनशॉट हो तो इमेज अटैच करें। मॉडल उसे संदर्भ के रूप में पढ़ता है।
6. चलाएँ, फिर जाँचें। नतीजा .mcp.json में पेस्ट करें और यह पुष्टि करने के लिए claude mcp get <name> चलाएँ कि सर्वर कनेक्ट हुआ।

💡 जेनरेट किए गए कॉन्फ़िग को ड्राफ़्ट मानें। पाथ, फ़्लैग और सेटिंग्स हर रिलीज़ में बदलते हैं, इसलिए हर एक को आधिकारिक डॉक्यूमेंटेशन से मिलाएँ।

विज़ुअल वाले हिस्से के लिए, PicassoIA Image और Seedream 5 Pro जैसे टेक्स्ट-टू-इमेज मॉडल किसी डॉक्स पेज या चेंजलॉग पोस्ट के लिए हेडर आर्ट बना सकते हैं। आपके पास मौजूद किसी तस्वीर को बदलने के लिए, PicassoIA Image Editor Pro खोलें। मूवमेंट के लिए, PicassoIA Video और Seedance 2.5 Lite एक प्रॉम्प्ट या स्थिर इमेज को छोटी क्लिप में बदल देते हैं।

PicassoIA अपने इमेज और वीडियो मॉडल के लिए MCP कनेक्शन भी देता है, जिन्हें आप picassoia.com/en/mcp/accounts पर अपने अकाउंट से मैनेज करते हैं। कनेक्शन की जानकारी मिल जाने के बाद, एक HTTP सर्वर ऊपर दिखाए गए उसी claude mcp add --transport http पैटर्न से जुड़ जाता है।

एक मॉडल चुनें, प्रॉम्प्ट लिखें, और अपने अगले README के लिए पहली हेडर इमेज या क्लिप जेनरेट करें। कुछ वैरिएशन आज़माएँ, उन्हें बगल-बगल रखकर तुलना करें, और जो फ़िट बैठे उसे रखें। सब कुछ picassoia.com/en/all-models पर उपलब्ध है।