تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

عمليات التكامل

Codex

أعطِ Codex Google Search و YouTube أدوات للترميز والبحث.

في هذه الصفحة

قبل أن تبدأ

- Codex CLI تم تركيبها وعملها واستضافت هذه المجموعة مجموعة MCP استخدامات OAuth بالنسبة إلى Google Search و YouTube Search و Metadata و Transcripts. يمكنك خلق FlashData الحساب أثناء عملية التسجيل

1. يضاف خادم MCP

دمج هذا الدخول في - /.codex/config.toml (أو config.toml تحت CODEX_HOME). أبقِ العميلَ المسجّلَ ID وعودتك URL كما هو مبين.

~/.codex/config.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"

2. وقع

أديري أمر الدخول في المصفح، التوقيع على حساب أو إنشاءه والتحقق منه، ثم الموافقة على الوصول إليه. انتظر المحطة لتأكيد لوجست يستخدم (كيوريز) إئتمانات ذلك الحساب

تسجيل الدخول
codex mcp login flashdata --scopes mcp:research

تحققي من الاتصال بالمجان

إبدأْ جديدَ Codex الدورة والفحص /mcp من أجل (فلادلتا) أرسل هذا فوراً؛ وكلا النداءين يجب أن ينجحا ولا يزال هناك رصيد صفري يؤكد وجود صلة عمل.

باستي في وكيلك
استخدم اتصال flashdata MCP.
استدعِ get_balance باستخدام {} وget_pricing باستخدام {"source":"google_search","request_count":1}.
أبلغ عن الرصيد المتاح والسعر المقدّر. لا تنفّذ بحثًا.

3. أدير مهمتك الأولى

أرسل هذا إلى عميلك المُتصل الشيكات مجانية، ويستخدم البحث الوحيد الائتمانات.

المهمة الأولى
إستعملْ الميضداتَ MCP خادم. تحقق من رصيدي وثمن واحد Google البحث.
إذا مُوّلت، اتصل google_search مرة واحدة مع الاستفسار "site:docs.python.org/3/library/venv.html create virtual environment", num 5 وأسلوب العمل "realtime".
اشرح كيفية إنشاء بيئة Python افتراضية باستخدام المصادر المُعادة.
مصادر موقعية وإبلاغ عن الأرصدة الدائنة الفعلية المستخدمة. توقّفْ بعد هذه المهمةِ.

ما يجب أن تراه

ابحثوا عن مجموعة من الأدوات من طراز google_search مع status: done، ووصلات المصدر من results[].organic، وإجابة تستند إلى تلك المصادر. ويأتي الاستخدام من usage.credits؛ وهو ليس عدد النتائج. وينبغي الإبلاغ عن نتائج فارغة.

ما يمكنك أن تسأل عنه

ويغطي هذا الاتصال بشركة OAuth أدوات البحث. وتستخدم شركة YouTube Download مخزناً رئيسياً ومقصداً من طراز API من خلال شركة API أو CLI.

المهامMCP tool
البحث عن مصادر على شبكة الإنترنت للإجابة أو التنفيذgoogle_search
العثور على أشرطة فيديو ذات صلة من طراز YouTubeyoutube_search
اقرأ عناوين الفيديو والقنوات والبيانات الفوقيةyoutube_metadata
إسترجع نسخة فيديو لموجزyoutube_transcript
التحقق من الائتمانات المتاحة وتكاليف الطلبget_balance · get_pricing

إعادة استخدام سبل الوصول إلى المهام المتكررة

استخدم نفس ملف Codex, OS مستعمل ومخزن للإبداع. (أ) وضع الجدول الزمني في مضيف عميلك أو القائم على الجدول الزمني؛ وتزود شركة FlashData أدوات البيانات.

التحقق من توفير إمكانية الوصول

أجري هذا الفحص المجاني في دورة جديدة في البيئة المقررة كلا الإتصالين يجب أن ينجحا بدون لوج منظف جديد

التحقق من إعادة الاستخدام
أعد استخدام اتصال flashdata MCP الموجود.
استدعِ get_balance باستخدام {} وget_pricing باستخدام {"source":"google_search","request_count":1}.
أبلغ عما إذا نجح كلاهما. لا تبحث ولا تنشئ وصولًا جديدًا.

إنشاء المهمة المتكررة

