Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Інтеграції

Codex

Give Codex Google Search і YouTube інструменти для кодування та досліджень.

На цій сторінці

Перед тим, як початися

Про нас Про нас Codex CLI встановлена і робоча. У цьому розпорядженні MCP використовує OAuth для Google Search, YouTube Search, метадані та перезаписи. Ви можете створити обліковий запис 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 для флешки. Відправте цю підказку; обидва дзвінки повинні бути успішними. Нульовий баланс все ще підтверджує робоче з'єднання.

Вставте в агент
Використовуйте флешки 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 інструмент
Знайдіть веб-ресурси для відповіді або реалізації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 з'єднання. Перевірте get_balance і get_pricing для одного пошуку Google.
Якщо допущено та фінансується, запустіть google_search один раз для "site:docs.python.org/3/library/venv.html create virtual environment" з num 5 та режим "realtime".
Заощаджуйте відвідковий звіт з джерелом URLs, викрутки та фактичні кредити, які використовуються.
Стоп на відкликані доступ або недостатні кредити; повага Retry-After. Не створюйте пробну версію, запрошуйте нову авторизації або повторіть запит, який результат невідомий.

Подрібнювачі та оновлення

Codex зберігає OAuth токени в його налаштуванні облікового магазину. Різне OS Користувач, профіль або середовище виконання може знадобитися самостійно схвалене підключення.

За допомогою обертальних освіжувальних жетонів запроваджують токени OAuth. Від'єднатися, коли Гарантований сертифікат 90-день або відкликається. Кожна інсталяція має власний токеновий магазин; не діляться освіжаючими файлами між хостами.

Відкликання або відключення

  1. За допомогою запланованих завдань, потім відкликати ім'я OAuth підключення до FlashData Settings → Connected apps.
  2. Запитайте агента, щоб викликати get_balance один раз з збереженим підключенням. Не потрібно автентифікувати або попросити від'єднатися. Не затверджуйте новий логін під час цієї перевірки.
  3. Видаліть локальні облікові дані OAuth з командою нижче. Щоб від'єднатися пізніше, повторіть крок 2 з схваленням власника та запустіть перевірку вільного з'єднання.
Видалити збережені облікові дані OAuth
codex mcp logout flashdata

Додаткові параметри налаштування

Додайте навички робочого процесу до підключення MCP, або оберіть доступ CLI або локальний сервер MCP.

Додати навички MCP

Флеш даних-mcp вчить вашого агента, як використовувати підключені інструменти. З'являється з'єднання вище.

Виконайте свій проект. Виберіть рідний FlashData CLI v1.2.1 або настройковий інсталятор з Node.js 22.20+ і npm. Запуск нового сеансу Codex і попросіть використовувати флешки-файлів-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 на приховану підказку. Для ненав'язаного імпорту труба її від свого секретного менеджера 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's збережений ключ або MCP OAuth токени.

Налаштуйте ключ в терміналі, замініть увесь попередній запис флешки (включаючи його розділ OAuth) з конфігурацією нижче, потім запустіть Codex з цього терміналу. Засіб може використовувати наявну в'язану змінну середовища замість прихованого підказки.

Після налаштування, запустіть безкоштовний запит з'єднання, надійшло вище в новому сеансі агента. Після того, як обидві перевірки проходять, скористайтеся першим поштовим запитом. API-ключ не вимагає входу в систему 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Запустіть список кодx mcp, потім /mcp в свіжу сеанс. Перевірити файл config і finish.
Навички відсутніПеревірити .agents/skills в цьому проекті. Для рідної MCP-навички встановити, запустити флеш-навички даних перевірте --agent кодx --skill flashdata-mcp. Перезапустіть сеанс.
invalid_client / callbackПорівняйте крок 1 точно. Повна авторизація в браузері, що може досягти ініціації зворотного зв’язку.
401Перевірте, чи було вимкнено з'єднання або ключ. Для OAuth повторити реєстрацію з затвердженням власника; для CLI, запустити флешки auth status. Подання кредитів не буде ремонтувати автентифікацію.
403Перевірити запитаний дозвіл на джерело. Дослідження OAuth не включає YouTube Download; використовувати його налаштування 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 перед переадресацією. Використовуйте get_result для повернутого продовження IDs.

OAuth валідаційні ноти

OAuth логін, зворотний зв'язок, збережені облікові дані, безкоштовний дзвінок, оновлення та відкликання були перевірені на Windows з Codex 0.163.0-alpha.10.2 на 2026-10-21. Що не вдали платні запити або планове виконання. Настанови налаштування перевірялися з документацією хост на 2026-11-05.