API और इंटीग्रेशन

मौजूदा Agent में Parallel Search MCP जोड़ें: बिना Search Key वेब खोज, पेज फ़ेच और लागत सीमाएँ

मौजूदा coding या research Agent में hosted वेब खोज और मूल पेज पढ़ने की सुविधा जोड़ने की सत्यापित प्रक्रिया। पहले बिना search API key के anonymous endpoint से जुड़ें, फिर server status, web_search/web_fetch tool calls और source URLs जाँचें। साथ ही anonymous सीमा, Bearer/OAuth, Parallel billing, client plan और model API token cost को अलग रखें।

BetterToken

संपादकीय टीम

12 अक्टू॰ 20268 मिनट पढ़ने में

विषय-सूची

मौजूदा Agent में Parallel Search MCP जोड़ें: बिना Search Key वेब खोज, पेज फ़ेच और लागत सीमाएँ

Parallel Search MCP को किसी मौजूदा coding या research Agent में जोड़ने के लिए अपना search server चलाना या अलग search API Key लेना जरूरी नहीं है। Hosted Streamable HTTP endpoint https://search.parallel.ai/mcp Agent को दो tools देता है: web_search और web_fetch।

सिर्फ config सेव हो जाना सफलता नहीं है। सही जाँच में server connection, tool discovery, conversation में वास्तविक tool-call event और result में खुलने वाले source URLs — चारों दिखाई देने चाहिए। नीचे दिए गए तथ्य 11 अक्टूबर 2026 को खोले गए आधिकारिक दस्तावेज़ों पर आधारित हैं; अंतिम प्रमाण आपके client logs और account billing में होगा।

पहले endpoint और authentication mode चुनें

उद्देश्य	Endpoint	Authentication	उपयोग
Search और fetch का छोटा परीक्षण	`https://search.parallel.ai/mcp`	नहीं	Anonymous, हल्का उपयोग और कम rate limits
Account credits और अधिक limits	`https://search.parallel.ai/mcp`	Bearer API Key	नियमित या production workload
Browser आधारित sign-in	`https://search.parallel.ai/mcp-oauth`	OAuth या Bearer API Key	Shared config में स्थायी key न रखने के लिए

Default /mcp endpoint OAuth advertise नहीं करता, इसलिए OAuth समर्थित client भी बिना browser खोले anonymous रूप से जुड़ सकता है। /mcp-oauth authentication मांगता है और anonymous request पर 401 देता है। इसलिए /mcp पर login prompt न आना failure नहीं है; /mcp-oauth पर 401 का अर्थ अक्सर अधूरा authorization है।

Client, web tool और model provider को अलग रखें

एक उत्तर में तीन स्वतंत्र connections हो सकते हैं:

Agent client conversation, permissions और tool selection संभालता है।
Parallel Search MCP web_search और web_fetch चलाता है।
Model provider reasoning करता है और input, output तथा tool-result context के tokens गिनता है।

MCP जोड़ने से model Base URL नहीं बदलता। Model API बदलने से web search अपने-आप नहीं मिलता। Troubleshooting में अलग-अलग पूछें: क्या MCP connected है, क्या सही tool वास्तव में call हुआ, और model request की billing किस provider ने की?

Claude Code में anonymous setup

अपने Claude Code project के directory से चलाएँ:

claude mcp add --transport http "Parallel-Search-MCP" https://search.parallel.ai/mcp
claude mcp get "Parallel-Search-MCP"
claude mcp list

Default scope local होता है। सभी projects के लिए जानबूझकर enable करना हो तो --scope user जोड़ें। Team project के .mcp.json को commit करने से पहले review करें और उसमें fixed bearer token न रखें।

Claude Code के अंदर MCP panel खोलें:

/mcp

CLI का Added message केवल बताता है कि configuration लिखी गई। उपयोगी signal Connected status है, जो बताता है कि वर्तमान client server तक पहुँच रहा है। OAuth चाहिए तो URL को बदलें:

https://search.parallel.ai/mcp-oauth

