Claude Code में MCP सर्वर कैसे जोड़ें (CLI और VS Code)

Claude Code बिना किसी अतिरिक्त सेटअप के आपकी फ़ाइलें पढ़ सकता है और शेल कमांड चला सकता है, लेकिन जब तक आप उसे जोड़ते नहीं, वह आपका इश्यू ट्रैकर, डेटाबेस या इमेज जनरेटर नहीं देख सकता। यह जोड़ ही MCP सर्वर है। MCP, यानी Model Context Protocol, एक ओपन स्टैंडर्ड है जो Claude Code को बाहरी सेवाओं को ऐसे कॉल करने देता है जैसे वे उसमें पहले से बनी हों। इसे जोड़ने में एक ही कमांड लगता है, और फिर वही सर्वर टर्मिनल और VS Code एक्सटेंशन दोनों में दिखता है।

इस लेख में सटीक कमांड हैं, तीन स्कोप की जानकारी है जो तय करते हैं कि सर्वर किसे मिलेगा, OAuth और टोकन से जुड़ी वे बातें हैं जिनमें लोग अक्सर उलझते हैं, और PicassoIA के इमेज और वीडियो कनेक्शन का एक असली उदाहरण है। नीचे दिए कमांड और फ़्लैग 6 अक्टूबर 2026 को Claude Code के मौजूदा दस्तावेज़ से मिलाए गए थे, इसलिए आपके टर्मिनल में वही दिखेगा जो यहाँ लिखा है।

💡 संक्षेप में: होस्टेड सर्वर के लिए claude mcp add --transport http <name> <url> चलाएँ। लोकल सर्वर के लिए claude mcp add --transport stdio <name> -- <command> चलाएँ। फिर Claude Code के अंदर /mcp टाइप करें और पुष्टि करें कि सर्वर Connected दिखा रहा है।

कुछ जोड़ने से पहले

क्या इंस्टॉल होना चाहिए

आपको Claude Code खुद चाहिए। VS Code वाले रास्ते के लिए आपको Claude Code एक्सटेंशन के साथ VS Code 1.94.0 या उसके बाद वाला वर्ज़न भी चाहिए। CLI का वर्ज़न claude --version से जाँचें, क्योंकि कुछ फ़ीचर इसी पर निर्भर हैं:

• VS Code डायलॉग से सर्वर जोड़ने या हटाने के लिए v2.1.261 या उसके बाद चाहिए
• /mcp reconnect all कमांड के लिए v2.1.284 या उसके बाद चाहिए

जब नीचे का कोई स्टेप कुछ न करे, तो सबसे पहले पुराने इंस्टॉल को जाँचें। आपको सर्वर की जानकारी भी चाहिए, और वह इस पर निर्भर करती है कि सर्वर कहाँ चलता है। रिमोट सर्वर के लिए आपको एक URL और या तो एक टोकन या ब्राउज़र साइन-इन चाहिए। लोकल सर्वर के लिए एक ऐसा कमांड चाहिए जो उसे शुरू करे, आमतौर पर npx के ज़रिए, इसलिए Node.js इंस्टॉल होना ज़रूरी है।

पहले ट्रांसपोर्ट चुनें

--transport फ़्लैग बताता है कि Claude Code सर्वर से कैसे बात करे। इसके तीन विकल्प हैं।

एक आसान नियम: /mcp पर खत्म होने वाला URL HTTP का मतलब है, /sse पर खत्म होने वाला URL पुराने SSE ट्रांसपोर्ट का मतलब है (जाँच लें कि वेंडर अब HTTP URL देता है या नहीं), और npx वाला कमांड stdio का मतलब है।

CLI से सर्वर जोड़ें

CLI सबसे तेज़ रास्ता है, और यहाँ आप जो भी करते हैं, VS Code एक्सटेंशन भी वही पढ़ता है। अपने प्रोजेक्ट फ़ोल्डर में टर्मिनल खोलें, या किसी भी फ़ोल्डर में, अगर आप आगे बताए गए user स्कोप का इस्तेमाल करने वाले हैं।

रिमोट HTTP सर्वर

पैटर्न claude mcp add --transport http <name> <url> है। यह एक असली होस्टेड सर्वर का उदाहरण है:

claude mcp add --transport http notion https://mcp.notion.com/mcp

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

notion वह नाम है जो आप चुनते हैं। यह टूल के नामों में mcp__notion__<tool> के रूप में दिखता है, इसलिए इसे छोटा और लोअरकेस रखें। जब सर्वर को टोकन चाहिए, तो उसे हेडर के रूप में दें:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

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

