एंटीग्रैविटी CLI + स्क्रेपलेस: एक रिमोट MCP सर्वर जोड़ें

TL;DR:

• एंटीग्रैविटी CLI स्क्रेपलेस से एक दूरस्थ MCP सर्वर के रूप में जुड़ता है। एक प्रविष्टि serverUrl और x-api-token हेडर के साथ, जिसे agy mcp add के साथ जोड़ा गया है या हाथ से लिखा गया है, पूरी सेटअप है।
• हेडर में कुंजी स्वयं लिखें। एक ${SCRAPELESS_API_KEY} संदर्भ को लिटरल टेक्स्ट के रूप में भेजा जाता है, और फिर हर टूल कॉल 401 के साथ विफल होता है जो अभी भी सफलता की रिपोर्ट करता है।
• agy mcp list कॉन्फ़िगरेशन दिखाता है, न कि एक कार्यशील संबंध। एक सर्वर enabled पढ़ता है चाहे उसकी कुंजी मान्य हो या नहीं।
• हेडलेस रन को एक अनुमति नियम की आवश्यकता होती है। MCP टूल्स पूछने के मोड में प्रारंभ होते हैं, और agy -p पूछ नहीं सकता, इसलिए यह कॉल को मना कर देता है। mcp(scrapeless/scrape_markdown) में permissions.allow उस एक टूल को चलने देता है।
• हेडर नाम x-api-token है। स्क्रेपलेस बिना इसके एक अनुरोध का उत्तर 401 Unauthorized: Missing x-api-token header के साथ देता है।
• स्क्रेपलेस मुफ्त योजना पर एक कुंजी प्राप्त करें और इसे कुछ मिनटों में कनेक्ट करें।

एंटीग्रैविटी CLI, agy कमांड, एक टर्मिनल से गूगल का एंटीग्रैविटी एजेंट चलाता है, और यह वह स्थान है जहां गूगल अब उन लोगों को भेजता है जिन्होंने व्यक्तिगत खाते के साथ जेमिनी CLI का उपयोग किया। एजेंट फाइलें पढ़ सकता है, कमांड चला सकता है और वेब पर खोज कर सकता है। स्क्रेपलेस MCP सर्वर क्लाउड ब्राउज़र में रेंडर की गई पृष्ठों को जोड़ता है और इसे मार्कडाउन के रूप में लौटाता है, एक ब्राउज़र सत्र जिसे एजेंट चरण दर चरण चला सकता है, बैकग्राउंड क्रॉल्स और गूगल परिणाम डेटा।

यह गाइड एंटीग्रैविटी CLI में होस्टेड सर्वर को जोड़ता है और एक स्क्रिप्ट से एक टूल कॉल चलाता है। कॉन्फ़िगरेशन छोटा है। तीन विवरण तय करते हैं कि यह काम करता है या नहीं: कुंजी कैसे लिखी जाती है, कौन सी स्थिति पंक्ति पर भरोसा करना है, और एक हेडलेस रन को आवश्यक अनुमति नियम।

स्क्रेपलेस एंटीग्रैविटी CLI को क्या जोड़ता है

सर्वर 25 टूल्स को प्रदर्शित करता है, जिन्हें कार्य के अनुसार समूहित किया गया है:

• scrape_markdown, scrape_html और scrape_screenshot एक कॉल में मार्कडाउन, कच्चा HTML या एक इमेज के रूप में रेंडर की गई पृष्ठ लौटाते हैं।
• सोलह browser_* टूल्स, browser_create और browser_goto से लेकर browser_click, browser_type और browser_snapshot, चरण दर चरण एक क्लाउड ब्राउज़र सत्र को चलाते हैं।
• crawl_start, crawl_result और crawl_cancel बैकग्राउंड में एक क्रॉल चलाते हैं और इसे बाद में इकट्ठा करते हैं।
• google_search और google_trends खोज परिणाम और प्रवृत्ति डेटा लौटाते हैं, और ai_scraper AI सहायक जैसे ChatGPT, Gemini और Perplexity से उत्तर कैप्चर करता है।

