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

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

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

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

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

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

• काम करता है:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 फ़ाइल बन जाती है.

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

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

• एजेंट मोड और एजेंट (ऑटो-रन) मोड का इस्तेमाल करते समय, इंटरैक्टिव चैट में
• 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: एनवायरमेंट को फिर से बनाएं निर्देश चलाएं.
3. वर्कस्पेस को फिर से बनाने के बाद, देखें कि एमसीपी सर्वर कनेक्ट होता है या नहीं.

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

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

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

अगले चरण

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