💡 सावधान रहें: claude mcp add कॉन्फ़िगरेशन सेव कर देता है, लेकिन आपके क्रेडेंशियल जाँचता नहीं। प्लेसहोल्डर टोकन भी स्वीकार हो जाता है, और गड़बड़ी तब दिखती है जब सर्वर बाद में कनेक्ट करने की कोशिश करता है।

लोकल stdio सर्वर

stdio सर्वर आपकी अपनी मशीन पर एक प्रोग्राम होता है, जिसे Claude Code शुरू करता है और standard input और output के ज़रिए उससे बात करता है। पैटर्न claude mcp add [options] <name> -- <command> [args...] है:

claude mcp add --transport stdio files -- npx -y @modelcontextprotocol/server-filesystem ~/projects

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

डबल डैश अनिवार्य है। उसके बाद का सब कुछ बिना बदले सर्वर को जाता है, और Claude Code के हर विकल्प (--env, --scope, --transport) नाम से पहले आने चाहिए। सर्वर प्रोसेस को कोई एनवायरनमेंट वेरिएबल देने के लिए --env इस्तेमाल करें:

claude mcp add --transport stdio --env MY_SERVICE_TOKEN=paste-here myservice -- npx -y your-server-package

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

your-server-package की जगह वह पैकेज लिखें जो वेंडर ने दस्तावेज़ में बताया है। नेटिव Windows पर (WSL नहीं), npx को अक्सर एक रैपर चाहिए ताकि शेल उसे शुरू कर सके:

claude mcp add --transport stdio files -- cmd /c npx -y @modelcontextprotocol/server-filesystem C:\Users\you\projects

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

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

रोज़मर्रा के प्रबंधन के लिए तीन कमांड हैं:

claude mcp list
claude mcp get files
claude mcp remove files

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

list सभी कॉन्फ़िगर किए गए सर्वर दिखाता है, get एक सर्वर की जानकारी दिखाता है, और remove उसे हटा देता है। अगर आपके पास सर्वर की परिभाषा JSON में है, तो claude mcp add-json <name> '<json>' उसे फ़्लैग में बदलने से बचाता है। Claude Code सेशन के अंदर /mcp लाइव स्टेटस दिखाता है और साइन-इन भी संभालता है।

VS Code में सर्वर जोड़ें

Claude Code एक्सटेंशन और CLI एक ही MCP कॉन्फ़िगरेशन साझा करते हैं, इसलिए दोनों में से कोई भी रास्ता आपको किसी एक में बाँधता नहीं।

/mcp डायलॉग का उपयोग करें

1. VS Code में Claude Code पैनल खोलें।
2. चैट बॉक्स में /mcp टाइप करें।
3. डायलॉग में सर्वर जोड़ें, या लोकल, user या project स्कोप पर सेव किसी सर्वर को हटाएँ।
4. उसी जगह से सर्वर चालू या बंद करें, किसी एक को रीकनेक्ट करें, या OAuth साइन-इन मैनेज करें।
5. एक नई बातचीत शुरू करें, /mcp फिर से टाइप करें, और जाँचें कि सर्वर Connected दिखा रहा है।

स्टेप 5 ज़रूरी है। बदलाव उन बातचीतों में लागू होते हैं जो आप बाद में शुरू करते हैं, इसलिए जो चैट पहले से खुली है, उसे नया सर्वर नहीं दिखेगा।

या टर्मिनल का उपयोग करें

Ctrl+` (Mac पर Cmd+`) से इंटीग्रेटेड टर्मिनल खोलें और वही claude mcp add कमांड चलाएँ जो आप कहीं और चलाते। डायलॉग और टर्मिनल कमांड एक ही कॉन्फ़िगरेशन में सेव करते हैं। यह GitHub के रिमोट सर्वर का उदाहरण है, जिसमें personal access token है:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

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

गलत क्रेडेंशियल वाला सर्वर /mcp में Failed दिखाता है, जबकि सही वाला Connected दिखाता है।

💡 दो कॉन्फ़िग फ़ाइलें, दो प्रोडक्ट: VS Code का अपना MCP सपोर्ट है, जिसकी फ़ाइल .vscode/mcp.json पर है। वह फ़ाइल VS Code की बिल्ट-इन चैट की है और उसका फ़ॉर्मेट अलग है। Claude Code अपना कॉन्फ़िगरेशन अलग रखता है, इसलिए जो सर्वर केवल .vscode/mcp.json में घोषित है, वह Claude Code की /mcp सूची में नहीं दिखेगा।

आप ide नाम के सर्वर के बारे में भी सुन सकते हैं। एक्सटेंशन इसे अपने-आप चलाता है ताकि diff खुल सकें और आपका सिलेक्शन पढ़ा जा सके, और यह /mcp की सूची में नहीं दिखता क्योंकि इसे कॉन्फ़िगर करने के लिए कुछ नहीं है।

