Antigravity MCP Config: फ़ाइल का स्थान, स्टोर और आम एरर

Antigravity mcp_config.json कहाँ रखता है, और आपका एडिट कभी-कभी कुछ क्यों नहीं बदलता? Windows, macOS और Linux पर ग्लोबल और वर्कस्पेस पाथ, फ़ाइल खोलने के तीन तरीके, MCP Store सर्वर कैसे जोड़ता है, एक काम करने वाला JSON उदाहरण, और सबसे ज़्यादा आने वाली एरर के समाधान देखें।

Antigravity MCP Config: फ़ाइल का स्थान, स्टोर और आम एरर
Cristian Da Conceicao
Picasso IA के संस्थापक

आप Antigravity में एक नया सर्वर पेस्ट करते हैं, Refresh दबाते हैं, और टूल्स की लिस्ट खाली रहती है। अक्सर सर्वर ठीक होता है। समस्या फ़ाइल की होती है: ऐप कौन-सी mcp_config.json पढ़ता है, वह आपकी डिस्क पर कहाँ है, और क्या JSON में वही फ़ील्ड नाम हैं जो Antigravity उम्मीद करता है। Google के अपने पेज दो अलग पाथ बताते हैं, फ़ोरम पोस्ट में लोग गलत कॉपी एडिट करते दिखते हैं, और एरर मैसेज इतने छोटे हैं कि पहेली जैसे लगते हैं।

यह लेख तथ्यों को सटीक रूप से पक्का करता है। आपको Windows, macOS और Linux पर फ़ाइल का सटीक स्थान, ऐप से फ़ाइल खोलने के तीन तरीके, MCP Store का परिचय, एक भरोसेमंद कॉन्फ़िग और हर आम एरर का सीधा समाधान मिलेगा। जहाँ स्रोत आपस में मेल नहीं खाते, वहाँ टेक्स्ट यह साफ़ बताता है, अंदाज़ा नहीं लगाता।

mcp_config.json कहाँ रहती है

Antigravity हर MCP सर्वर परिभाषा को mcp_config.json नाम की एक JSON फ़ाइल में रखता है। आधिकारिक MCP पेज एक ग्लोबल फ़ाइल बताता है जो सभी प्रोजेक्ट्स पर लागू होती है, और एक वर्कस्पेस फ़ाइल जो एक ही रिपॉज़िटरी पर लागू होती है।

हिडन फ़ोल्डर ट्री खोलते हुए डेवलपर, जो Antigravity MCP कॉन्फ़िग फ़ाइल ढूँढ रहा है

ऑपरेटिंग सिस्टम के अनुसार ग्लोबल पाथ

सिस्टमग्लोबल पाथ
Windows%USERPROFILE%\.gemini\config\mcp_config.json
macOS~/.gemini/config/mcp_config.json
Linux~/.gemini/config/mcp_config.json

Windows पर, %USERPROFILE% का विस्तार कुछ इस तरह होता है: C:\Users\YourName। .gemini फ़ोल्डर का नाम बिंदु से शुरू होता है, इसलिए Finder और ज़्यादातर Linux फ़ाइल मैनेजर उसे छिपा देते हैं। Finder में छिपे आइटम दिखाने के लिए Cmd+Shift+. दबाएँ, Windows फ़ाइल मैनेजर में View मेनू के अंदर Hidden items पर टिक लगाएँ, या ब्राउज़ करने के बजाय पूरा पाथ एड्रेस बार या Go to Folder बॉक्स में पेस्ट करें।

कैफ़े की मेज़ पर रखा लैपटॉप, जिसकी स्क्रीन पर डार्क कोड विंडो खुली है, MCP कॉन्फ़िग एडिट करने का एक आम macOS सेटअप

एक प्रोजेक्ट के लिए वर्कस्पेस कॉन्फ़िग

किसी रिपॉज़िटरी के अंदर, डॉक्स .agents/mcp_config.json को वर्कस्पेस स्थान बताते हैं। यह उन सर्वरों के लिए ठीक है जो केवल एक कोडबेस के लिए मायने रखते हैं, जैसे किसी प्रोजेक्ट के डेवलपमेंट स्कीमा की ओर इशारा करने वाला डेटाबेस सर्वर। एक जापानी ट्रबलशूटिंग लेख बताता है कि वर्कस्पेस सेटिंग्स ग्लोबल फ़ाइल को ओवरराइड कर सकती हैं, इसलिए जब कोई सर्वर एक रिपॉज़िटरी के अंदर अलग व्यवहार करे, तो पहले यह पाथ जाँचें।