एंटीग्रैविटी CLI प्रत्येक टूल के स्कीमा की एक प्रति ~/.gemini/antigravity-cli/mcp/scrapeless/ के तहत रखता है, प्रति टूल एक JSON फ़ाइल, और परीक्षण में एजेंट ने scrape_markdown स्कीमा को पढ़ा इससे पहले कि उसने टूल को कॉल किया।

यदि आप इसके बजाय एंटीग्रैविटी डेस्कटॉप ऐप का उपयोग करते हैं, तो हमारा एंटीग्रैविटी IDE गाइड उस सेटअप को कवर करता है।

एंटीग्रैविटी CLI MCP सर्वरों को कैसे पढ़ता है

एंटीग्रैविटी के लिए गूगल का MCP दस्तावेज़ कॉन्फ़िगरेशन को ~/.gemini/config/mcp_config.json में रखता है, स्थानीय विकल्प के रूप में .agents/mcp_config.json पर एक कार्यक्षेत्र फ़ाइल होती है। यह गाइड वैश्विक फ़ाइल का उपयोग करता है, वही जो नीचे दिए गए परीक्षण पढ़ते हैं। एक दूरस्थ सर्वर को दो गुणधर्म चाहिए:

• serverUrl, एक दूरस्थ Streamable HTTP या SSE सर्वर का URL।
• headers, उस सर्वर को भेजे गए कस्टम HTTP हेडर।

स्क्रेपलेस एक Streamable HTTP एंडपॉइंट है जो https://api.scrapeless.com/mcp पर है, इसलिए परिवहन सेटिंग की आवश्यकता नहीं है।

पूर्वापेक्षाएँ

• एंटीग्रैविटी CLI, गूगल खाते के साथ साइन इन किया गया। इस गाइड में agy 1.2.2 का उपयोग किया गया है जो लिनक्स पर व्यक्तिगत गूगल खाते के साथ है।
• स्क्रेपलेस डैशबोर्ड से एक स्क्रेपलेस API कुंजी।

चरण 1: सर्वर जोड़ें

agy mcp add आपके लिए प्रविष्टि लिखता है। फ़्लैग सर्वर नाम से पहले आते हैं, और एक https URL को HTTP सर्वर के रूप में पता लगाया जाता है:

agy mcp add -H "x-api-token: YOUR_SCRAPELESS_API_KEY" scrapeless https://api.scrapeless.com/mcp

यह उत्तर देता है:

Added MCP server "scrapeless" (http)

और इस प्रविष्टि को ~/.gemini/config/mcp_config.json में लिखता है:

{
  "mcpServers": {
    "scrapeless": {
      "disabled": false,
      "headers": {
        "x-api-token": "YOUR_SCRAPELESS_API_KEY"
      },
      "serverUrl": "https://api.scrapeless.com/mcp"
    }
  }
}

कमांड आपकी शेल इतिहास में कुंजी डालता है। इससे बचने के लिए, एक संपादक के साथ फ़ाइल में वही प्रविष्टि लिखें, फिर chmod 600 ~/.gemini/config/mcp_config.json के साथ फ़ाइल को आपके उपयोगकर्ता तक सीमित करें।

क्या आप इसे अभी सेट कर रहे हैं? स्क्रेपलेस मुफ्त योजना कनेक्शन और आपके पहले टूल कॉल्स को कवर करती है।

चरण 2: कुंजी को स्वयं हेडर में डालें

कई MCP क्लाइंट्स कॉन्फ़िगरेशन फ़ाइल के अंदर वातावरण परिवर्तनों का विस्तार करते हैं, और इसे "x-api-token": "${SCRAPELESS_API_KEY}" यहाँ लिखना लुभावना होता है। एंटीग्रैविटी CLI इसका विस्तार नहीं करता है। फ़ाइल में उस मान के साथ और परिवर्तनीय के निर्यात के साथ, एक रन जिसने scrape_markdown के लिए पूछा था, इस उत्तर के साथ वापस आया:

Failed to fetch data. Error: [Scrapeless]: Request POST https://api.scrapeless.com/api/v1/unlocker/request failed with status 401

