सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

इंटीग्रेशन

Codex

कोडिंग और अनुसंधान के लिए Codex Google Search और YouTube उपकरण दें।

इस पेज पर

शुरू करने से पहले

Codex CLI स्थापित किया गया है और काम कर रहा है। इस मेजबानी की MCP सेटअप Google Search, YouTube Search, मेटाडाटा और Transcripts के लिए OAuth का उपयोग करता है। आप साइन-इन के दौरान एक 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. साइन इन करें

लॉग इन कमांड चलाएं। ब्राउज़र में, किसी खाते को बनाने या सत्यापित करने के लिए साइन इन करें, फिर एक्सेस को मंजूरी दें। लॉग इन की पुष्टि करने के लिए टर्मिनल की प्रतीक्षा करें। Queries उस खाते के क्रेडिट का उपयोग करते हैं।

साइन इन करें
codex mcp login flashdata --scopes mcp:research

मुफ्त के लिए कनेक्शन की जाँच करें

एक नया Codex सत्र शुरू करें और फ्लैशडाटा के लिए /mcp की जाँच करें। इस प्रॉम्प्ट को भेजें; दोनों कॉल सफल होने चाहिए। एक शून्य शेष अभी भी एक कार्य संबंध की पुष्टि करता है।

अपने एजेंट में पेस्ट करें
Flashdata MCP कनेक्शन का उपयोग करें।
कॉल get_balance साथ {} और get_pricing साथ {"source":"google_search","request_count":1}.
उपलब्ध क्रेडिट्स और अनुमानित मूल्य की रिपोर्ट करें। एक खोज नहीं चलाते।

3. अपना पहला कार्य चलायें

इसे अपने कनेक्टेड एजेंट में भेजें। चेक मुफ्त हैं; एकल खोज क्रेडिट का उपयोग करती है।

पहला कार्य शीघ्र
Flashdata MCP सर्वर का उपयोग करें। मेरी शेष राशि और एक Google खोज की कीमत की जाँच करें।
यदि वित्त पोषित है, तो google_search को एक बार क्वेरी "site:docs.python.org/3/library/venv.html create virtual environment", संख्या 5 और मोड "realtime" के साथ कॉल करें।
समझाओ कि कैसे लौटाए गए स्रोतों का उपयोग करके एक Python आभासी वातावरण बनाने के लिए।
Cite सूत्रों और उपयोग किए गए वास्तविक क्रेडिट की रिपोर्ट। इस कार्य के बाद बंद करो।

आपको क्या देखना चाहिए

status: done, results[].organic से स्रोत लिंक और उन स्रोतों के आधार पर एक उत्तर के साथ एक पूर्ण google_search टूल कॉल की तलाश करें। उपयोग usage.credits से आता है; यह परिणाम की संख्या नहीं है। खाली परिणाम खाली के रूप में सूचित किया जाना चाहिए।

क्या आप पूछ सकते हैं?

इस OAuth कनेक्शन में अनुसंधान उपकरण शामिल हैं। YouTube Download एक मालिक API कुंजी और गंतव्य भंडारण का उपयोग API या CLI के माध्यम से करता है।

कार्यMCP उपकरण
उत्तर या कार्यान्वयन के लिए वेब स्रोतों का पता लगाएंgoogle_search
प्रासंगिक YouTube वीडियो खोजेंyoutube_search
वीडियो शीर्षक, चैनल और मेटाडाटा पढ़ेंyoutube_metadata
एक सारांश के लिए एक वीडियो की ट्रांसक्रिप्ट को पुनर्प्राप्त करेंyoutube_transcript
उपलब्ध क्रेडिट्स और अनुरोध लागत की जाँच करेंget_balance · get_pricing

आवर्ती कार्यों के लिए उपयोग

उसी Codex प्रोफाइल, OS उपयोगकर्ता और क्रेडेंशियल स्टोर का उपयोग करें। अपने एजेंट होस्ट या मौजूदा शेड्यूलर में शेड्यूल बनाएं; FlashData डेटा उपकरण की आपूर्ति करता है।

सेव्ड एक्सेस को सत्यापित करें

निर्धारित वातावरण में एक नए सत्र में इस मुफ्त जांच को चलाएं। दोनों कॉल एक नए ब्राउज़र लॉगिन के बिना सफल होना चाहिए।

पुन: उपयोग की जाँच
मौजूदा फ़्लैशडाटा MCP कनेक्शन का पुन: उपयोग करें।
कॉल get_balance साथ {} और get_pricing साथ {"source":"google_search","request_count":1}.
रिपोर्ट करें कि क्या दोनों सफल हो गए हैं। नई पहुँच की खोज या निर्माण न करें।

