Warp + Scrapeless: एक दूरस्थ MCP सर्वर से कनेक्ट करें

TL;DR:

• Warp Scrapeless के रूप में एक दूरस्थ MCP सर्वर के साथ स्ट्रीम करने योग्य HTTP के माध्यम से कनेक्ट करता है। आपके प्रोजेक्ट रूट पर एक .warp/.mcp.json फ़ाइल जिसमें एक url और एक x-api-token हेडर है, पूरे कॉन्फ़िगरेशन है।
• ${SCRAPELESS_API_KEY} लिखें, ब्रैकेट शामिल हैं। Warp उस फ़ॉर्म का विस्तार करता है जब यह फ़ाइल को पढ़ता है। $SCRAPELESS_API_KEY और {{SCRAPELESS_API_KEY}} Scrapeless तक शाब्दिक पाठ के रूप में पहुँचते हैं, और सर्वर /mcp में अभी भी स्वस्थ दिखाई देता है।
• एक unset वेरिएबल पूरी फ़ाइल को बंद कर देता है। इसमें प्रत्येक सर्वर को Warp config error … Missing or empty environment variable: SCRAPELESS_API_KEY से प्रतिस्थापित किया गया है।
• प्रोजेक्ट सर्वर हाथ से शुरू होते हैं। /mcp खोलें, scrapeless का चयन करें और Enter दबाएँ; पंक्ति offline से running · 25 tools में स्थानांतरित होती है।
• running · 25 tools कुंजी को प्रमाणित नहीं करता है। एक बनाई गई कुंजी समान स्थिति तक पहुँचती है। एक उपकरण कॉल, या कदम 5 में संक्षिप्त जांच, एक मान्य कुंजी को एक अमान्य से अलग करती है।
• हेडर नाम x-api-token है। एक Authorization: Bearer प्रविष्टि "कॉन्फ़िगर की गई क्रेडेंशियल्स (HTTP 401) को अस्वीकार कर दिया" के साथ विफल होती है, भले ही स्वयं टोकन मान्य हो।
• Scrapeless मुफ्त योजना पर एक कुंजी प्राप्त करें और कुछ ही मिनटों में सर्वर जोड़ें।

Warp एजेंट वास्तविक टर्मिनल में आदेश चलाता है और आपके कोड को पढ़ता है, फिर भी इसकी वर्तमान में वेब पृष्ठ कैसे दिखता है, इसकी कोई दृष्टि नहीं है। एक MCP सर्वर उस अंतर को बंद करता है: उपकरण जो एजेंट कार्य-काल में कॉल करता है, एक सेवा द्वारा उत्तर दिया जाता है जो इसके लिए पृष्ठ खींचता और प्रस्तुत करता है।

यह गाइड होस्टेड Scrapeless MCP सर्वर को Warp एजेंट CLI, warp बाइनरी में जोड़ता है। कॉन्फ़िगरेशन कुछ पंक्तियों का JSON है। यह काम करता है या नहीं, यह तीन विवरणों पर निर्भर करता है: Warp किस फ़ाइल को पढ़ता है, कुंजी को भीतर कैसे संदर्भित किया गया है, और /mcp स्थिति लाइन क्या बताती है और क्या नहीं बताती है।

What Scrapeless Adds to a Warp Agent Session

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

• scrape_markdown, scrape_html और scrape_screenshot एक कॉल में Markdown, कच्चे 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 से उत्तर capture करता है।

इसके लिए आपके मशीन पर कुछ नहीं चलता है। MCP स्ट्रीम योग्य HTTP ट्रांसपोर्ट एकल HTTPS एंडपॉइंट है जो JSON-RPC को POST के माध्यम से लेता है, और Warp इसे स्वाभाविक रूप से बोलता है। इसका MCP लॉग इस सर्वर के लिए MCP: Using Streaming HTTP transport को किसी भी ट्रांसपोर्ट सेटिंग के बिना फ़ाइल में रिकॉर्ड करता है।

Where Warp Looks for MCP Server Definitions

Warp सर्वर परिभाषाएँ कॉन्फ़िगरेशन फ़ाइलों से और इसके सेटिंग पृष्ठ से पढ़ता है। Warp का MCP दस्तावेज़ इन स्थानों की सूची बनाता है:

किसी भी प्रदाता से प्रोजेक्ट-स्कोप सर्वर स्वयं शुरू नहीं होते हैं। Warp उन्हें बताता है और आपसे प्रत्येक को शुरू करने की प्रतीक्षा करता है, और यह चयन केवल सत्र के लिए रहता है, इसलिए पुनरारंभ के बाद आपको उन्हें फिर से शुरू करना होगा।

CLI का भी Warp ऐप से अलग कॉन्फ़िगरेशन होता है। Warp एजेंट CLI कॉन्फ़िगरेशन पृष्ठ macOS पर उस फ़ाइल के रूप में ~/.warp_cli/.mcp.json देती है। Linux पर, Warp एजेंट CLI v0.2026.09.09.08.26.stable_02 ने ~/.warp_cli/.mcp.json या ~/.warp/.mcp.json से सर्वर नहीं पकड़ा, जबकि इसने सभी तीन प्रोजेक्ट-स्कोप फ़ाइलों को खोजा और उन्हें Warp (.warp/.mcp.json), Claude (.mcp.json) और Other Agents (.agents/.mcp.json) के रूप में लेबल किया। यह गाइड .warp/.mcp.json का उपयोग करता है, वह फ़ाइल जिसे Warp अपनी फ़ाइल के रूप में नामित करता है।

यदि आप Warp डेस्कटॉप ऐप में काम कर रहे हैं, तो वही mcpServers JSON सेटिंग्स > एजेंट्स > MCP सर्वर में + जोड़ें बटन के माध्यम से जाता है।

Prerequisites

• Warp खाता के साथ साइन इन किया गया Warp एजेंट CLI। यह गाइड संस्करण v0.2026.09.09.08.26.stable_02 का उपयोग करता है, जो warp --version प्रिंट करता है।
• उस Warp खाते में AI क्रेडिट, उस चरण के लिए जहां एजेंट एक उपकरण कॉल करता है।
• Scrapeless डैशबोर्ड से Scrapeless API कुंजी।
• कॉन्फ़िगरेशन फ़ाइल रखने के लिए एक प्रोजेक्ट फ़ोल्डर। यहां के परीक्षणों ने एक Git रिपोजिटरी का उपयोग किया।

Step 1: Add .warp/.mcp.json to Your Project

प्रोजेक्ट रूट में .warp/.mcp.json बनाएं:

{
  "mcpServers": {
    "scrapeless": {
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "${SCRAPELESS_API_KEY}"
      }
    }
  }
}

एक यूआरएल सर्वर वार्प में दो प्रॉपर्टीज़ लेता है: url, जो अनिवार्य है, और headers, एक की-वैल्यू ऑब्जेक्ट जो सामान्यतः वैकल्पिक है और यहां आवश्यक है, क्योंकि स्क्रैपलेस हर अनुरोध को x-api-token हेडर द्वारा प्रमाणित करता है। सेट करने के लिए कोई type फ़ील्ड नहीं है।

फाइल एक वैरिएबल संदर्भ को रखती है, न कि एक की, इसलिए यह संस्करण नियंत्रण में रह सकती है। प्रत्येक व्यक्ति जो प्रोजेक्ट को खोलता है, वह अपनी खुद की की का निर्यात करता है। यह क्रेडेंशियल को रिपॉजिटरी से बाहर रखता है, जिसे OWASP सीक्रेट्स प्रबंधन मार्गदर्शन एक ऐसे स्थान के रूप में मानता है जहाँ एक गुप्त वस्तु कभी नहीं होनी चाहिए।

चरण 2: सही प्लेसहोल्डर के साथ की का निर्यात करें

उस शेल में वैरिएबल का निर्यात करें जो वार्प शुरू करता है, फिर प्रोजेक्ट फ़ोल्डर से CLI लॉन्च करें:

export SCRAPELESS_API_KEY="your-scrapeless-api-key"
cd path/to/your-project
warp

वार्प ${VAR} संदर्भों का विस्तार करता है जब यह डिस्क से एक कॉन्फ़िग फ़ाइल पढ़ता है। रूप महत्वपूर्ण है, और गलत रूप चुपचाप विफल हो जाता है। नीचे प्रत्येक भिन्नता को एक स्थानीय लॉगिंग प्रॉक्सी के माध्यम से भेजा गया ताकि यह देखा जा सके कि वास्तव में स्क्रैपलेस तक क्या पहुंचा:

दूसरी और तीसरी पंक्तियाँ जाल हैं। वे एक कार्यशील सेटअप की तरह बिल्कुल दिखती हैं जब तक कि एजेंट के पहले उपकरण कॉल का परिणाम प्रमाणीकरण विफलता नहीं होती।

