# Codex

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

Канонічне посилання: https://flashdata.dev/uk/docs/integrations/codex
Переглянуто: 2026-11-05 від FlashData

<a id="choose"></a>

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

Про нас Про нас Codex CLI встановлена і робоча. У цьому розпорядженні MCP використовує OAuth для Google Search, YouTube Search, метадані та перезаписи. Ви можете створити обліковий запис FlashData під час реєстрації.

- [Використовуйте навички CLI або запустіть тест](https://flashdata.dev/uk/docs/integrations/codex/reference.md#cli)
- [Встановити Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

<a id="setup"></a>

## 1. Додати сервер MCP

Зайдіть цей запис в ~ /.codex/config.toml (або config.toml під CODEX_HOME). Зберігати зареєстрований клієнт ID і зворотній дзвінок URL як показано.

### ~/.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"
```


<a id="oauth"></a>

## 2. Увійти

Запустіть команду входу. У браузері введіть або створіть і перевірте обліковий запис, після чого затверджуйте доступ. Зачекайте термінал для підтвердження логіки. Запитання щодо використання кредитних коштів.

### Увійти

```bash
codex mcp login flashdata --scopes mcp:research
```


<a id="connection-check"></a>

### Перевірити підключення безкоштовно

Запуск нового сеансу Codex та перевірте /mcp для флешки. Відправте цю підказку; обидва дзвінки повинні бути успішними. Нульовий баланс все ще підтверджує робоче з'єднання.

#### Вставте в агент

```text
Використовуйте флешки MCP з'єднання.
Зателефонуйте get_balance з {} та get_pricing з {"source":"google_search","request_count":1}.
Повідомляємо про доступні кредити та оціночну ціну. Не запустіть пошук.
```


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

## 3. Запуск першого завдання

Відправте цей до свого підключеного агента. Перевірка безкоштовні; єдиний пошук використовує кредити.

### Перший запит завдання

```text
Використовуйте флешки MCP сервер. Перевірити баланс і ціну одного пошуку Google.
Якщо зараховано, зателефонуйте google_search відразу з запитом "site:docs.python.org/3/library/venv.html create virtual environment", num 5 і режим "realtime".
Створіть віртуальне середовище Python за допомогою повернутих джерел.
Згідно з даними та звітом про фактичні кредити, що використовуються. Стоп після цього завдання.
```


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

### Що потрібно побачити

Шукаємо завершено google_search виклик інструменту з status: done, вихідні посилання з results[].organic і відповідь на те, що на основі джерел. За допомогою usage.credits не існує. Порожні результати повинні бути повідомлені як порожній.

- [Історія запиту](https://flashdata.dev/app/jobs)

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

## Що ви можете запитати

Це OAuth з'єднання охоплює дослідницькі інструменти. YouTube Download використовує власник API ключ і місце зберігання через API або CLI.

| Заява | MCP інструмент |
| --- | --- |
| Знайдіть веб-ресурси для відповіді або реалізації | google_search |
| Знайти відповідні YouTube відео | youtube_search |
| Читання назв відео, каналів та метаданих | youtube_metadata |
| Отримати транскрипцію відео для резюме | youtube_transcript |
| Перевірити наявні кредити і вартість запиту | get_balance · get_pricing |

- [Інструменти та схеми MCP](https://flashdata.dev/uk/docs/mcp/reference.md)
- [Налаштувати YouTube Download](https://flashdata.dev/uk/docs/guides/youtube-download-guide/reference.md)

<a id="recurring"></a>

## Запобігання доступу до задач рецидиву

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


<a id="reuse-check"></a>

### Перевірити збережений доступ

Запустити цю безкоштовну перевірку в свіжому вигляді в запланованому середовищі. І виклики повинні бути успішними без нового входу в веб-сайт.

#### Перевірка повторного використання

```text
Запобігання існуючої флешки MCP з'єднання.
Зателефонуйте get_balance з {} та get_pricing з {"source":"google_search","request_count":1}.
Повідомляємо, чи вдалося досягти успіху. Не шукати або створювати новий доступ.
```


<a id="schedule"></a>

### Створіть завдання рецидиву

У графіку вашого хосту виберіть час і часовий пояс, наприклад, щоденно в 09:00 Asia/Shanghai. Використовуйте це як тіло завдання. Виконайте його після того, як він і перевірте збережений звіт перед тим, як забезпечити повторення.

#### Завдання тіла

```text
Запобігання існуючої флешки 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. Не створюйте пробну версію, запрошуйте нову авторизації або повторіть запит, який результат невідомий.
```

- [Реактування посібника задачі](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md)
- [CLI scheduling і відновлення](https://flashdata.dev/uk/docs/guides/cli-automation/reference.md#recurring)

<a id="credentials"></a>

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

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

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


<a id="revoke"></a>

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

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

#### Видалити збережені облікові дані OAuth

```bash
codex mcp logout flashdata
```

- [Connected apps](https://flashdata.dev/app/settings/connections)

<a id="options"></a>

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

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


<a id="skills"></a>

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

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

Виконайте свій проект. Виберіть рідний FlashData CLI v1.2.1 або настройковий інсталятор з Node.js 22.20+ і npm. Запуск нового сеансу Codex і попросіть використовувати флешки-файлів-mcp.

#### FlashData CLI

##### У Вашому проекті

```bash
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp
```


#### Node.js / npm

##### У Вашому проекті

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent codex --copy
```


- [CLI інсталяція](https://flashdata.dev/uk/docs/guides/flashdata-cli/reference.md#install)
- [Читати майстерність MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Оновлення або видалення навичок](https://flashdata.dev/uk/docs/guides/agent-skill-management/reference.md)

<a id="cli"></a>

### Використовуйте навички CLI або запустіть тест

Встановіть FlashData CLI v1.2.1 і запустіть з Ваш проект. Виберіть вкладку одного доступу. Приклади використання за замовчуванням CLI профілю, відокремлених від MCP OAuth; зберігати існуючий --profile і --state-dir, якщо ви використовуєте користувацькі.

Налаштування CLI навички в .agents/skills. Запуск нового сеансу Codex після встановлення та запиту на використання Google-search.

#### Existing API ключ

Вставте ключ з дозволу google_search на приховану підказку. Для ненав'язаного імпорту труба її від свого секретного менеджера auth login --api-key-stdin --non-interactive.

##### 1. Імпорт і перевірка ключа

```bash
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Перевірити баланс і вартість — без пошуку

```bash
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

```bash
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 для відновлення.
```


#### Збережено CLI доступ

Використовуйте наявний ключ або пробний процес. Якщо встановлена FLASHDATA_API_KEY, вона бере перед собою прецедентію над збереженим ключем; перевірте рахунок, який відображається auth status.

##### 1. Запобігання та перевірка збереженого доступу

```bash
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Перевірити баланс і вартість — без пошуку

```bash
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

```bash
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 для відновлення.
```


#### Обов'язковий процес

За допомогою наявної пробної версії або реєстрації. Якщо вичерпані, вичерпаються або відкликані, відновлюють або стверджують його. Перед тим як перерахувати задачі CLI, застосувати рахунок і підтвердити recurringAllowed: true в auth status.

##### 1. Налаштування та перевірка доступу до тестових випробувань

```bash
flashdata setup --agent codex --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Перевірити баланс і вартість — без пошуку

```bash
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

```bash
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 для відновлення.
```


- [Завантажити CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [CLI інсталяція](https://flashdata.dev/uk/docs/guides/flashdata-cli/reference.md#install)
- [Відновити збережений результат](https://flashdata.dev/uk/docs/guides/cli-automation/reference.md#recover)
- [Клайм перед рецидивом завдань CLI](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md)

<a id="local"></a>

### Запуск локального 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.

#### Bash

##### 1. Встановити ключ без друку

```bash
# 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

```toml
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/mcp@0.2.0", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
```

##### 3. Запуск нового сеансу в терміналі

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Встановити ключ без друку

```powershell
# 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
```

##### 2. Замініть запис у ~/.codex/config.toml

```toml
[mcp_servers.flashdata]
command = "npx.cmd"
args = ["--yes", "--package=@flashdata-dev/mcp@0.2.0", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
```

##### 3. Запуск нового сеансу в терміналі

```powershell
codex
```


- [Запуск безкоштовної перевірки з'єднання](https://flashdata.dev/uk/docs/integrations/codex/reference.md#connection-check)
- [Створіть ключ API](https://flashdata.dev/app/api-keys)
- [Локальна документація MCP](https://github.com/flashdatadev/flashdata-mcp)

<a id="help"></a>

## Виправлення несправностей

| Проблема | Написати нам |
| --- | --- |
| Немає інструментів 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. |

- [Керівництво по відновленню](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md)
- [Codex MCP документація](https://learn.chatgpt.com/docs/extend/mcp)

<a id="compatibility"></a>

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

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

- [Офіційні навички](https://github.com/flashdatadev/flashdata-skills)
- [MCP пакет і джерело](https://github.com/flashdatadev/flashdata-mcp)