💡 टिप: अगर वर्कस्पेस फ़ाइल में टोकन हैं, तो अपने अगले commit से पहले .agents/mcp_config.json को .gitignore में जोड़ दें।

डॉक्स पाथ पर क्यों असहमत हैं

मौजूदा डॉक्स और CloudBees Unify सेटअप पेज ~/.gemini/config/mcp_config.json इस्तेमाल करते हैं। पुराने ट्यूटोरियल, कई सर्वर READMEs और macOS PATH बग रिपोर्ट ~/.gemini/antigravity/mcp_config.json इस्तेमाल करते हैं। OAuth टोकन फ़ाइल भी antigravity फ़ोल्डर में रहती है, और यही वजह है कि वह फ़ोल्डर नाम बार-बार दिखता है।

कोई भी पेज नहीं बताता कि जब दोनों फ़ाइलें मौजूद हों तो कौन-सी जीतती है। इसे एक टेस्ट से तय करें: किसी एक फ़ाइल में एक हानिरहित एंट्री जोड़ें, Refresh दबाएँ, और देखें कि वह सर्वर लिस्ट में आती है या नहीं। अगर नहीं आती, तो आपने गलत फ़ाइल एडिट की है। फिर एक ही लाइव फ़ाइल रखें और बची हुई कॉपी का नाम mcp_config.json.bak रख दें, ताकि दोनों में कभी फ़र्क़ न पड़े। IDE में View raw config के ज़रिए फ़ाइल खोलना यह देखने का सबसे तेज़ तरीका है कि आपका बिल्ड कौन-सी फ़ाइल उपयोग करता है।

फ़ाइल खोलने के तीन तरीके

आपको छिपे हुए फ़ोल्डरों में खोजने की ज़रूरत नहीं है। Antigravity की हर सतह के पास उसी कॉन्फ़िगरेशन तक पहुँचने का अपना रास्ता है।

डार्क कोड एडिटर में कच्ची MCP कॉन्फ़िग फ़ाइल एडिट करते हुए हाथ

IDE Agent Panel से

Antigravity IDE में, agent साइड पैनल के ऊपर … मेनू पर क्लिक करें, फिर MCP Servers, फिर Manage MCP Servers, फिर View raw config चुनें। फ़ाइल एडिटर में खुल जाएगी। उसे सेव करें, Manage MCP Servers स्क्रीन पर लौटें और Refresh दबाएँ। यह आखिरी क्लिक वही कदम है जिसकी ट्रबलशूटिंग थ्रेड्स बार-बार सलाह देते हैं।

Antigravity 2.0 Settings से

Antigravity 2.0 में रास्ता है Settings (नीचे बाएँ), फिर Customizations, फिर Installed MCP Servers। हर सर्वर के साथ एक टॉगल, एक ट्रैश आइकन और एक साझा Refresh बटन होता है। कमांड लाइन टूल का अपना रास्ता है: इंटरैक्टिव MCP Manager खोलने के लिए prompt पैनल में /mcp टाइप करें। यह कनेक्शन लॉग भी दिखाता है, जिनमें 401, 403 और 404 जैसे response codes और timeouts शामिल हैं, इसलिए असल में क्या गलत हुआ, यह पढ़ने की यह सबसे अच्छी जगह है।

MCP Store कैसे काम करता है

MCP Store तैयार सर्वरों की एक खोजने योग्य सूची है। डॉक्स में डेटाबेस, डेवलपर टूल, डिज़ाइन प्लेटफ़ॉर्म, सिक्योरिटी और एनालिटिक्स में 76 या उससे अधिक इंटीग्रेशन बताए गए हैं। आप इसे Installed MCP Servers से Add MCP पर क्लिक करके खोल सकते हैं, या IDE एजेंट पैनल के MCP Servers मेनू से।

