Обзор документации
Интеграции
Codex Google Search и YouTube инструменты для кодирования и исследования.
На этой странице
Прежде чем начать
тот Codex CLI установлен и работает. Эта размещенная настройка MCP использует OAuth для Google Search, YouTube Search, метаданных и транскриптов. Вы можете создать учетную запись FlashData во время входа.
1. Добавить сервер MCP
Объединение этой записи в ~/.codex/config.toml (или config.toml под CODEX_HOME). Держите зарегистрированного клиента ID и обратный вызов URL, как показано.
[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" с номером 5 и режимом "realtime".
Сохраните датированный отчет с использованием источника URLs, выдержек и фактических кредитов.
Остановитесь на отозванном доступе или недостаточном количестве кредитов; уважайте Retry-After. Не создавайте пробную версию, не запрашивайте новое разрешение и не повторяйте запрос, результат которого неизвестен.Полное хранение и обновление
Codex сохраняет токены OAuth в своем сконфигурированном хранилище учетных данных. Другой пользователь OS, профиль или среда исполнения может нуждаться в собственном одобренном соединении.
Хост обновляет одночасовые токены доступа OAuth с помощью вращающихся токенов обновления. Повторное подключение, когда срок действия гранта 90 истекает или аннулируется. Каждая установка имеет свой магазин токенов; не делитесь файлами обновлений между хостами.
Отменить или восстановить
- Приостановите выполнение запланированных задач, а затем отмените подключение OAuth в FlashData Settings → Connected apps.
- Попросите агента позвонить get_balance один раз с сохраненным соединением. Он должен потерпеть неудачу в аутентификации или попросить восстановить соединение. Не одобряйте новый логин во время этой проверки.
- Удалите локальные учетные данные OAuth с помощью команды ниже. Чтобы позже восстановить соединение, повторите шаг 2 с одобрением владельца и запустите бесплатную проверку соединения.
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-mcpnpx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent codex --copyИспользуйте навыки CLI или начните пробную версию
Установите FlashData CLI v1.2.1 и запустите Ваш проект. Выберите одну вкладку доступа. Примеры используют профиль CLI по умолчанию, отдельно от MCP OAuth; сохраняйте существующие --profile и --state-dir, если вы используете пользовательские.
Настройка устанавливает навыки CLI в .agents/skills. Запустите новый сеанс Codex после установки и попросите использовать Google-поиск.
Вставьте ключ с разрешением google_search в скрытую подсказку. Для необслуживаемого импорта переведите его от вашего секретного менеджера к auth login --api-key-stdin --non-interactive.
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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.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
# Прочитайте сохраненный файл: status, results[].organic, usage.credits.
# Терминал JSON сообщает о выходном пути; сохраняйте пробег ID для восстановления.Повторно используйте существующий ключ или пробную версию. Если FLASHDATA_API_KEY установлен, он имеет приоритет над сохраненным ключом; проверьте учетную запись, показанную auth status.
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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.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
# Прочитайте сохраненный файл: status, results[].organic, usage.credits.
# Терминал JSON сообщает о выходном пути; сохраняйте пробег ID для восстановления.Повторно использовать существующий процесс или зарегистрироваться один раз. Если срок истек, исчерпан или отменен, взыскать или потребовать его. Перед выполнением повторяющихся задач CLI заявляйте на учетную запись и подтвердите recurringAllowed: true в auth status.
flashdata setup --agent codex --non-interactive
flashdata auth status --json --non-interactiveflashdata 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.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
# Прочитайте сохраненный файл: status, 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 не требуется вход в систему mcp.
# 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[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codex# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey[mcp_servers.flashdata]
command = "npx.cmd"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codexустранение неполадок
| Проблема | Попробуйте |
|---|---|
| Нет инструментов FlashData | Запустите список кодекса mcp, затем /mcp в новой сессии. Проверьте файл конфигурации и логин finish. |
| Недостающие навыки | Проверьте .agents/skills в этом проекте. Для нативной установки MCP-skill запустите навыки проверки флешданных --agent кодекс --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-first-search-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.