और /mcp से authorization पूरा करें। /mcp तथा /mcp-oauth की समस्याओं को एक ही case न मानें।

Codex CLI में तीन विकल्प

Anonymous setup:

codex mcp add parallel-search --url https://search.parallel.ai/mcp
codex mcp list

Account-backed limits के लिए PARALLEL_API_KEY को operating system या secret manager में सुरक्षित रखें। वास्तविक key को shell history या shared config में लिखे बिना Codex को environment variable का नाम दें:

codex mcp add parallel-search --url https://search.parallel.ai/mcp \
  --bearer-token-env-var PARALLEL_API_KEY
codex mcp list

OAuth setup:

codex mcp add parallel-search --url https://search.parallel.ai/mcp-oauth
codex mcp list

Server जोड़ने के बाद नया Codex session शुरू करें। दूसरे MCP clients में वही endpoint चल सकता है, पर config schema अलग होता है: VS Code में top-level servers, Cursor में अक्सर mcpServers, और कुछ clients में type: "streamable-http" चाहिए। एक client का JSON बिना जाँच दूसरे में paste न करें।

प्रमाणित करें कि वास्तव में कौन-सा tool चला

Connected status केवल reachability साबित करता है, किसी खास answer में tool usage नहीं। ऐसा test prompt दें जो observable evidence छोड़े:

इस जाँच में Parallel-Search-MCP का उपयोग अनिवार्य है; memory से उत्तर मत दो।
1. web_search call करके आधिकारिक Parallel Search MCP documentation और वर्तमान pricing page खोजो।
2. web_search से मिले source URLs दिखाओ।
3. दो official URLs चुनकर web_fetch से उनका मूल text पढ़ो।
4. हर source के लिए tool name, URL और एक छोटा supporting passage दो।
कोई tool call fail हो तो रुक जाओ और tool name, endpoint तथा HTTP status बताओ।

इसके बाद चार बातें देखें:

tool trace में web_search event है;
उसके बाद अलग web_fetch event है, केवल search snippet का सार नहीं;
result में वास्तविक और खुलने वाले URLs हैं;
final claim fetched page के text में मिलता है।

“I searched the web” जैसा वाक्य प्रमाण नहीं है। Client में built-in web search अस्थायी रूप से disable किया जा सकता हो तो केवल इस isolated test में बंद करें, ताकि समान capability वाले tools भ्रम न पैदा करें।

पहले search, फिर original page fetch

Official tool roles स्पष्ट हैं:

web_search current information और multiple sources खोजता है। इसमें objective और search_queries required हैं।
web_fetch known URLs या चुने हुए search results पढ़ता है। एक request में अधिकतम 20 URLs लिए जा सकते हैं।

Client arguments पर प्रभाव डालने देता हो तो यह pattern अपनाएँ:

objective में एक decision रखें, जैसे “official anonymous authentication और cost boundaries verify करना।”
दो या तीन छोटे complementary search_queries दें; पूरा prompt हर query में न डालें।
एक conversation में वही session_id reuse करें और नई conversation के लिए नया value बनाएँ।
शुरुआत full_content: false से करें। पूरा page tens of thousands model tokens ले सकता है और client output limit पार कर सकता है।
Official docs, specifications और original announcements को प्राथमिकता दें। Community post को user report कहें, universal behavior नहीं।

Search → URL चुनना → original fetch करना → citation verify करना, केवल “इंटरनेट पर देखो” कहने से अधिक audit योग्य प्रक्रिया है।

लागत सीमाएँ: कम से कम चार अलग खाते

नीचे के मूल्य 11 अक्टूबर 2026 को Parallel के आधिकारिक pricing page से जाँचे गए। यह boundary समझाने के लिए है, “हमेशा सस्ता” घोषित करने के लिए नहीं।