लैपटॉप और टैबलेट वाली मेज़, जिस पर खाली टाइलों का ग्रिड दिख रहा है, जैसे MCP सर्वरों की कोई स्टोर सूची

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

  1. Settings खोलें, फिर Customizations, फिर Installed MCP Servers।
  2. स्टोर खोलने के लिए Add MCP पर क्लिक करें।
  3. वह सर्वर खोजें या स्क्रोल करके ढूँढें और Add पर क्लिक करें।
  4. अगर सर्वर साइन-इन माँगे, तो उसे पूरा करें।
  5. जाँचें कि टॉगल चालू है, फिर Refresh दबाएँ।

अपने पहले store इंस्टॉल के बाद कच्ची कॉन्फ़िग एक बार ज़रूर खोलें। स्टोर द्वारा लिखी गई एंट्री आगे चलकर हाथ से लिखी जाने वाली एंट्रियों के लिए एक तैयार टेम्पलेट है।

💡 टिप: OAuth वाले सर्वरों के लिए स्टोर इस्तेमाल करें, क्योंकि वह साइन-इन स्क्रीन संभाल लेता है। लोकल स्क्रिप्ट्स, निजी सर्वरों और कस्टम हेडर चाहिए ऐसी किसी भी चीज़ के लिए हाथ से लिखा JSON इस्तेमाल करें।

OAuth टोकन कहाँ जाते हैं

डॉक्स के अनुसार OAuth टोकन ~/.gemini/antigravity/mcp_oauth_tokens.json में सेव होते हैं। उस फ़ाइल को पासवर्ड वॉल्ट की तरह मानें: उसे dotfile रिपॉज़िटरी और क्लाउड सिंक फ़ोल्डरों से बाहर रखें। जब साइन-इन बार-बार फ़ेल हो, तो पहले IDE में Sign out बटन इस्तेमाल करें, या CLI /mcp व्यू में Authed स्टेटस देखें। टोकन फ़ाइल हटाना आखिरी उपाय है, और इससे हो सकता है कि आप एक साथ हर रिमोट सर्वर से साइन आउट हो जाएँ।

एक ऐसी कॉन्फ़िग जो सच में काम करे

फ़ाइल में एक टॉप-लेवल ऑब्जेक्ट होता है, mcpServers, और हर सर्वर उसके अंदर एक नामित एंट्री होता है। नामों में स्पेस नहीं होने चाहिए। Figma सर्वर पर एक फ़ोरम थ्रेड में पाया गया कि "Figma Desktop" जैसा सुझाया गया नाम FigmaDesktop बनाना पड़ा, और URL फ़ील्ड url नहीं बल्कि serverUrl होना चाहिए।

दो मॉनिटर वाली मेज़ पर बैठा डेवलपर, जो mcp_config.json की सर्वर एंट्री एडिट कर रहा है

command और args वाले लोकल सर्वर

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:/Users/you/projects"],
      "env": { "NODE_ENV": "production" },
      "cwd": "C:/Users/you/projects"
    }
  }
}

Windows पर पाथ को फ़ॉरवर्ड स्लैश से लिखें या बैकस्लैश को दोगुना करें (C:\\Users\\you), क्योंकि JSON में एक बैकस्लैश escape character होता है। हर फ़ील्ड क्या करता है, यह यहाँ है:

फ़ील्डउद्देश्यनोट्स
commandवह प्रोग्राम जो लोकल सर्वर शुरू करता हैPATH पर होना चाहिए, या absolute पाथ इस्तेमाल करें
argsउस प्रोग्राम के लिए आर्गुमेंट्सहर आर्गुमेंट के लिए एक स्ट्रिंग
envएनवायरनमेंट वेरिएबल्सटोकन यहाँ रखें, args में नहीं
cwdवर्किंग डायरेक्टरीवैकल्पिक
serverUrlरिमोट सर्वर का एंडपॉइंटHTTP सर्वरों के लिए command की जगह लेता है
headersरिमोट सर्वर को भेजे गए HTTP हेडरBearer टोकन यहाँ जाते हैं
oauthclientId जैसी क्लाइंट सेटिंग्सकुछ रिमोट सर्वरों के लिए ज़रूरी
disabledToolsमॉडल से छिपाए गए टूल के नाम100 टूल की सीमा से निपटने में मदद करता है

serverUrl वाले रिमोट सर्वर