في الجدول الزمني لمضيفك، اختيار منطقة زمنية وزمن، على سبيل المثال يوميا في 09:00 Asia/Shanghai. استخدم هذا كهيئة عمل أديرها مرة هناك وتحقق من التقرير المنقذ قبل أن يُمكن من تكرارها

هيئة المهام
أعد استخدام اتصال flashdata MCP الموجود. افحص get_balance وget_pricing لبحث Google واحد.
إذا كانت الصلاحية والرصيد متاحين، شغّل google_search مرة واحدة لـ "site:docs.python.org/3/library/venv.html create virtual environment" مع num بقيمة 5 وmode بقيمة "realtime".
احفظ تقريرًا مؤرخًا بروابط المصادر والمقتطفات والرصيد المستخدم فعليًا.
توقف عند إلغاء الوصول أو عدم كفاية الرصيد؛ والتزم بـ Retry-After. لا تنشئ تجربة ولا تطلب تفويضًا جديدًا ولا تكرر طلبًا مجهول النتيجة.

تخزين المواد الخليعة وتجديدها

يحفظ Codex رموز OAuth في مخزن بيانات الاعتماد المُعدّ لديه. قد يحتاج مستخدم نظام تشغيل أو ملف شخصي أو بيئة تنفيذ مختلفة إلى اتصال معتمد خاص بها.

يجدّد المضيف رموز وصول OAuth ذات الساعة الواحدة باستخدام رموز تجديد متعاقبة. أعد الاتصال عند انتهاء التفويض بعد 90 يومًا أو إلغائه. لكل تثبيت مخزن رموزه الخاص؛ ولا تشارك ملفات رموز التجديد بين المضيفين.

Revoke or reconnect

  1. أوقف المهام المجدولة مؤقتًا، ثم ألغِ اتصال OAuth المحدد في FlashData Settings → Connected apps.
  2. أطلب من العميل أن يتصل get_balance ذات مرة مع الاتّصال المنقذ. يجب أن تفشل في التوثيق أو أن تطلب إعادة التواصل. لا توافق على سجل جديد خلال هذا الشيك
  3. Remove the local OAuth documents with the command below. ولإعادة الاتصال فيما بعد، كرر الخطوة 2 بموافقة المالك وتحقق من الارتباط الحر.
Remove Save OAuth documents
codex mcp logout flashdata

المزيد من الخيارات في مجال التجهيز

أضف مهارات سير العمل إلى اتصالك بشركة MCP، أو اختار الوصول إلى CLI أو خادم محلي من طراز MCP.

أضف مهارة MCP

مهارة الوميضات تُعلّم عميلك كيفية استخدام الأدوات المُتصلة يُعيد استخدام الرابط أعلاه.

شغّل من مشروعك. اختر FlashData CLI الأصلي بالإصدار v1.2.1 أو مثبّت المهارات مع Node.js 22.20+ وnpm. ابدأ جلسة Codex جديدة واطلب استخدام flashdata-mcp.

في مشروعك
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

استخدام مهارات CLI أو بدء التجربة

Install FlashData CLI v1.2.1 وهربوا مشروعك. اختر ورقة دخول واحدة أمثلة على استخدام التخلف عن السداد CLI ملامح منفصلة MCP OAuth? --profile و --state-dir إذا كنت تستخدم العرف.

إقامة تركيبات لمهارات CLI إلى .agents/skills. إبدأْ جديدَ Codex جلسة بعد التركيب وطلب استخدام البحث عن قوقل.

معذرة مفتاح مع google_search إذن في العجلة المخفية. لاستيراد غير مجهز، أنقله من مديرك السري إلى auth login --api-key-stdin --non-interactive.

1. استيراد المفتاح والتحقق منه
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
2. الرصيد المتحقق والتكلفة - لا بحث
flashdata account balance --json --non-interactive
flashdata search "site:docs.python.org/3/library/venv.html create virtual environment" --num 5 --dry-run --json --non-interactive

# استمر فقط إذا كان accessVerified و estimateAvailable هي true،,
# صلاحية google_search متاحة، وقيمة availableCredits تغطي estimatedCredits.
3. شغّل مرة واحدة → ./codex-first-search.json
flashdata search "site:docs.python.org/3/library/venv.html create virtual environment" --num 5 --run-id codex-first-search-001 --output codex-first-search.json --json --non-interactive