सही स्कोप चुनें

स्कोप तय करता है कि सर्वर किसे दिखेगा और वह कहाँ सेव होगा। इसे --scope (छोटा रूप -s) से चुनें।

लोकल, प्रोजेक्ट या user

claude mcp add --transport http stripe --scope local https://mcp.stripe.com
claude mcp add --transport http shared --scope project https://example.com/mcp
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

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

मेरा अपना नियम: local प्रयोगों और उस चीज़ के लिए रखें जिसमें निजी टोकन हो, project उन टूल्स के लिए जिनकी पूरी टीम को ज़रूरत है, और user उन गिने-चुने सर्वरों के लिए जो आप हर रिपॉज़िटरी में चाहते हैं।

.mcp.json के साथ सर्वर साझा करें

project-scope सर्वर रिपो रूट की .mcp.json फ़ाइल में रहता है, जिसे आप कमिट करते हैं। यह एनवायरनमेंट वेरिएबल एक्सपैंशन सपोर्ट करता है, इसलिए फ़ाइल में कभी कोई सीक्रेट रखने की ज़रूरत नहीं पड़ती:

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_TOKEN}"
      }
    }
  }
}

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

${VAR} एनवायरनमेंट वेरिएबल में बदल जाता है, और ${VAR:-default} वेरिएबल सेट न होने पर डिफ़ॉल्ट वैल्यू इस्तेमाल करता है। हर टीममेट API_TOKEN अपनी मशीन पर सेट करता है।

इंटरएक्टिव सेशन में Claude Code .mcp.json से सर्वर इस्तेमाल करने से पहले टीममेट को एक अप्रूवल प्रॉम्प्ट दिखाता है। उन चुनावों को रीसेट करने के लिए claude mcp reset-project-choices चलाएँ। claude -p जैसे नॉन-इंटरैक्टिव रन बिना पूछे प्रोजेक्ट सर्वर लोड कर देते हैं, जो CI जॉब्स के लिए याद रखने लायक है।

टोकन और OAuth को सुरक्षित रूप से संभालें

सर्वर तीन तरीकों से प्रमाणित हो सकता है, और सही तरीका इस पर निर्भर है कि वेंडर क्या सपोर्ट करता है।

OAuth के लिए /mcp खोलें, सर्वर चुनें, और ब्राउज़र लॉगिन पूरा करें। कमांड लाइन से claude mcp login <name> वही काम करता है, और claude mcp login <name> --no-browser SSH या हेडलेस मशीन पर ज़रूरी चीज़ें प्रिंट करता है। सेव किए गए क्रेडेंशियल हटाने के लिए claude mcp logout <name> चलाएँ। कुछ सर्वरों को पहले से रजिस्टर्ड क्रेडेंशियल चाहिए, जिन्हें सर्वर जोड़ते समय आप --client-id, --client-secret और --callback-port के साथ देते हैं।

दो आदतें ज़्यादातर लीक रोकती हैं। पहली, कभी भी लिटरल टोकन कमिट न करें। ${VAR} को .mcp.json में रखें और असली वैल्यू अपने शेल एनवायरनमेंट में रखें। दूसरी, जिन सर्वरों में personal token हो, उन्हें local या user स्कोप पर रखें, जहाँ फ़ाइल रिपॉज़िटरी से बाहर रहती है।

PicassoIA को एक असली उदाहरण के रूप में जोड़ें

एक ठोस सर्वर से यह सब कम अमूर्त लगता है। PicassoIA एक MCP कनेक्शन देता है, जिससे AI क्लाइंट चैट से इमेज और वीडियो बना सकता है। इसमें चार मॉडल हैं: टेक्स्ट से इमेज के लिए PicassoIA Image, एडिट के लिए PicassoIA Image Editor Pro, टेक्स्ट या इमेज से क्लिप के लिए PicassoIA Video, और ऑडियो वाले वीडियो के लिए Seedance 2.5 Lite।

टूल्स एसिंक्रोनस जॉब्स के आसपास बने हैं। जनरेट कॉल जैसे ही कोई GPU जॉब स्वीकार करता है, एक prediction ID लौटा देता है, और फिर क्लाइंट get_generation को तब तक पोल करता है जब तक स्टेटस succeeded या failed न हो जाए। बाकी टूल्स edit_image, list_generations, cancel_generation, list_models और get_account हैं। एक अकाउंट एक समय में 5 predictions चला सकता है, और यह सीमा उसके सभी MCP कनेक्शनों में साझा है। MCP एक्सेस आपके प्लान पर निर्भर करता है, इसलिए इस पर भरोसा करने से पहले PicassoIA की प्राइसिंग पेज पर पुष्टि कर लें।