{
  "mcpServers": {
    "remote-example": {
      "serverUrl": "https://api.example.com/mcp/",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

डॉक्स कहते हैं कि रिमोट सर्वरों के लिए सादे url फ़ील्ड समर्थित नहीं हैं, इसलिए किसी दूसरे एडिटर से कॉपी किए गए स्निपेट में उस एक नाम को बदलना होगा। OAuth इस्तेमाल करने वाले सर्वरों में हेडर की जगह एक oauth ब्लॉक लगता है: CloudBees पेज "oauth": { "clientId": "public-mcp-client" } दिखाता है। Google Workspace सर्वरों के लिए आप Google Cloud Console में एक Web application OAuth क्लाइंट बनाते हैं, https://antigravity.google/oauth-callback को redirect URI के रूप में जोड़ते हैं, और clientId तथा clientSecret को oauth सेक्शन में रखते हैं। जो सर्वर Google application default credentials स्वीकार करते हैं, वे "authProviderType": "google_credentials" इस्तेमाल करते हैं।

सेव करने से पहले तीन चीज़ें जाँचें, जो किसी भी Antigravity बग से ज़्यादा बार JSON तोड़ती हैं: ट्रेलिंग कॉमा, कमेंट (JSON में कोई कमेंट अनुमत नहीं है), और वेब पेज से पेस्ट किए गए कर्ली कोट्स।

आम एरर और समाधान

लैपटॉप स्क्रीन पर MCP कनेक्शन एरर को ध्यान से देखता डेवलपर

संदेशसंभावित कारणपहला उपाय
context deadline exceeded या [MCP Proxy] Socket connection error: connect ENOENTIDE स्टार्टअप पर इनिशियलाइज़ेशन विफल हुआMCP Servers मैनेज करें, फिर Refresh करें
exec: "npx": executable file not found in $PATHऐप Dock या Spotlight से आपके शेल PATH के बिना लॉन्च हुआटर्मिनल से agy के साथ लॉन्च करें, या absolute पाथ इस्तेमाल करें
calling 'initialize': sending 'initialize': Unauthorizedरिमोट सर्वर के पहले अनुरोध में टोकन नहीं थाऐप अपडेट करें और फिर से साइन इन करें
enabled tools would exceed max limit of 100सभी सर्वरों में बहुत सारे इनेबल्ड टूलसर्वर डिसेबल करें, या disabledTools की सूची बनाएँ
connection closed: calling 'initialize': client is closing: EOFहैंडशेक के दौरान सर्वर प्रोसेस बंद हो गयाटर्मिनल में वही कमांड चलाएँ और उसका आउटपुट पढ़ें

Context Deadline Exceeded

यह स्टार्टअप पर ENOENT socket मैसेज के साथ दिखता है, जब कोई सर्वर समय पर इनिशियलाइज़ नहीं हो पाता। बताया गया समाधान सरल है: Manage MCP Servers खोलें और Refresh दबाएँ। अगर यह हर रीस्टार्ट पर लौटे, तो एक व्यावहारिक तरीका है सर्वर पैकेज को ग्लोबली इंस्टॉल करना और command को इंस्टॉल की गई बाइनरी पर सेट करना, ताकि IDE बूट होते समय कुछ डाउनलोड न करना पड़े।

PATH में Executable नहीं मिला

exec: "npx": executable file not found in $PATH जैसे मैसेज तब आते हैं जब Antigravity को macOS Dock या Spotlight से शुरू किया जाता है। ऐप सिस्टम का सीमित PATH (/usr/bin:/bin:/usr/sbin:/sbin) इनहेरिट करता है, न कि आपके shell profile वाला PATH। थ्रेड इसे वर्ज़न 1.22.2 पर रिपोर्ट करता है और ये वर्कअराउंड बताता है:

  • ऐप को टर्मिनल से agy कमांड के साथ शुरू करें।
  • command में पूरा पाथ डालें। which npx चलाएँ और नतीजा पेस्ट करें, जैसे आम Apple Silicon Homebrew सेटअप पर /opt/homebrew/bin/npx।
  • सर्वर शुरू करने से पहले अपना Node version manager लोड करने वाली एक छोटी wrapper स्क्रिप्ट बनाएँ।

Windows यूज़र्स को पहले टर्मिनल में where npx चलाना चाहिए। अगर यह कुछ न छापे, तो समस्या कॉन्फ़िग की नहीं, Node इंस्टॉल की है।

Initialize पर Unauthorized

नेटवर्क पैच पैनल जिसमें केबल सलीके से रूट की गई हैं, रिमोट MCP सर्वर कनेक्शन का प्रतीक

initialize पर Unauthorized एरर का मतलब है कि रिमोट सर्वर को पहली रिक्वेस्ट बिना उपयोगी टोकन के मिली। Antigravity अपडेट करें, सर्वर से साइन आउट करें और फिर से साइन इन करें। अगर आप हेडर टोकन इस्तेमाल करते हैं, तो पक्का करें कि फ़ील्ड का नाम Authorization है, वैल्यू Bearer से शुरू होती है, और टोकन की मियाद खत्म नहीं हुई है। CLI /mcp लॉग में स्टेटस कोड से मामला और साफ़ होता है: 401 का मतलब गायब या गलत credentials, 403 का मतलब टोकन में सही permissions नहीं, और 404 का मतलब गलत URL पाथ।

100 से ज़्यादा टूल्स

Antigravity तब कनेक्ट होने से इनकार करता है जब सभी सर्वरों के सक्षम टूल्स की संख्या 100 से ऊपर जाए। GitHub या databases के बड़े सर्वर हर एक में दर्जनों टूल्स दिखा सकते हैं, इसलिए उनमें से तीन-चार ही इस सीमा तक पहुँच जाने के लिए काफ़ी हैं। जो सर्वर आप इस्तेमाल नहीं करते उन्हें बंद करें, या डॉक्स में सूचीबद्ध disabledTools प्रॉपर्टी से अलग-अलग टूल्स छिपाएँ।

एक और पैटर्न जानना उपयोगी है। Google AI developers फ़ोरम की एक रिपोर्ट में एक Roblox Studio सर्वर का ज़िक्र है, जो batch फ़ाइल से शुरू होता था और Hub 2.4.3, 2.5.0 और 2.8.0 पर EOF मैसेज के साथ फ़ेल हुआ, और Hub 2.2.1 पर रोलबैक करने के बाद ही फिर चला। जब कोई लोकल सर्वर इस तरह फ़ेल हो, तो उसकी ठीक वही कमांड टर्मिनल में चलाएँ। अगर वहाँ भी फ़ेल हो, तो कॉन्फ़िग ठीक है और सर्वर समस्या है। अगर वहाँ चले, तो वर्ज़न रिग्रेशन पर शक करें और अपना JSON बदलने से पहले फ़ोरम जाँचें।

PicassoIA पर Gemini 3.1 Pro इस्तेमाल करें

जब JSON ठीक से व्यवहार न करे, तब एक लैंग्वेज मॉडल तेज़ प्रूफ़रीडर का काम करता है। Gemini 3.1 Pro PicassoIA पर ब्राउज़र में चलता है, टेक्स्ट के साथ 10 इमेज तक स्वीकार करता है, और आप तय कर सकते हैं कि जवाब देने से पहले वह कितना सोचे।

JSON कॉन्फ़िग डीबग करते हुए लैपटॉप पर AI चैट का जवाब पढ़ती महिला

पालन करने योग्य कदम

  1. PicassoIA पर Gemini 3.1 Pro पेज खोलें।
  2. कुछ भी पेस्ट करने से पहले अपनी कॉन्फ़िग में हर असली टोकन को YOUR_TOKEN से बदलें।
  3. एक साफ़ निर्देश के बाद अपना JSON Prompt फ़ील्ड में पेस्ट करें, उदाहरण के लिए: "इस Antigravity mcp_config.json में syntax errors और गलत फ़ील्ड नाम जाँचें। रिमोट सर्वर को url नहीं, serverUrl इस्तेमाल करना चाहिए। सर्वर नामों में स्पेस नहीं होने चाहिए। हर समस्या की सूची दें, फिर केवल सुधारा हुआ JSON लौटाएँ।"
  4. वैकल्पिक: Images फ़ील्ड में एरर पैनल का स्क्रीनशॉट जोड़ें (10 इमेज तक, प्रति इमेज 7 MB)।
  5. मॉडल चलाएँ, सुधारा हुआ JSON View raw config में कॉपी करें, सेव करें, और Refresh दबाएँ।

पैरामीटर टिप्स

  • thinking_level: डिफ़ॉल्ट high है। कई सर्वरों वाली लंबी कॉन्फ़िग के लिए इसे रखें। साधारण syntax जाँच के लिए low काफ़ी है।
  • temperature: डिफ़ॉल्ट 1 है। इसे लगभग 0.2 तक घटाएँ, ताकि मॉडल रचनात्मक होने के बजाय हर बार वही JSON लौटाए।
  • system_instruction: जवाब छोटा रखने के लिए इसे कुछ ऐसा सेट करें जैसे "You are a strict JSON validator for MCP configuration files"।
  • max_output_tokens: डिफ़ॉल्ट इतना ऊँचा है कि आप जो भी कॉन्फ़िग लिखेंगे उसके लिए काफ़ी है, इसलिए इसे छोड़ दें।

मॉडल आपकी डिस्क नहीं देख सकता, इसलिए वह जो भी पाथ सुझाए उसे अंदाज़ा मानें और इस लेख की पहले वाली तालिका से जाँचें। उसी प्रॉम्प्ट पर दूसरी राय के लिए उसे Claude Sonnet 4.6 से भी चलाएँ और दोनों जवाबों की तुलना करें।

रीस्टार्ट से पहले एक चेकलिस्ट

सर्वर को दोष देने से पहले यह सूची देखें:

  • JSON पार्स होता है: कोई ट्रेलिंग कॉमा नहीं, कोई कमेंट नहीं, केवल सीधे कोट्स।
  • रिमोट सर्वर serverUrl इस्तेमाल करते हैं, और लोकल सर्वर command के साथ args इस्तेमाल करते हैं।
  • सर्वर नामों में कोई स्पेस नहीं है।
  • कमांड टर्मिनल में काम करती है, या command में पूरा पाथ है।
  • टोकन env या headers में रहते हैं, और अगर फ़ाइल में सीक्रेट्स हैं तो वह version control से बाहर है।
  • सभी सर्वरों के सक्षम टूल्स 100 से कम हैं।
  • आपने वही फ़ाइल एडिट की है जिसे ऐप सच में पढ़ता है, जिसकी पुष्टि आप View raw config से कर सकते हैं।
  • आपने Refresh दबाया और फिर टॉगल या CLI /mcp व्यू जाँचा।

💡 टिप: जो सर्वर आपके टर्मिनल में काम करता है पर Antigravity के अंदर फ़ेल होता है, वह आम तौर पर एनवायरनमेंट के अंतर की ओर इशारा करता है, ज़्यादातर PATH की ओर। which या where का आउटपुट उससे मिलाएँ जो ऐप देखता है।

Picasso IA खुद आज़माएँ

एक बार आपके सर्वर कनेक्ट हो जाएँ, तो आपका agent तेज़ी से बना सकता है, और हर प्रोजेक्ट जो रिलीज़ होता है उसे विज़ुअल्स भी चाहिए: README बैनर, docs हेडर, ब्लॉग हेडर और सोशल प्रीव्यू। Picasso IA इमेज मॉडल्स को एक जगह लाता है, ताकि आप एक प्रॉम्प्ट आज़मा सकें, लेंस या रोशनी बदल सकें, और सेकंडों में फिर से जनरेट कर सकें।

धूप वाले स्टूडियो में टैबलेट के साथ रखी छपी तस्वीर देखता फ़ोटोग्राफ़र

विस्तृत फ़ोटोरियलिस्टिक दृश्यों के लिए Seedream 4.5 से शुरू करें, या तेज़ ड्राफ़्ट के लिए P-Image। सब्जेक्ट, सेटिंग, रोशनी की दिशा और कैमरा लेंस बताएँ, ठीक उसी तरह जैसे आप किसी फ़ोटोग्राफ़र को ब्रीफ़ करते। पूरी मॉडल लिस्ट देखें, अपने अगले प्रोजेक्ट के लिए फ़िट बैठने वाला मॉडल चुनें, और आज ही अपनी पहली इमेज बनाएँ।

यह लेख शेयर करें

अपनी भाषा चुनें

संबंधित लेख