# اقرأ الملف المنقذ: الحالة، results[].organic، usage.credits.
# وتُبلغ محطة JSON عن مسار الناتج؛ وتُبقي على الرقم ID للانتعاش.

تشغيل محلي MCP مع مفتاح API

يتطلب Node.js 22.18+ وnpm ومفتاح API بصلاحية google_search للمهمة الأولى. يشغّل هذا @flashdata-dev/mcp 0.2.0؛ ولا يقرأ مفتاح FlashData CLI المحفوظ أو رموز MCP OAuth.

وضع المفتاح في محطة طرفية، والاستعاضة عن المدخل السابق للبيانات (بما في ذلك قسمها الفرعي من OAuth) بالوصاية الواردة أدناه، ثم بدء تشغيل Codex من تلك المحطة. يمكن لوكيل أن يستخدم متغيراً قائماً في البيئة بالحقن بدلاً من العجلة الخفية

بعد الإعداد، أجري فحص الاتصال المجاني في جلسة عمل جديدة. بمجرد أن يمر كل من الشيكات، استخدمي العجلة الأولى. API-الولوج إلى (ميكي) لا يتطلب لوجّاً

1. وضع المفتاح دون طباعته
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
2. يستعاض عن عبارة " /.codex/config.toml "
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
3. بدء دورة جديدة في هذه المحطة
codex

اضطرابات

المشكلةجرب هذا
No FlashData toolsقائمة الشفرات /mcp في دورة جديدة. تحقق من ملف المحكمة و finish لوج.
"المفقودون"افحص .agents/skills في هذا المشروع. لتثبيت مهارة MCP الأصلي، شغّل flashdata skills verify --agent codex --skill flashdata-mcp. أعد بدء الجلسة.
invalid_client / callbackبالمقارنة مع الخطوة 1 بالضبط. إذن كامل في مصفف يمكن أن يصل إلى ردة فعل المضيف
401تحققي من إن كان الوصل أو المفتاح قد ألغي أو انتهى بالنسبة للزجاجة OAuth، إعادة الإشارة بموافقة المالك؛ بالنسبة للزجاجة CLI، تشغيل وميضدات auth status. الإضافات الائتمانية لن تصليح التوثيق
403تحقق من إذن المصدر المطلوب. البحوث OAuth لا تشمل YouTube Download; Use its API-حسناً اصلح الإذن قبل إعادة التجريب
402تحقق get_balance أو رصيد حساب البيانات. تضاف أرصدة دائنة في Billing أو توقف المهمة؛ والتوقيع مرة أخرى لا يضيف ائتمانات.
429انتظر حسب Retry-After وقلّل التزامن. احتفظ بالملف الشخصي الحالي وإثبات التسجيل؛ لا تنشئ تجارب بديلة.
MCP المحلي لا يستطيع قراءة المفتاحالمجموعة FLASHDATA_API_KEY حيث تبدأ العملية المضيفة وتعيد تشغيلها مفتاح انقذته "الملفات" auth login لا يُصدَّر تلقائياً إلى محلية MCP.
يوجد بالفعل ملف نواتج CLIاقرأ ./codex-first-search.json. لتصدير النجاح المنقذ مرة أخرى، استخدام البيانات الخفية runs show codex-البحث الأول001 --result --output codex-first-search-copy.json مع الملف الأصلي. استخدمي جهازاً جديداً من طراز ID فقط من أجل بحث جديد مقصود
فشل المهمة المقررةأجري فحص إعادة الاستخدام المجاني داخل تلك البيئة تطابق OS مستعمل، ملف مضيف، مخزن للإبداع، وأذن للأداة.
الوقت أو النتيجة غير المعروفةأو الوظيفة ID وتحقق History قبل إعادة تقديم الطلب Use get_result for returned continuation IDs.

ملاحظــات المصادقة من طراز OAuth

تم التحقق من تسجيل دخول OAuth والاستدعاء العائد وبيانات الاعتماد المحفوظة واستدعاء أسعار مجاني والتجديد والإلغاء على Windows باستخدام Codex 0.163.0-alpha.10.2 بتاريخ 2026-10-21. لم يتحقق ذلك الاختبار من الاستعلامات المدفوعة أو التنفيذ المجدول. روجعت تعليمات الإعداد وفق وثائق المضيف بتاريخ 2026-11-05.