मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर से कनेक्ट करना

एमसीपी सर्वर, Gemini को अतिरिक्त टूल और डेटा सोर्स उपलब्ध कराते हैं. उदाहरण के लिए, Firebase एमसीपी सर्वर जोड़ने पर, अपने ऐप्लिकेशन को बनाते या डीबग करते समय, Cloud Firestore डेटा को एक्सप्लोर करने के लिए, सामान्य भाषा का इस्तेमाल किया जा सकता है.

ज़रूरी शर्तें

अगर एमसीपी सर्वर के लिए ज़रूरी हो, तो पक्का करें कि Node.js और npm इंस्टॉल हों और काम कर रहे हों.

कोई मान्य एमसीपी सर्वर चुनना

Firebase Studio में एमसीपी सर्वर के साथ काम करने की बुनियादी सुविधा है. हालांकि, सभी एमसीपी सर्वर इसके साथ काम नहीं करते. कोई एमसीपी सर्वर चुनते समय, यहां दी गई जानकारी को ध्यान में रखें:

• काम करता है:

  • स्टैंडर्ड इनपुट/आउटपुट (stdio) या सर्वर-सेंड इवेंट (एसएसई)/स्ट्रीमेबल एचटीटीपी ट्रांसपोर्ट सर्वर
  • एचटीटीपी हेडर या एनवायरमेंट वैरिएबल का इस्तेमाल करके, एपीआई पासकोड से पुष्टि करना
  • एमसीपी सर्वर से मिलने वाले टूल

• काम नहीं करता है:

  • ऐसे सर्वर जिनके लिए ग्राफ़िकल यूज़र इंटरफ़ेस या डेस्कटॉप सेशन की ज़रूरत होती है
  • एमसीपी सर्वर से मिलने वाले प्रॉम्प्ट, सैंपलिंग या अन्य संसाधन

कोई एमसीपी सर्वर जोड़ना

कोई एमसीपी सर्वर जोड़ने के लिए, आपको उसकी कॉन्फ़िगरेशन फ़ाइल बनानी या उसमें बदलाव करना होगा.

• अपने पहले सर्वर के लिए: कॉन्फ़िगरेशन फ़ाइल बनाएं.
• सर्वर जोड़ने या उनमें बदलाव करने के लिए: सर्वर के कॉन्फ़िगरेशन में बदलाव करें.

पहला चरण: कॉन्फ़िगरेशन फ़ाइल बनाना

इंटरैक्टिव चैट और Gemini CLI को एमसीपी सर्वर से कनेक्ट किया जा सकता है. हालांकि, इसके लिए अलग-अलग कॉन्फ़िगरेशन फ़ाइलें इस्तेमाल की जाती हैं:

• इंटरैक्टिव चैट, .idx/mcp.json का इस्तेमाल करती है.
• Gemini CLI का इस्तेमाल करता है .gemini/settings.json.

यहां दिए गए निर्देशों का पालन करके, इनमें से कोई एक या दोनों फ़ाइलें बनाएं.

इंटरैक्टिव चैट

Code व्यू में, इनमें से किसी एक तरीके का इस्तेमाल करके .idx/mcp.json बनाएं:

• कमांड पैलेट: कमांड पैलेट (Shift+Ctrl+P) खोलें और Firebase Studio: Add MCP Server निर्देश का इस्तेमाल करें.
• इंटरैक्टिव चैट: इंटरैक्टिव चैट में, टूल कस्टमाइज़ करें पर क्लिक करें और एमसीपी सर्वर जोड़ें को चुनें.
• एक्सप्लोरर: एक्सप्लोरर (Ctrl+Shift+E) में जाकर, .idx डायरेक्ट्री पर राइट क्लिक करें और नई फ़ाइल को चुनें. फ़ाइल का नाम mcp.json रखें.

Gemini CLI

Code व्यू में, .gemini/settings.json बनाएं:

1. एक्सप्लोरर (Ctrl+Shift+E) में जाकर, देखें कि .gemini डायरेक्ट्री मौजूद है या नहीं. अगर नहीं है, तो एक्सप्लोरर पैन पर राइट क्लिक करें और नया फ़ोल्डर को चुनें. फ़ोल्डर का नाम .gemini रखें.
2. .gemini डायरेक्ट्री पर राइट क्लिक करें और नई फ़ाइल को चुनें. फ़ाइल का नाम settings.json रखें.