रन ने अभी भी "status": "SUCCESS" की सूचना दी। Scrapeless को संदर्भित पाठ ${SCRAPELESS_API_KEY} प्राप्त हुआ, कनेक्शन को स्वीकार किया जैसा कि यह किसी भी हेडर मान के लिए करता है, और टूल कॉल को अस्वीकार कर दिया। कुंजी को हेडर में लिखें, और फ़ाइल की सुरक्षा करें।

चरण 3: सर्वर सूची की जांच करें

CLI क्या लोड करेगा उसे सूचीबद्ध करें:

agy mcp list

NAME        TYPE  STATUS   COMMAND/URL
scrapeless  http  enabled  https://api.scrapeless.com/mcp

enabled का मतलब है कि प्रविष्टि मौजूद है और बंद नहीं की गई है। आदेश एक सेकंड के एक हिस्से में वापस आया और कुंजी को प्रमाणित नहीं किया, इसलिए जांच जो मायने रखती है वह चरण 5 में टूल कॉल है।

चरण 4: हेडलेस रन से पहले टूल की अनुमति दें

एंटीग्रेविटी एक MCP टूल को चलाने से पहले पूछता है जिसके लिए इसके पास कोई नियम नहीं है। एंटीग्रेविटी की अनुमति संदर्भ डिफ़ॉल्ट रूप से पूछें के तहत MCP टूल की सूची बनाता है और उन्हें mcp(server/tool), mcp(server/*) या mcp(*) के साथ मिलाता है। एक इंटरैक्टिव सत्र में इसका मतलब है कि अनुमोदन प्रॉम्प्ट। प्रिंट-मोड रन में पूछने के लिए कोई नहीं होता, इसलिए यह कॉल को अस्वीकार कर देता है और प्रिंट करता है:

jetski: no output produced — a tool required the "mcp" permission that headless mode cannot prompt for, so it was auto-denied. Add an allow-rule under permissions.allow in settings.json (e.g. mcp(<target>)). Alternatively, re-run with --dangerously-skip-permissions to auto-approve all tools.

इसकी JSON आउटपुट कॉल को denied_actions के तहत CallMcpTool के रूप में सूचीबद्ध करती है। अपने स्क्रिप्ट के लिए आवश्यक एक टूल के लिए ~/.gemini/antigravity-cli/settings.json में एक नियम जोड़ें, पहले से मौजूद किसी भी नियम के पास:

{
  "permissions": {
    "allow": ["mcp(scrapeless/scrape_markdown)"]
  }
}

इस तरह के नियम को --dangerously-skip-permissions के बजाय प्राथमिकता दें, जो रन के लिए हर टूल, फ़ाइल और आदेश क्रिया को मंजूरी देता है। mcp(scrapeless/*) सभी 25 Scrapeless टूल्स की अनुमति देता है। CLI के रिपॉजिटरी पर एक खुले रिपोर्ट में, एंटीग्रेविटी CLI मुद्दा 548, प्रिंट मोड की अनदेखी करने की बात करता है permissions.allow। agy 1.2.2 के साथ उपरोक्त नियम लोड और लागू किया गया: CLI लॉग ने इसे स्टार्टअप पर सूचीबद्ध किया, और कॉल पारित हो गई।

चरण 5: एक टूल कॉल चलाएँ

प्रिंट मोड में एक छोटा, जांच योग्य कार्य मांगे:

agy -p "Call the scrapeless MCP server's scrape_markdown tool with url https://example.com and reply with the first Markdown heading, verbatim." --output-format json

JSON आउटपुट उत्तर को response में ले जाता है:

"status": "SUCCESS"
"response": "# Example Domain\n"

एंटीग्रेविटी का संवाद रिकॉर्ड दिखाता है कि एजेंट वहां कैसे पहुंचा: इसने कैश किए हुए scrape_markdown स्कीमा को पढ़ा, फिर scrape_markdown को https://example.com पर कॉल किया। रन में प्रत्येक के लिए थोड़ा दो मिनट का समय लगा, और एक समय पर कदम दर कदम टूल कॉल ने खुद लगभग पांच सेकंड लिया।

response पाठ पढ़ें, status नहीं। एक गलत कुंजी, एक गलत हेडर नाम या एक असंबद्ध चर अभी भी SUCCESS उत्पन्न करता है, और पाठ Failed to fetch data से शुरू होता है।

सामान्य समस्याओं को ठीक करें

सर्वर के बारे में अधिक जानने के लिए, Scrapeless MCP सर्वर की घोषणा पढ़ें। ब्राउज़र MCP दस्तावेज़ कॉन्फ़िगरेशन संदर्भ को ले जाता है, स्क्रैपिंग एपीआई पृष्ठ टूल के पीछे के पात्रों को कवर करता है, और मूल्य निर्धारण कॉल की लागत सूचीबद्ध करता है।

निष्कर्ष

एंटीग्रेविटी CLI में Scrapeless को जोड़ने के लिए ~/.gemini/config/mcp_config.json में एक प्रविष्टि की आवश्यकता होती है: serverUrl को https://api.scrapeless.com/mcp पर सेट किया जाता है और x-api-token हेडर जो स्वयं कुंजी को रखता है। agy mcp add -H इसे एक पंक्ति में लिखता है, और एक स्क्रिप्टेड रन को प्रति टूल एक अनुमति नियम की आवश्यकता होती है।

दो परिणाम अच्छे दिखते हैं और नहीं। enabled सर्वर सूची में कुंजी के बारे में कुछ नहीं कहता है, और एक खराब कुंजी या एक असंबद्ध चर के साथ रन अभी भी सफलता की सूचना देता है। उपकरण के उत्तर को पढ़ें, और सेटअप को प्रमाणित किया गया है।

क्या एंटीग्रेविटी के एजेंट को वेब का लाइव दृश्य देने के लिए तैयार हैं? Scrapeless के मुफ्त योजना के साथ शुरू करें और सर्वर जोड़ें।

प्रशन - उत्तर

प्रश्न: मैं कैसे एंटीग्रेविटी CLI में एक API कुंजी हेडर के साथ एक दूरस्थ MCP सर्वर जोड़ूं?

agy mcp add -H "x-api-token: YOUR_KEY" scrapeless https://api.scrapeless.com/mcp चलाएँ, या serverUrl और headers वस्तु के साथ एक प्रविष्टि को ~/.gemini/config/mcp_config.json में जोड़ें। फ्लैग्स को सर्वर नाम से पहले आना चाहिए।
प्रश्न: क्या Antigravity CLI MCP हेडर में पर्यावरण चर का विस्तार करता है?

इस सेटअप में नहीं। ${SCRAPELESS_API_KEY} का एक हेडर मूल्य अक्षरशः पाठ के रूप में भेजा गया, और उपकरण कॉल 401 के साथ विफल रहा जबकि रन ने सफलता की रिपोर्ट की। कुंजी को फ़ाइल में डालें और फ़ाइल की अनुमतियों को सीमित करें।

प्रश्न: क्यों agy प्रिंट मोड में मेरे MCP उपकरण कॉल को अस्वीकार करता है?

MCP उपकरण डिफ़ॉल्ट रूप से पूछें मोड में चलते हैं, और प्रिंट मोड संकेत नहीं दिखा सकता, इसलिए कॉल स्वचालित रूप से अस्वीकृत है और denied_actions के अंतर्गत सूचीबद्ध है। mcp(server/tool) को permissions.allow में ~/.gemini/antigravity-cli/settings.json में जोड़ें।

प्रश्न: क्या agy mcp सूची में सक्षम का मतलब है कि कनेक्शन काम करता है?

नहीं। इसका मतलब है कि प्रविष्टि मौजूद है और अक्षम नहीं है। एक उपकरण कॉल जो पृष्ठ सामग्री को लौटाता है, यह जांचने के लिए है।

प्रश्न: क्या मैं इसके लिए Gemini CLI का उपयोग कर सकता हूँ?

Gemini CLI अब व्यक्तिगत Google खातों की सेवा नहीं करता, जिसे Google अब Antigravity की ओर निर्देशित करता है। Antigravity CLI ~/.gemini/config/mcp_config.json से MCP सर्वरों को पढ़ता है।

प्रश्न: Scrapeless Antigravity CLI में कितने उपकरण जोड़ता है?

25: तीन scrape_* उपकरण, सोलह browser_* उपकरण, तीन crawl_* उपकरण, साथ ही google_search, google_trends और ai_scraper।