आवर्ती कार्य बनाएँ

अपने मेजबान के शेड्यूलर में, एक समय और समय क्षेत्र चुनें, उदाहरण के लिए दैनिक 09:00 Asia/Shanghai. पर इसका उपयोग कार्य निकाय के रूप में किया जाता है। इसे एक बार वहाँ चलाएं और पुनरावृत्ति को सक्षम करने से पहले सहेजी गई रिपोर्ट की जांच करें।

टास्क बॉडी
मौजूदा फ़्लैशडाटा MCP कनेक्शन का पुन: उपयोग करें। एक Google खोज के लिए get_balance और get_pricing की जाँच करें।
यदि अनुमत और वित्त पोषित किया जाता है, तो "site:docs.python.org/3/library/venv.html create virtual environment" के लिए एक बार google_search को नंबर 5 और मोड "realtime" के साथ चलाएं।
स्रोत URLs, excerpts और वास्तविक क्रेडिट्स के साथ दिनांकित रिपोर्ट सहेजें।
रद्द पहुंच या अपर्याप्त क्रेडिट पर रोक; Retry-After का सम्मान करें। एक परीक्षण न बनाएं, नए प्राधिकरण का अनुरोध करें या एक अनुरोध को दोहराएं जिसका परिणाम अज्ञात है।

क्रेडेंशियल स्टोरेज और ताज़ा करें

Codex अपने कॉन्फ़िगर क्रेडेंशियल स्टोर में OAuth टोकन रखता है। एक अलग OS उपयोगकर्ता, प्रोफ़ाइल या निष्पादन वातावरण को अपने अनुमोदित कनेक्शन की आवश्यकता हो सकती है।

मेजबान एक घंटे OAuth पहुँच टोकनों को घूमते हुए रिफ्रेश टोकनों का उपयोग करते हुए ताज़ा करता है। जब 90-day अनुदान समाप्त हो जाता है या रद्द कर दिया जाता है तो फिर से कनेक्ट करें। प्रत्येक स्थापना अपने टोकन स्टोर का मालिक है; मेजबानों के बीच ताज़ा टोकन फ़ाइलों को साझा न करें।

रद्द करना या फिर से कनेक्ट करना

  1. निर्धारित कार्यों को रोकें, फिर FlashData Settings → Connected apps में नामित OAuth कनेक्शन को रद्द करें।
  2. एजेंट को बचाया कनेक्शन के साथ एक बार get_balance कॉल करने के लिए कहें। यह सत्यापन विफल होना चाहिए या फिर कनेक्ट करना चाहिए। इस चेक के दौरान एक नया लॉगिन स्वीकार न करें।
  3. नीचे दिए गए आदेश के साथ स्थानीय OAuth क्रेडेंशियल को हटा दें। बाद में फिर से कनेक्ट करने के लिए, मालिक की मंजूरी के साथ कदम 2 दोहराएं और मुफ्त कनेक्शन चेक चलाएं।
बचाया OAuth क्रेडेंशियल निकालें
codex mcp logout flashdata

अधिक सेटअप विकल्प

अपने MCP कनेक्शन के लिए वर्कफ़्लो कौशल जोड़ें, या CLI एक्सेस या स्थानीय MCP सर्वर का चयन करें।

MCP कौशल जोड़ें

flashdata-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 कौशल का उपयोग करें या परीक्षण शुरू करें

FlashData CLI v1.2.1 स्थापित करें और आपकी परियोजना से चलाएं। एक एक्सेस टैब चुनें। उदाहरण डिफ़ॉल्ट CLI प्रोफाइल का उपयोग करते हैं, जो MCP OAuth से अलग है; यदि आप कस्टम का उपयोग करते हैं तो अपने मौजूदा --profile और --state-dir को बनाए रखें।

सेटअप CLI कौशल को .agents/skills. में स्थापित करता है स्थापना के बाद एक नया Codex सत्र शुरू करें और Google-search का उपयोग करने के लिए कहें।

छिपे हुए प्रॉम्प्ट पर google_search अनुमति के साथ एक कुंजी पेस्ट करें। unattended आयात के लिए, इसे अपने गुप्त प्रबंधक से 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 को रखें।

एक API कुंजी के साथ स्थानीय MCP चलाएं

आवश्यकता है Node.js 22.18+, npm और एक API key with google_search अनुमति पहले कार्य के लिए। यह @flashdata-dev/mcp 0.2.0 चलाता है; यह FlashData CLI की बचाया कुंजी या MCP OAuth टोकन को नहीं पढ़ा जाता है।

