# FlashData MCP

अपने एजेंट Google Search और YouTube टूल को दें। अपने मेजबान को कनेक्ट करें, फिर अपने पहले परिणाम के लिए पूछें।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/integrations/mcp-clients
समीक्षित: 2026-11-05 द्वारा FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — आधिकारिक MCP सर्वर
- [MCP संदर्भ](https://flashdata.dev/hi/docs/mcp/reference.md) — उपकरण, मापदंडों और प्रतिक्रियाओं
- [API कुंजी लें](https://flashdata.dev/app/api-keys) — मेजबानों के लिए जो हेडर प्रमाणीकरण का उपयोग करते हैं

<a id="connect"></a>

## 1. कनेक्ट करें और साइन इन करें

ब्राउज़र-आधारित OAuth के लिए Codex या OpenClaw चुनें। एक अन्य होस्ट के लिए, रिमोट / API कुंजी चुनें यदि यह स्ट्रीमिंग HTTP और कस्टम हेडर, या स्थानीय / stdio का समर्थन करता है, तो यह MCP प्रक्रियाओं को लॉन्च करता है। होस्ट किए गए सर्वर को स्थानीय स्थापना की आवश्यकता नहीं है।

### Codex

~/.codex/config.toml में नीचे की कॉन्फ़िगरेशन को मर्ज करें, फिर लॉगिन कमांड चलाएं। ब्राउज़र में FlashData साइनअप या साइन-इन और सहमति को पूरा करें। लॉगिन के बाद एक नया Codex सत्र शुरू करें।

#### config.toml

```toml
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"

[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"
```

#### साइन इन करें

```bash
codex mcp login flashdata --scopes mcp:research
```


### OpenClaw

इन कमांडों को OpenClaw प्रोफ़ाइल में अपने एजेंट का उपयोग करता है। ब्राउज़र में साइनअप या साइन-इन और सहमति पूरी करें, फिर एक नया सत्र शुरू करें। डॉक्टर जांच सहेजे गए कनेक्शन की जांच करता है।

#### कॉन्फ़िगर करें, साइन इन करें और चेक करें · Bash / PowerShell 7

```bash
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


### रिमोट / API कुंजी

Google Search अनुमति के साथ एक कुंजी बनाएं, या एक का पुन: उपयोग करें। नीचे दिए गए क्षेत्रों का उपयोग करके अपने होस्ट के MCP सेटिंग्स में एक सर्वर जोड़ें। कुंजी को अपने संरक्षित हेडर क्षेत्र में रखें और फिर से कनेक्ट करें; कोई OAuth कमांड की आवश्यकता नहीं है।

#### MCP सेटिंग्स

```text
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEY
```

- [एक API कुंजी बनाएँ](https://flashdata.dev/app/api-keys)

### स्थानीय / stdio

Node.js 22.18+ की आवश्यकता है और API कुंजी Google Search अनुमति के साथ है। इसे एक मेजबान में मिलाएं जो mcpServers JSON का समर्थन करता है। अपने स्थानीय संरक्षित विन्यास में YOUR_API_KEY को बदलें, फिर मेजबान को फिर से शुरू करें। npx.cmd का उपयोग Windows पर किया जाता है यदि मेजबान को निष्पादन योग्य फ़ाइल नाम की आवश्यकता होती है।

पिन्ड npm पैकेज स्थानीय MCP सर्वर चलाता है। स्टैंडअलोन FlashData CLI एक अलग निष्पादन योग्य है।

#### MCP विन्यास

```json
{
  "mcpServers": {
    "flashdata": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=@flashdata-dev/mcp@0.2.0",
        "flashdata-mcp"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

- [एक API कुंजी बनाएँ](https://flashdata.dev/app/api-keys)
- [स्थानीय सर्वर प्रलेखन](https://github.com/flashdatadev/flashdata-mcp)


<a id="sign-in"></a>

## 2. कनेक्शन की जाँच करें

इसे एक ताजा एजेंट सत्र में भेजें। सफल get_pricing और get_balance कॉल की उम्मीद करें, google_search और आपके उपलब्ध क्रेडिट संतुलन के लिए एक उपलब्ध कीमत है। एक शून्य संतुलन का मतलब है कि आपको खोज के लिए क्रेडिट की आवश्यकता है; इसका मतलब प्रमाणीकरण विफल नहीं है।

### कनेक्शन की जांच

```text
मौजूदा flashdata MCP कनेक्शन का उपयोग करें।
{"source":"google_search","request_count":1} के साथ get_pricing को कॉल करें।
{} के साथ get_balance को कॉल करें।
रिपोर्ट करें कि क्या दोनों कॉल सफल हुए हैं, क्या स्रोत में एक उपलब्ध कीमत है, क्या है?
और उपलब्ध क्रेडिट शेष राशि। शून्य शेष एक प्रमाणीकरण विफलता नहीं है।
एक खोज या डाउनलोड न करें, परीक्षण करें, या क्रेडेंशियल बदलें।
```


<a id="task"></a>

## 3. अपने पहले काम के लिए पूछो

इसे अपने कनेक्टेड एजेंट में पेस्ट करें। शेष और मूल्य निर्धारण की जाँच नि:शुल्क है; खोज खाता क्रेडिट का उपयोग करती है।

### पहला कार्य शीघ्र

```text
मेरी शेष राशि और एक Google खोज की कीमत की जांच के लिए FlashData का उपयोग करें। यदि पर्याप्त क्रेडिट हैं, तो क्वेरी "battery recycling research", संख्या 5 और मोड "realtime" के साथ एक बार google_search कॉल करें। रिटर्न खिताब, स्रोत URLs, लघु अंश और वास्तविक क्रेडिट का इस्तेमाल किया। इस कार्य के बाद बंद करो।
```


<a id="result"></a>

### परिणाम जाँचें

आपके एजेंट को स्रोत लिंक और अंश वापस करना चाहिए, साथ ही साथ उपयोग किए जाने वाले वास्तविक क्रेडिट भी शामिल हैं। अंतर्निहित खोज परिणाम में status: done और results[].organic. है एक खाली परिणाम मान्य है; एजेंट को इसकी रिपोर्ट करनी चाहिए। नीचे का उदाहरण स्पष्ट है।

#### उदाहरण

```text
एक Google खोज को पूरा किया।
1. बैटरी रीसाइक्लिंग अनुसंधान - https://example.org/recycling
   एक उदाहरण खोज अंश।
क्रेडिट्स का इस्तेमाल किया: 0.02
```


<a id="tools"></a>

## उपलब्ध उपकरण

API-key कॉल उस कुंजी को दी गई अनुमतियों का उपयोग करते हैं। पूर्ण वर्तमान सूची के लिए सर्वर के उपकरण और इनपुट स्कीमा की खोज करें।

| कार्य | उपकरण | प्रवेश |
| --- | --- | --- |
| खोज Google | google_search | mcp:research / API key |
| YouTube वीडियो खोजें | youtube_search | mcp:research / API key |
| वीडियो मेटाडाटा | youtube_metadata | mcp:research / API key |
| मौजूदा कैप्शन को पुनर्प्राप्त करें | youtube_transcript | mcp:research / API key |
| वीडियो या ऑडियो डाउनलोड | youtube_download | मालिक API कुंजी + गंतव्य भंडारण |
| खाते और मूल्य निर्धारण की जाँच करें | get_balance, get_pricing, get_limits, get_usage | फ्री खाता पढ़ता |

- [सभी उपकरण और पैरामीटर](https://flashdata.dev/hi/docs/mcp/reference.md#parameters)
- [सेटअप डाउनलोड करें](https://flashdata.dev/hi/docs/guides/youtube-download-guide/reference.md)

<a id="authentication"></a>

## लगभग OAuth, अनुमतियों और परीक्षणों

OAuth अपने सत्यापित मालिक खाते को जोड़ता है और होस्ट स्टोर को ताज़ा करने देता है। mcp:research अनुदान में उपरोक्त चार शोध सूत्र शामिल हैं। API-key कनेक्शन एक संरक्षित X-API-Key हेडर का उपयोग करते हैं और इसमें अन्य अधिकृत स्रोत शामिल हो सकते हैं।

एक खाता बनाने से पहले FlashData को आज़माने के लिए, CLI परीक्षण प्रवाह का उपयोग करें। MCP OAuth एक मालिक खाता कनेक्ट करता है; यह एक परीक्षण को पंजीकृत या दावा नहीं करता है। एक CLI प्रोफाइल स्वचालित रूप से अपने MCP होस्ट के साथ साझा नहीं किया गया है।

- [एक एजेंट परीक्षण शुरू करें](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md#access)
- [दावा और क्रेडेंशियल हैंडऑफ़](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md#claim)
- [पुन: उपयोग की गई पहुँच](https://flashdata.dev/hi/docs/guides/agent-access/reference.md#refresh)
- [पहुँच रद्द करें](https://flashdata.dev/hi/docs/guides/agent-access/reference.md#revoke)

<a id="errors"></a>

## समस्या निवारण

| समस्या | इसे आज़माएं |
| --- | --- |
| नहीं FlashData उपकरण | सहमति समाप्त करें, फिर से कनेक्ट करें और एक नया सत्र शुरू करें। URL और स्ट्रीम करने योग्य HTTP परिवहन की जाँच करें। |
| invalid_client / callback error | Codex या OpenClaw के लिए, अपने सटीक क्लाइंट कॉन्फ़िगरेशन और एक ब्राउज़र का उपयोग करें जो स्थानीय कॉलबैक तक पहुंच सकता है। एक अन्य होस्ट के लिए, इसके समर्थित API-key या stdio सेटअप का उपयोग करें। |
| 401 | फिर से कनेक्ट समाप्त हो गया या OAuth पहुँच को रद्द कर दिया गया, या मेजबान को आपूर्ति की गई API कुंजी की जाँच करें। मुफ्त चेक दोहराएं। |
| 403 | अनुरोधित स्रोत और कुंजी अनुमतियों की जाँच करें। YouTube Download को youtube_download और गंतव्य भंडारण के साथ एक मालिक API कुंजी की आवश्यकता होती है; mcp:research इसमें शामिल नहीं है। |
| 402 | Billing और वर्तमान मूल्य की जाँच करें। एक वैध क्रेडेंशियल को फिर से कनेक्ट करने से क्रेडिट नहीं मिला है। |
| 429 | Retry-After का पालन करें। किसी भी मौजूदा नौकरी को रखने या परिणाम देने से पहले ID यह तय करने के लिए कि क्या कार्य को फिर से ले जाना है। |
| टाइमआउट या अपूर्ण प्रतिक्रिया | अनुरोध ID रखें और History को चेक करें। खोज को दोहराने के बजाय get_result के साथ बड़े-रिज़ल्ट निरंतरता पढ़ें। |

- [Billing](https://flashdata.dev/app/billing)
- [अनुरोध इतिहास](https://flashdata.dev/app/jobs)

<a id="client"></a>

## आगे बढ़ें

- [एक कस्टम MCP क्लाइंट बनाएं](https://flashdata.dev/hi/docs/guides/mcp-custom-client/reference.md)
- [Codex सेटअप विवरण](https://flashdata.dev/hi/docs/integrations/codex/reference.md)
- [OpenClaw सेटअप विवरण](https://flashdata.dev/hi/docs/integrations/openclaw/reference.md)
- [नियमित काम](https://flashdata.dev/hi/docs/guides/recurring-tasks/reference.md)