Gemini CLI के साथ एमसीपी सर्वर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, पूरी जानकारी देखें.

दूसरा चरण: सर्वर के कॉन्फ़िगरेशन में बदलाव करना

1. सर्वर की कॉन्फ़िगरेशन फ़ाइल खोलें.

2. फ़ाइल के कॉन्टेंट में, सर्वर का कॉन्फ़िगरेशन जोड़ें. उदाहरण के लिए, Firebase एमसीपी सर्वर जोड़ने के लिए, यह डालें:

   {
     "mcpServers": {
      "firebase": {
        "command": "npx",
        "args": [
          "-y",
          "firebase-tools@latest",
          "mcp"
         ]
       }
     }
   }
   

   इस कॉन्फ़िगरेशन फ़ाइल से Gemini को यह निर्देश मिलता है कि उसे किस एमसीपी सर्वर का इस्तेमाल करना है. इस उदाहरण में, एक सर्वर दिखाया गया है जिसका नाम है firebase. यह npx निर्देश का इस्तेमाल करके firebase-tools@latest को इंस्टॉल और रन करेगा.

   अगर आपके एमसीपी सर्वर में लॉग इन करने के लिए, एपीआई पासकोड से पुष्टि करना ज़रूरी है, तो इसे इनमें से किसी एक तरीके से कॉन्फ़िगर किया जा सकता है:

   • रिमोट एचटीटीपी एमसीपी सर्वर के लिए, अनुरोध के हेडर में एपीआई पासकोड की ज़रूरत होती है. इसके लिए, headers फ़ील्ड का इस्तेमाल करें. उदाहरण के लिए, GitHub के एमसीपी सर्वर को कॉन्फ़िगर करने के लिए:

     {
       "mcpServers": {
         "github": {
           "url": "https://api.githubcopilot.com/mcp/",
           "headers": {
             "Authorization": "Bearer <ACCESS_TOKEN>"
           }
         }
       }
     }
     

   • लोकल stdio एमसीपी सर्वर के लिए, एनवायरमेंट वैरिएबल में एपीआई पासकोड की ज़रूरत होती है. इसके लिए, env फ़ील्ड का इस्तेमाल करें. उदाहरण के लिए, GitHub के एमसीपी सर्वर के लोकल बिल्ड को कॉन्फ़िगर करने के लिए:

     {
       "mcpServers": {
         "github": {
           "command": "/path/to/github-mcp-server",
           "args": ["stdio"],
           "env": {
             "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
           }
         }
       }
     }
     

   • mcp.json में सीक्रेट को हार्डकोड करने से बचने के लिए, वैकल्पिक तौर पर ${env:VARIABLE_NAME} सिंटैक्स का इस्तेमाल किया जा सकता है. इससे आपके वर्कस्पेस के रूट में मौजूद .env या .env.local फ़ाइल में तय किए गए एनवायरमेंट वैरिएबल की वैल्यू बदल जाएंगी. उदाहरण के लिए:

     {
       "mcpServers": {
         "github": {
           "url": "https://api.githubcopilot.com/mcp/",
           "headers": {
             "Authorization": "Bearer ${env:GITHUB_ACCESS_TOKEN}"
           }
         }
       }
     }
     

3. टर्मिनल (Shift+Ctrl+C) में, इंस्टॉलेशन पूरा करने के लिए ज़रूरी निर्देश चलाएं. उदाहरण के लिए, Firebase एमसीपी सर्वर का इस्तेमाल करने के लिए, अपने खाते में साइन इन करने के लिए यह निर्देश डालें:

   firebase login --no-localhost
   

   सेशन को अनुमति देने के लिए, टर्मिनल में दिए गए निर्देशों का पालन करें. कुछ टूल के लिए, Firebase प्रोजेक्ट को कनेक्ट करना ज़रूरी है. Firebase एमसीपी सर्वर का इस्तेमाल करके, कोई प्रोजेक्ट बनाया जा सकता है. इसके अलावा, Firebase प्रोजेक्ट को शुरू करने के लिए, यह निर्देश चलाया जा सकता है:

   firebase init
   

   इससे आपकी रूट डायरेक्ट्री में, firebase.json फ़ाइल बन जाती है.