निर्यात न किए गए मामले में शोर है, लेकिन यह एक सर्वर से आगे पहुंचता है। वार्प पूरी फ़ाइल को अस्वीकृत कर देता है और इसमें परिभाषित प्रत्येक सर्वर के स्थान पर एकल त्रुटि पंक्ति सूचीबद्ध करता है:

Warp config error  /path/to/your-project/.warp/.mcp.json · Missing or empty environment variable: SCRAPELESS_API_KEY

परीक्षण में, उसी फ़ाइल में परिभाषित एक दूसरा, वैध सर्वर भी सूची से गायब हो गया। अपने शेल प्रोफ़ाइल में या वह जहां भी आपके टर्मिनल सत्रों को लॉन्च करता है, वहां वैरिएबल का निर्यात करें, ताकि प्रत्येक warp प्रक्रिया इसे विरासत में ले सके।

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

चरण 3: /mcp से सर्वर शुरू करें

CLI इनपुट में /mcp टाइप करें ताकि MCP प्रबंधन दृश्य खुल सके, फिर इसके खोज बॉक्स में scrapeless टाइप करें। पंक्ति प्रदाता लेबल, प्रोजेक्ट और ट्रांसपोर्ट का नाम देती है:

scrapeless  Warp · scrapeless-demo · HTTP/SSE · offline

पंक्ति पर Enter दबाएं। कुछ सेकंडों के भीतर, वार्प MCP हैंडशेक चलाता है, उपकरणों को सूचीबद्ध करता है और पंक्ति को अपडेट करता है:

scrapeless  Warp · scrapeless-demo · HTTP/SSE · running · 25 tools

एक चल रही पंक्ति पर Enter दबाने से सर्वर रुक जाता है। क्योंकि प्रोजेक्ट-स्कोप्ड सर्वर सत्र-स्कोप्ड होते हैं, इसलिए इस स्टार्ट को दोहराएं जब भी आप उस प्रोजेक्ट में CLI खोलते हैं।

चरण 4: आप प्रॉम्प्ट करने से पहले स्थिति पढ़ें

/mcp में प्रत्येक स्थिति एक अलग समाधान की ओर इशारा करती है:

failed पंक्ति पर करीब से ध्यान देने की आवश्यकता है, क्योंकि इसकी सलाह कारण की ओर इशारा नहीं करती। Authorization: Bearer ${SCRAPELESS_API_KEY} को हेडर के रूप में लेकर, वार्प लॉग करता है:

[error] MCP: Failed to connect to server: Transport creation error: MCP server 'scrapeless' rejected the configured credentials (HTTP 401). The request included the credential header(s) you configured, so the server did not accept that value — check the token itself, its expiry, and its scope. The server did not ask for OAuth.

उस अनुरोध में टोकन मान्य था। स्क्रैपलेस ने अनुरोध को अस्वीकृत कर दिया क्योंकि हेडर नाम गलत था, और इसकी प्रतिक्रिया बॉडी यह कहती है: Unauthorized: Missing x-api-token header। हेडर का नाम बदलें और की को अनछुआ रखें।

वार्प लिनक्स पर ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/mcp के तहत प्रत्येक सर्वर स्टार्ट के लिए एक लॉग फ़ाइल लिखता है। प्रत्येक फ़ाइल एक याददाश्त के साथ खुलती है कि इसमें संवेदनशील जानकारी जैसे API की हो सकती हैं, इसलिए इसे स्थानीय रूप से पढ़ें और साझा करने से पहले इसे संपादित करें।

चरण 5: की की पुष्टि करें, फिर एजेंट को प्रॉम्प्ट करें

25 उपकरणों के साथ एक चल रहा सर्वर केवल यह दिखाता है कि एक हेडर आया। स्क्रैपलेस किसी भी की मूल्य के लिए initialize और tools/list का उत्तर देता है, जिसमें एक बनाई गई भी शामिल है। अंतर tools/call पर प्रकट होता है: एक खराब कुंजी के साथ कॉल अभी भी HTTP 200 लौटाता है, और परिणाम पाठ Failed to fetch data से शुरू होता है।

यह जाँच वही हैंडशेक चलाती है जो वार्प चलाता है और फिर केवल एक बार scrape_markdown कॉल करती है, बिना इसके अलावा कुछ भी उपयोग किए हुए पायथन मानक लाइब्रेरी:

import json
import os
import urllib.request