Cost layer	Subscription या membership	Minimum top-up	First-month allowance	Usage basis
Anonymous Search MCP	Documented anonymous setup में account subscription required नहीं	Anonymous शुरुआत के लिए top-up required नहीं	Fixed call count publish नहीं किया गया	Exploration/light use के लिए free बताया गया है, पर rate limits कम हैं
Authenticated Parallel Search/Extract	Public pricing page पर अलग membership fee नहीं दी गई	Public pricing page पर नहीं बताया गया	Fixed introductory credit नहीं बताया गया	Search base price (हर request में 10 results शामिल): `fast`/`turbo` प्रति 1,000 requests US$1; `basic`/`advanced` US$5; additional page results और excerpts प्रति 1,000 results US$1; Extract प्रति 1,000 URLs US$1
Agent client	Claude Code, Codex या दूसरे client के plan पर निर्भर	Client-specific	Client-specific	Client plan benefit, Parallel credit नहीं है
Model API	Provider-specific	Provider-specific	Provider-specific	Model input, output, cache और tool-result context की billing Search MCP से अलग है

Search MCP page anonymous mode के लिए कोई fixed numeric quota publish नहीं करता। “Lower rate limits” को अपनी ओर से “हर दिन N free calls” में न बदलें। General Search API rate-limit table भी anonymous MCP guarantee नहीं है।

Authenticated call पर 402 आए तो Parallel documentation इसे insufficient credits से जोड़ती है। पहले balance और active connection mode जाँचें; लगातार retry न करें।

BetterToken model provider हो तो दोनों configs अलग रखें

Claude Code या Codex पहले से BetterToken से model calls भेजता हो, तो वही client रखें और Parallel को अलग web-tool layer की तरह जोड़ें:

Claude Code के लिए model Base URL https://bettertoken.ai है; client /v1/messages जोड़ता है, इसलिए /v1 खुद न लगाएँ।
Codex के लिए model Base URL https://www.bettertoken.ai/v1 है और wire_api = "responses" रहता है।
Parallel tool URL https://search.parallel.ai/mcp या https://search.parallel.ai/mcp-oauth ही रहता है।

इन URLs का काम अलग है। BetterToken model API और token usage संभालता है; Parallel web tools संभालता है। Anonymous availability, credits, privacy और limits third-party service के नियम रहते हैं। अलग-अलग Claude Code guide, Codex guide और Parallel Search MCP docs देखें।

सामान्य failure और न्यूनतम retest

लक्षण	पहले क्या जाँचें	Fix के बाद retest
Server जुड़ा है, tools नहीं दिखते	Client पूरा restart करें; config syntax और exact URL देखें; MCP logs खोलें	`web_search` और `web_fetch` दोनों दिखें
`401`	`/mcp-oauth` तो नहीं; OAuth पूरा हुआ; bearer valid है	Reconnect पर authentication warning हटे
`402`	Authenticated account credits	Funds जोड़ें या anonymous `/mcp` पर लौटकर focused search करें
Connected, पर tool call नहीं	Agent built-in search या memory चुन रहा हो सकता है	Forced test prompt चलाएँ और trace देखें
Fetch बहुत बड़ा या कट गया	`full_content`, URL count और broad `objective`	Full content बंद करें और केवल जरूरी pages fetch करें
Projects में अलग behavior	Claude Code scope, project approval या पुराना Codex session	Target project में server list और forced call दोहराएँ

लंबे समय के लिए कब रखें

यह integration तब उपयोगी है जब hosted search और original-page reading चाहिए, self-hosted search stack maintain नहीं करना, client tool calls तथा sources दिखाता है, और anonymous limit हल्के काम के लिए पर्याप्त है या authenticated usage का budget बनाया जा सकता है।

सीधे production में न जाएँ जब fixed free-call guarantee जरूरी हो, anonymous रहते हुए organization-level attribution या Zero Data Retention चाहिए, वास्तविक tool calls नहीं दिखते, या indexing, crawling और data residency पर पूर्ण control चाहिए।

सुरक्षित क्रम यह है: पहले anonymous /mcp से representative tasks चलाएँ, tool traces और source URLs बचाएँ, rate-limit behavior तथा model-token growth देखें। Anonymous सीमा सच में बाधा बने तभी Bearer या /mcp-oauth अपनाएँ। इससे connection, retrieval quality, Parallel usage और model cost अलग-अलग मापे जा सकते हैं।