# FlashData MCP

أعطِ وكيلَكَ Google Search و YouTube أدوات. اتصل بمضيفك، ثم أطلب نتيجة أولى.

مرجع كانوني: https://flashdata.dev/ar/docs/integrations/mcp-clients
Reviewed: 2026-11-05 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Official MCP server
- [MCP](https://flashdata.dev/ar/docs/mcp/reference.md) — الأدوات والبارامترات والاستجابات
- [احصل على مفتاح API](https://flashdata.dev/app/api-keys) — للمضيفين الذين يستخدمون التوثيق الرأسي

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

## 1. الاتصال والتوقيع في

اختر Codex أو OpenClaw لتسجيل OAuth عبر المتصفح. لمضيف آخر، اختر Remote / API key إذا كان يدعم Streamable HTTP والترويسات المخصصة، أو Local / 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
```


### Remote / API المفتاح

إنشاء مفتاح مع Google Search إذن، أو إعادة استخدام واحد. أضف خادم في مضيفك MCP تُستخدم الحقول التالية. وضع المفتاح في حقل رأسها المحمي وإعادة ربطه؛ وليس هناك حاجة إلى قيادة OAuth.

#### MCP settings

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

- [Create an API key](https://flashdata.dev/app/api-keys)

### محلي/مستديو

يتطلب Node.js 22.18+ ومفتاح API بصلاحية Google Search. ادمج هذا في مضيف يدعم JSON من نوع mcpServers. استبدل 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"
      }
    }
  }
}
```

- [Create an API key](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 الموجود.
استدعِ get_pricing باستخدام {"source":"google_search","request_count":1}.
استدعِ get_balance باستخدام {}.
أبلغ عما إذا نجح الاستدعاءان، وما إذا كان للمصدر سعر متاح،
وعن الرصيد المتاح. الرصيد الصفري لا يعني فشل المصادقة.
لا تنفّذ بحثًا أو تنزيلًا، ولا تنشئ تجربة، ولا تغيّر بيانات الاعتماد.
```


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

## 3. أطلبي مهمتك الأولى

استولي على هذا في عميلك المتصل وتُعتبر عمليات التحقق من الرصيد والتسعير مجانية؛ وتستخدم عمليات البحث أرصدة لحسابها.

### المهمة الأولى

```text
استخدم FlashData للتحقق من رصيدي وسعر بحث Google واحد. إذا كان الرصيد كافيًا، استدعِ google_search مرة واحدة مع query بقيمة "battery recycling research" وnum بقيمة 5 وmode بقيمة "realtime". أعد العناوين وروابط المصادر ومقتطفات قصيرة والرصيد المستخدم فعليًا. توقف بعد هذه المهمة.
```


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

### تحقق من النتيجة

ينبغي أن يعيد وكيلك روابط المصادر ومقتطفاتها والرصيد المستخدم فعليًا. تحتوي نتيجة البحث الأساسية status: done وresults[].organic. النتيجة الفارغة صالحة؛ وعلى الوكيل الإبلاغ عنها. المثال أدناه توضيحي.

#### جواب مثال

```text
مكتمل Google البحث.
1. بحوث إعادة تدوير البطاريات - https://example.org/recycling
   مقتطف من البحث
الأرصدة الدائنة المستخدمة: 0.02
```


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

## الأدوات المتاحة

API-المكالمات الرئيسية تستخدم التصاريح الممنوحة لهذا المفتاح إكتشفوا أدوات الخادم وخصائص مدخلاته من أجل الكاتالوج الحالي الكامل

| المهام | Tool | الوصول |
| --- | --- | --- |
| فتش 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/ar/docs/mcp/reference.md#parameters)
- [تجهيز الحمولة](https://flashdata.dev/ar/docs/guides/youtube-download-guide/reference.md)

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

## بشأن OAuth, permissions and trials

OAuth يربط حساب مالكك المتحقق منه ويسمح للمخزن المضيف ويعيد فتح الشيكات وتغطي منحة mcp:research المصادر البحثية الأربعة المذكورة أعلاه. API-الوصلات الرئيسية تستخدم حماية X-API-Key رئيس ويمكن أن يشمل مصادر أخرى مأذون بها.

محاولة FlashData قبل إنشاء حساب، استخدام CLI سير التجربة وتربط شركة MCP OAuth حساباً للمالك؛ وهي لا تسجل أو تطالب بتجربة. ألف CLI لا يُطلع على ملفك تلقائياً MCP مضيف.

- [ابدأ تجربة العميل](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#access)
- [المطالَبَة والتسليم المبتكر](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#claim)
- [Reuse Save access](https://flashdata.dev/ar/docs/guides/agent-access/reference.md#refresh)
- [Revoke access](https://flashdata.dev/ar/docs/guides/agent-access/reference.md#revoke)

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

## اضطرابات

| المشكلة | جرب هذا |
| --- | --- |
| No FlashData tools | إنهاء الموافقة، وإعادة الاتصال، والبدء في دورة جديدة. تحققي من نقل URL وSreamable HTTP. |
| invalid_client / callback error | For Codex أو OpenClawاستخدم تشكيلة عملائه بالضبط و مصفح يمكنه الوصول إلى ردة الفعل المحلية بالنسبة لمضيف آخر، استخدم مركبه المدعوم API-key أو جهاز الاستديو فوق. |
| 401 | وقد انتهت صلاحية إعادة الاتصال أو ألغيت إمكانية وصول OAuth، أو تحقق من مفتاح API الذي تم توريده للمضيف. أكرر الشيك المجاني |
| 403 | تحقق من المصدر المطلوب و التصاريح الرئيسية وتحتاج شركة YouTube Download إلى مالك مفتاح API مع شركة youtube_download وخزن الوجهات؛ ولا تشمل شركة 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/ar/docs/guides/mcp-custom-client/reference.md)
- [Codex تفاصيل](https://flashdata.dev/ar/docs/integrations/codex/reference.md)
- [OpenClaw تفاصيل](https://flashdata.dev/ar/docs/integrations/openclaw/reference.md)
- [المهام المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)