एमसीपी टूल इस्तेमाल करना

इस्तेमाल किए जाने वाले एमसीपी सर्वर को इंस्टॉल करने के बाद, उससे मिलने वाले टूल या डेटा यहां उपलब्ध होते हैं:

• Gemini CLI
• एजेंट मोड और एजेंट (ऑटो-रन) मोड का इस्तेमाल करते समय, इंटरैक्टिव चैट
• App Prototyping agent

उदाहरण के लिए, Firebase एमसीपी सर्वर जोड़ने पर, Geminiसे मौजूदा प्रोजेक्ट के लिए SDK कॉन्फ़िगरेशन फ़ेच करने, में सेव किया गया डेटा वापस पाने, Cloud Firestore और Realtime Database Firebase की सेवाओं को सेट अप करने में मदद पाने, वगैरह के लिए कहा जा सकता है.

इंटरैक्टिव चैट में, उपलब्ध एमसीपी प्रॉम्प्ट की सूची देखने के लिए, / टाइप करें.

टूल की जांच करना या उनमें बदलाव करना

इंटरैक्टिव चैट में, यह मैनेज किया जा सकता है कि कौनसे टूल चालू हैं:

1. कॉन्फ़िगर किए गए एमसीपी सर्वर से मिलने वाले सभी उपलब्ध टूल की सूची देखने के लिए, इंटरैक्टिव चैट में टूल कस्टमाइज़ करें पर क्लिक करें.
2. पूरे सर्वर या अलग-अलग टूल को चालू या बंद करने के लिए, चेकबॉक्स का इस्तेमाल करें.

एमसीपी सर्वर से जुड़ी समस्याएं हल करना

अगर आपको किसी एमसीपी सर्वर से जुड़ी समस्याएं आ रही हैं, तो समस्या की पहचान करने के लिए, यह तरीका अपनाएं.

गड़बड़ियों के लिए लॉग देखना

1. आउटपुट पैनल (Shift+Ctrl+U) खोलें.
2. ड्रॉप-डाउन मेन्यू में, Gemini को चुनें.
3. [MCPManager] टैग से शुरू होने वाले मैसेज देखें. इन लॉग में यह दिखता है कि कौनसे सर्वर कॉन्फ़िगर किए गए हैं, कौनसे टूल जोड़े गए हैं, और गड़बड़ी के मैसेज कौनसे हैं.

एनवायरमेंट को फिर से बनाना

अगर कोई एमसीपी सर्वर इंस्टॉल या कनेक्ट नहीं हो पाता है, तो अपने वर्कस्पेस को फिर से बनाने की कोशिश करें:

1. कमांड पैलेट (Shift+Ctrl+P) खोलें.
2. Firebase Studio: Rebuild Environment निर्देश चलाएं.
3. वर्कस्पेस को फिर से बनाने के बाद, देखें कि एमसीपी सर्वर कनेक्ट होता है या नहीं.

अगर टूल इस्तेमाल नहीं किए जा रहे हैं

अगर एमसीपी सर्वर कनेक्ट हो जाता है, लेकिन Gemini उसके टूल का इस्तेमाल नहीं करता, तो:

• नया चैट सेशन शुरू करें: इससे यह पक्का होता है कि Gemini टूल के सबसे नए कॉन्फ़िगरेशन का इस्तेमाल करे. चैट के इतिहास को मैनेज करने का तरीका जानें.
• अपने प्रॉम्प्ट में खास जानकारी दें: अगर Gemini एमसीपी टूल का इस्तेमाल किए बिना टास्क पूरा कर सकता है, तो वह कोई दूसरा तरीका अपना सकता है. अगर आपको कोई खास टूल इस्तेमाल करना है, तो उस टूल का नाम लेकर कोशिश करें. उदाहरण के लिए: "मौजूदा प्रोजेक्ट के लिए SDK कॉन्फ़िगरेशन पाने के लिए, firebase_get_sdk_config का इस्तेमाल करें."
• Google Developer Program में शामिल हों: देखें कि आपका खाता एनरोल है या नहीं.

अगले चरण

• Firebase एमसीपी सर्वर के बारे में ज़्यादा जानें.
• Firebase Studio एमसीपी सर्वर का कोडलैब पूरा करें.