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

एमसीपी सर्वर, Gemini को अतिरिक्त टूल और डेटा सोर्स उपलब्ध कराते हैं. उदाहरण के लिए, Firebase MCP सर्वर जोड़कर, अपने ऐप्लिकेशन को बनाते या डीबग करते समय, नैचुरल लैंग्वेज का इस्तेमाल करके अपने 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 नाम का एक सर्वर दिखाया गया है. यह firebase-tools@latest को इंस्टॉल और चलाने के लिए, npx कमांड का इस्तेमाल करेगा.

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

   • रिमोट एचटीटीपी एमसीपी सर्वर के लिए, अनुरोध हेडर में एपीआई पासकोड की ज़रूरत होती है. 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 MCP सर्वर का इस्तेमाल करने के लिए, अपने खाते में साइन इन करने के लिए यह कमांड डालें:

   firebase login --no-localhost
   

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

   firebase init
   

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

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

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

• Agent मोड और Agent (Auto-run) मोड का इस्तेमाल करते समय इंटरैक्टिव चैट
• App Prototyping agent

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

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

टूल की जांच करना या उन्हें अडजस्ट करना

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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