इसे जोड़ें और जाँचें

1. PicassoIA में साइन इन करें और अपना MCP कनेक्शन पेज खोलें। वहाँ आपके अकाउंट के लिए सर्वर URL दिखता है।
2. उस URL के साथ कमांड चलाएँ:

claude mcp add --transport http picassoia YOUR_PICASSOIA_MCP_URL

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

3. Claude Code खोलें, /mcp टाइप करें, और picassoia चुनें। अगर वह साइन इन माँगे, तो ब्राउज़र फ़्लो पूरा करें। अगर आपके connections page ने टोकन दिया हो, तो कमांड में --header "Authorization: Bearer YOUR_TOKEN" जोड़ें।
4. पुष्टि करें कि सर्वर Connected दिखा रहा है।

मैं यहाँ जानबूझकर URL नहीं छाप रहा। PicassoIA साइन इन के बाद आपका URL दिखाता है, इसलिए किसी लेख से कॉपी किए गए URL की जगह अपने अकाउंट वाला सटीक URL इस्तेमाल करें।

आज़माने लायक एक प्रॉम्प्ट

चूँकि आपने सर्वर का नाम picassoia रखा है, इसके टूल्स mcp__picassoia__<tool> के रूप में दिखेंगे। दो टूल्स इस्तेमाल करने वाला एक प्रयोग करें:

PicassoIA का उपयोग करके सूर्योदय के समय लकड़ी की मेज़ की 16:9 फ़ोटो बनाएँ, जिस पर लैपटॉप और कॉफ़ी कप हो, फिर उसे एनिमेट करके एक छोटा वीडियो बनाएँ।

Claude Code किसी नए टूल को कॉल करने से पहले अनुमति माँगता है, इसलिए पहली बार प्रॉम्प्ट देखने की उम्मीद रखें। अगर आप यह भी देखना चाहते हैं कि अलग-अलग लार्ज लैंग्वेज मॉडल एक ही निर्देश को कैसे समझते हैं, तो PicassoIA अपने LLM में Claude Sonnet 5 और Claude Fable 5 भी सूचीबद्ध करता है।

कनेक्ट न होने वाले सर्वर को ठीक करें

ज़्यादातर गड़बड़ियाँ कुछ गिने-चुने कारणों से होती हैं। स्टेटस देखने के लिए /mcp से शुरू करें, फिर ठीक-ठीक देखने के लिए कि क्या सेव हुआ है, claude mcp get <name> इस्तेमाल करें।

आम गड़बड़ियाँ और समाधान

टाइमआउट और बड़े आउटपुट

धीमे सर्वरों को तीन सेटिंग्स संभालती हैं। MCP_TIMEOUT सर्वर स्टार्टअप टाइमआउट को मिलीसेकंड में सेट करता है, जो तब काम आता है जब पहली npx डाउनलोड धीमी हो:

export MCP_TIMEOUT=10000

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

Windows PowerShell पर वही काम $env:MCP_TIMEOUT = "10000" से होता है। MAX_MCP_OUTPUT_TOKENS टूल आउटपुट की सीमा बढ़ाता है। डिफ़ॉल्ट 25,000 टोकन है, और Claude Code 10,000 पर चेतावनी देता है। आखिर में, .mcp.json में प्रति-सर्वर timeout (यह भी मिलीसेकंड में) धीमे टूल्स को ज़्यादा समय देता है, जो इमेज और वीडियो जनरेटर के लिए ठीक है:

{
  "mcpServers": {
    "slow-tool": {
      "type": "http",
      "url": "https://example.com/mcp",
      "timeout": 600000
    }
  }
}

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

अपनी इमेज के साथ आज़माएँ

अब आपके पास पूरा चक्र है: ट्रांसपोर्ट चुनें, सर्वर जोड़ें, स्कोप चुनें, सुरक्षित रूप से साइन इन करें, और गड़बड़ी होने पर उसे ठीक करें। वह फ़ायदा महसूस करने का सबसे तेज़ तरीका है कि आप ऐसा सर्वर जोड़ें जो कुछ ऐसा बनाए जिसे आप देख सकें।

PicassoIA में साइन इन करें, उसे Claude Code से जोड़ें, और एक फ़ोटो माँगें। उसे PicassoIA Image से बनाएँ, PicassoIA Image Editor Pro से निखारें, फिर PicassoIA Video या Seedance 2.5 Lite से उसमें जान डालें। हर मॉडल picassoia.com/en/all-models पर देखें, और अपने एक प्रॉम्प्ट से शुरुआत करें।