एक टर्मिनल में कुंजी सेट करें, पूरे पहले के फ्लैशडाटा प्रविष्टि (इसमें OAuth सब्सेक्शन सहित) को नीचे कॉन्फ़िगर करें, फिर उस टर्मिनल से Codex प्रारंभ करें। एक एजेंट छिपे हुए प्रॉम्प्ट के बजाय मौजूदा इंजेक्टेड एनवायरमेंट वेरिएबल का उपयोग कर सकता है।

सेटअप के बाद, एक नए एजेंट सत्र में उपरोक्त मुफ्त कनेक्शन-चेक प्रॉम्प्ट को चलाएं। एक बार जब दोनों चेक पास करते हैं, तो पहली बार टस्क प्रॉम्प्ट का उपयोग करें। API-key Access को Mcp लॉगिन की आवश्यकता नहीं है।

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

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

समस्याइसे आज़माएं
नहीं FlashData उपकरणरन कोडेक्स mcp सूची, फिर एक ताजा सत्र में /mcp। कॉन्फ़िगरेशन फ़ाइल और finish लॉगिन की जाँच करें।
कौशल लापताइस परियोजना में .agents/skills की जाँच करें। एक मूल MCP-स्किल स्थापित करने के लिए, फ्लैशडाटा कौशल को चलाने के लिए --agent codex --skill flashdata-mcp को सत्यापित करें। सत्र को फिर से शुरू करें।
invalid_client / callbackवास्तव में कदम 1 की तुलना करें। एक ब्राउज़र में पूर्ण प्राधिकरण जो शुरू करने वाले होस्ट की कॉलबैक तक पहुंच सकता है।
401जांचें कि क्या कनेक्शन या कुंजी को रद्द कर दिया गया है या समाप्त हो गया है। OAuth के लिए, मालिक की मंजूरी के साथ साइन-इन दोहराएं; CLI के लिए, फ्लैशडाटा auth status चलाएं। क्रेडिट जोड़ना प्रमाणीकरण की मरम्मत नहीं करेगा।
403अनुरोधित स्रोत अनुमति की जाँच करें। रिसर्च OAuth में YouTube Download शामिल नहीं है; इसके API-key सेटअप का उपयोग करें। पुनः प्रयास करने से पहले अनुमति को ठीक करें।
402get_balance या flashdata खाता शेष की जाँच करें। Billing में क्रेडिट जोड़ें या कार्य बंद करें; फिर से साइन इन करने से क्रेडिट नहीं मिला।
429Retry-After के लिए प्रतीक्षा करें और सहमति को कम करें। वर्तमान प्रोफ़ाइल और पंजीकरण प्रमाण को संरक्षित करें; प्रतिस्थापन परीक्षणों का निर्माण न करें।
स्थानीय MCP कुंजी पढ़ा नहीं सकताFLASHDATA_API_KEY सेट करें जहां मेजबान प्रक्रिया शुरू होती है और इसे फिर से शुरू होती है। एक कुंजी टॉर्च auth login द्वारा बचाया स्वचालित रूप से स्थानीय MCP को निर्यात नहीं किया जाता है।
CLI आउटपुट फ़ाइल पहले से ही मौजूद हैपढ़िए ./codex-first-search.json. फिर से सहेजी गई सफलता का निर्यात करने के लिए, मूल प्रोफाइल के साथ flashdata runs show codex-first-search-001 --result --output codex-first-search-copy.json का उपयोग करें। केवल एक नए खोज के लिए एक नया रन ID का उपयोग करें।
अनुसूचित कार्य विफलउस वातावरण में मुफ्त पुन: उपयोग की जांच करें। OS उपयोगकर्ता, होस्ट प्रोफ़ाइल, क्रेडेंशियल स्टोर और टूल अनुमतियों से मेल खाता है।
टाइमआउट या अज्ञात परिणामअनुरोध या नौकरी रखने के लिए ID और Resubmitting से पहले History की जाँच करें। लौटाने की निरंतरता के लिए get_result का उपयोग करें IDs.

OAuth प्रमाणीकरण नोट

OAuth लॉगिन, कॉलबैक, सेव्ड क्रेडेंशियल्स, एक मुफ्त मूल्य निर्धारण कॉल, रिफ्रेश और रिवोकेशन पर सत्यापित किया गया था Windows साथ Codex 0.163.0-alpha.10.2 पर 2026-10-21. उस रन ने भुगतान किए गए प्रश्नों या निर्धारित निष्पादन को मान्य नहीं किया। 2026-11-05 पर होस्ट प्रलेखन के खिलाफ सेटअप निर्देश की जांच की गई थी।

Markdown