URL = "https://api.scrapeless.com/mcp"
HEADERS = {
    "Content-Type": "application/json",
    "Accept": "application/json, text/event-stream",
    "x-api-token": os.environ["SCRAPELESS_API_KEY"],
}


def post(payload, session_id=None):
    headers = dict(HEADERS)
    if session_id:
        headers["Mcp-Session-Id"] = session_id
    request = urllib.request.Request(URL, data=json.dumps(payload).encode(), headers=headers)
    with urllib.request.urlopen(request, timeout=120) as response:
        body = response.read().decode()
        session_id = response.headers.get("Mcp-Session-Id") or session_id
    events = [line[5:].strip() for line in body.splitlines() if line.startswith("data:")]
    return session_id, json.loads(events[-1]) if events else None


session, init = post({
    "jsonrpc": "2.0", "id": 1, "method": "initialize",
    "params": {"protocolVersion": "2025-06-18", "capabilities": {},
               "clientInfo": {"name": "key-check", "version": "1.0"}},
})
post({"jsonrpc": "2.0", "method": "notifications/initialized"}, session)
_, result = post({
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {"name": "scrape_markdown", "arguments": {"url": "https://example.com"}},
}, session)

server = init["result"]["serverInfo"]
text = "".join(part.get("text", "") for part in result["result"]["content"])
print(server["name"], server["version"])
if text.startswith("Failed to fetch data"):
    print("key rejected:", text[:60])
else:
    print(f"key accepted: {len(text)} characters of Markdown")

एक वैध कुंजी के निर्यात के साथ, यह प्रिंट करता है:

scrapeless-mcp-server 0.2.0
key accepted: 184 characters of Markdown

एक बार जब कुंजी चेक हो जाती है, तो जब काम एकल फ़ेच होता है, तो सर्वर और उपकरण का नाम दें:

नोट: एजेंट टर्न के लिए आपके वर्प खाते पर एआई क्रेडिट की आवश्यकता है, और इसे इस लेख के लिए नहीं चलाया गया क्योंकि परीक्षण खाते में कोई बचा हुआ नहीं था; वर्प ने उत्तर दिया "आपके पास एआई क्रेडिट समाप्त हो गए हैं।" सर्वर प्रारंभ, हाथ मिलाना और ऊपर की कुंजी जांच समान कॉन्फ़िगरेशन के साथ समान एंडपॉइंट के खिलाफ चली।

Use the scrapeless MCP server's scrape_markdown tool to fetch
https://books.toscrape.com/catalogue/category/books/mystery_3/index.html
and list the first three book titles with their prices.

उस श्रेणी पृष्ठ पर scrape_markdown 8,940 अक्षर लौटाता है जबकि scrape_html 53,800 लौटाता है, इसलिए मार्कडाउन एजेंट के लिए समान सामग्री के लिए संदर्भ का लगभग एक छठा हिस्सा लेता है। जब आपका अपना कोड परिणाम को पार्स करता है तो scrape_html का उपयोग करें और जब एजेंट इसे पढ़ता है तो scrape_markdown का उपयोग करें।

MCP उपकरण कॉल आपके सक्रिय निष्पादन प्रोफ़ाइल का पालन करते हैं। mcp_permissions डिफ़ॉल्ट रूप से agent_decides होता है, और प्रोफ़ाइल का mcp_allowlist और mcp_denylist ऐसे MCP सर्वर आईडी लेते हैं जो अनुमोदन के बिना चल सकती हैं या हमेशा पूछना चाहिए।

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

निष्कर्ष

कनेक्टर .warp/.mcp.json में एक प्रविष्टि है जिसमें तीन शर्तें हैं: शीर्षक का नाम x-api-token है, इसका मान ${SCRAPELESS_API_KEY} है जिसमें ब्रैकेट हैं, और चर warp को शुरू करने वाले शेल में निर्यात किया गया है। इसके बाद, प्रति सत्र एक बार /mcp से सर्वर प्रारंभ करें।

दो परिणामों को देखभाल की आवश्यकता है क्योंकि वे ठीक दिखते हैं। एक गलत प्लेसहोल्डर रूप और एक गलत कुंजी दोनों running · 25 tools दिखाते हैं, और केवल एक उपकरण कॉल उन्हें उजागर करता है। असफलताएं जो दिखती हैं वे अलग पढ़ती हैं: एक बेयरर शीर्षक failed … rejected the configured credentials उत्पन्न करता है, और एक अनिर्धारित चर ऐसी कॉन्फ़िगरेशन त्रुटि उत्पन्न करता है जो फ़ाइल में प्रत्येक सर्वर को छुपा देती है।

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

अक्सर पूछे जाने वाले प्रश्न

प्र: मैं वर्प में एपीआई कुंजी हेडर के साथ एक रिमोट MCP सर्वर कैसे जोड़ूं?

प्रोजेक्ट रूट में .warp/.mcp.json बनाएं जिसमें एक mcpServers प्रविष्टि हो जिसमें url और headers वस्तु हो, उदाहरण के लिए "x-api-token": "${SCRAPELESS_API_KEY}"। चर को निर्यात करें, उस फ़ोल्डर में warp प्रारंभ करें, फिर /mcp से सर्वर प्रारंभ करें। वर्प डेस्कटॉप ऐप में, सेटिंग्स > एजेंट > MCP सर्वर > + जोड़ें के तहत वही JSON पेस्ट करें।

प्र: क्या वर्प MCP हेडर में पर्यावरण चर का विस्तार करता है?

हाँ, ${VAR} रूप में। एक शीर्षक मूल्य ${SCRAPELESS_API_KEY} निर्यातित कुंजी के रूप में सर्वर तक पहुँचा। $SCRAPELESS_API_KEY बिना ब्रैकेट और {{SCRAPELESS_API_KEY}} को लिटरल टेक्स्ट के रूप में भेजा गया।

प्र: मेरा वर्प MCP सर्वर गलत एपीआई कुंजी के साथ चल रहा क्यों दिखाता है?

running · 25 tools का मतलब है कि हाथ मिलाना और उपकरण सूचीकार्यक्षम थे, और स्वच्छ दोनों के लिए किसी भी कुंजी मान के लिए उत्तर देता है। एक गलत कुंजी केवल तब दिखाई देती है जब एक उपकरण चलता है: कॉल Failed to fetch data से शुरू होने वाले पाठ को लौटाता है।

प्र: वर्प क्यों कहता है कि MCP सर्वर ने कॉन्फ़िगर की गई अनुमतियों को अस्वीकार कर दिया?

स्वच्छ के लिए सामान्य कारण शीर्षक का नाम होता है, टोकन नहीं। एक Authorization: Bearer शीर्षक rejected the configured credentials (HTTP 401) उत्पन्न करता है, क्योंकि सर्वर x-api-token की खोज करता है और Missing x-api-token header का उत्तर देता है।

प्र: "वर्प कॉन्फ़िग त्रुटि ... गायब या खाली पर्यावरण चर" का क्या अर्थ है?

फ़ाइल एक चर का संदर्भ देती है जो warp शुरू करने वाले शेल में सेट नहीं है। वर्प पूरी फ़ाइल को अस्वीकार कर देता है, इसलिए इसमें परिभाषित प्रत्येक सर्वर /mcp से गायब हो जाता है जब तक कि आप चर को निर्यात नहीं करते और CLI को फिर से शुरू नहीं करते।

प्र: क्या परियोजना-स्कोप वाले MCP सर्वर वर्प में स्वचालित रूप से प्रारंभ होते हैं?

नहीं। वर्प एक प्रोजेक्ट में .warp/.mcp.json, .mcp.json और .agents/.mcp.json का पता लगाता है लेकिन इनके सर्वरों को offline के रूप में सूचीबद्ध करता है जब तक कि आप प्रत्येक एक को /mcp से शुरू नहीं करते, और वह विकल्प केवल वर्तमान सत्र के लिए रहता है।

प्र: वर्प एजेंट CLI मेरे सर्वर को ~/.warp_cli/.mcp.json से सूचीबद्ध क्यों नहीं करता?

CLI दस्तावेज़ उस पथ को मैकओएस के लिए देते हैं। लिनक्स पर, वर्प एजेंट CLI v0.2026.09.09.08.26.stable_02 ने ~/.warp_cli/.mcp.json या ~/.warp/.mcp.json को नहीं पढ़ा, और /mcp ने No matching MCP servers का उत्तर दिया। प्रोजेक्ट फ़ाइल .warp/.mcp.json का पता लगाया गया था।

प्र: वर्प में स्क्रैपलेस MCP सर्वर कितने उपकरण जोड़ता है?
25: तीन scrape_* उपकरण, सोलह browser_* उपकरण, तीन crawl_* उपकरण, साथ ही google_search, google_trends और ai_scraper.