# Codex

Podaj narzędzia Codex Google Search i YouTube do kodowania i badań.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/integrations/codex
Przegląd: 2026-11-05 przez FlashData

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

## Zanim zaczniesz

Czy do Codex CLI zainstalowane i działa. Ten hostowany konfiguracja MCP wykorzystuje OAuth dla Google Search, YouTube Search, Metadane i Transkrypty. Możesz utworzyć konto FlashData podczas sign- in.

- [Użyj umiejętności CLI lub rozpocznij proces](https://flashdata.dev/pl/docs/integrations/codex/reference.md#cli)
- [Zainstaluj Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

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

## 1. Dodaj serwer MCP

Połącz ten wpis do ~ /.codex/config.toml (lub config.toml pod CODEX_HOME). Zachowaj zarejestrowanego klienta ID i wyłącz URL jak pokazano.

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

Uruchom polecenie logowania. W przeglądarce zaloguj się lub utwórz i weryfikuj konto, a następnie zatwierdzaj dostęp. Poczekaj, aż terminal potwierdzi logowanie. Zapytania wykorzystują kredyty tego konta.

### Zaloguj się

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


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

### Sprawdź połączenie za darmo

Rozpocznij nową sesję Codex i sprawdź czy /mcp nie ma danych flash. Wyślij ten sygnał; oba połączenia powinny odnieść sukces. Bilans zerowy nadal potwierdza połączenie robocze.

#### Wklej do swojego agenta

```text
Użyj połączenia flashdata MCP.
Zadzwoń do get_balance z {} i get_pricing z {"source":"google_search","request_count":1}.
Proszę podać dostępne kredyty i szacunkową cenę. Nie przeszukuj.
```


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

## 3. Uruchom swoje pierwsze zadanie

Wyślij to do swojego powiązanego agenta. Kontrole są darmowe; pojedyncze wyszukiwanie wykorzystuje kredyty.

### Pierwszy sygnał zadania

```text
Użyj serwera flashdata MCP. Sprawdź moją równowagę i cenę jednego wyszukiwania Google.
Jeśli sfinansowane, zadzwoń raz do google_search z zapytaniem "site:docs.python.org/3/library/venv.html create virtual environment", num 5 i tryb "realtime".
Wyjaśnij jak stworzyć wirtualne środowisko Python przy użyciu zwróconych źródeł.
Zacytować źródła i zgłosić rzeczywiste kredyty wykorzystane. Przestań po tym zadaniu.
```


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

### Co powinieneś zobaczyć

Poszukaj zakończonego połączenia z narzędziami google_search z status: done, linków źródłowych z results[].organic i odpowiedzi opartej na tych źródłach. Zastosowanie pochodzi z usage.credits; nie jest to liczba wyników. Puste wyniki należy zgłaszać jako puste.

- [Sprawdź historię żądań](https://flashdata.dev/app/jobs)

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

## O co możesz prosić?

To połączenie OAuth obejmuje narzędzia badawcze. YouTube Download używa właściciela klucza API i pamięci docelowej za pośrednictwem API lub CLI.

| Zadanie | Narzędzie MCP |
| --- | --- |
| Znajdź źródła internetowe dla odpowiedzi lub realizacji | google_search |
| Znajdź odpowiednie filmy YouTube | youtube_search |
| Czytaj tytuły, kanały i metadane wideo | youtube_metadata |
| Pobierz zapis wideo do podsumowania | youtube_transcript |
| Sprawdź dostępne kredyty i koszty żądania | get_balance · get_pricing |

- [Narzędzia i schematy MCP](https://flashdata.dev/pl/docs/mcp/reference.md)
- [Konfiguracja YouTube Download](https://flashdata.dev/pl/docs/guides/youtube-download-guide/reference.md)

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

## Ponowne wykorzystanie dostępu do powtarzających się zadań

Użyj tego samego profilu Codex, użytkownika OS i sklepu kredytowego. Utwórz harmonogram w swoim komputerze agenta lub istniejącym harmonogramie; FlashData dostarcza narzędzia danych.


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

### Weryfikacja zapisanego dostępu

Uruchom ten bezpłatny czek w świeżej sesji w planowanym środowisku. Oba połączenia powinny odnieść sukces bez nowego logowania przeglądarki.

#### Kontrola ponownego użycia

```text
Ponownie użyj istniejącego połączenia flashdata MCP.
Zadzwoń do get_balance z {} i get_pricing z {"source":"google_search","request_count":1}.
Zgłoście, czy obu się udało. Nie wyszukuj ani nie twórz nowego dostępu.
```


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

### Utwórz powtarzające się zadanie

W harmonogramie hosta wybierz strefę czasu i czasu, na przykład codziennie w 09:00 Asia/Shanghai. Użyj tego jako organu zadaniowego. Uruchom go raz tam i sprawdź zapisany raport przed włączeniem powtórzenia.

#### Organ zadaniowy

```text
Ponownie użyj istniejącego połączenia flashdata MCP. Sprawdź get_balance i get_pricing dla jednego wyszukiwania Google.
Jeśli jest to dozwolone i finansowane, uruchom google_search raz dla "site:docs.python.org/3/library/venv.html create virtual environment" z num 5 i tryb "realtime".
Zapisz raport datowany ze źródłami URLs, fragmentami i rzeczywiście wykorzystanymi kredytami.
Zatrzymaj cofnięty dostęp lub niewystarczający kredyt; szanuj Retry-After. Nie tworzyć procesu, zażądać nowego autoryzacji lub powtórzyć wniosek, którego wynik jest nieznany.
```

- [Nawracający przewodnik zadaniowy](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md)
- [Harmonogram i odzysk CLI](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md#recurring)

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

### Przechowywanie i odświeżanie kred

Codex przechowuje żetony OAuth w skonfigurowanym magazynie kredytowym. Inne środowisko użytkownika, profilu lub wykonania OS może potrzebować własnego zatwierdzonego połączenia.

Host odświeża jednogodzinne żetony dostępu OAuth za pomocą obrotowych żetonów odświeżających. Uzupełnić po wygaśnięciu lub cofnięciu grantu na dzień 90-. Każda instalacja jest właścicielem sklepu z żetonami; nie udostępniaj plików z symbolami odświeżania pomiędzy hostami.


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

### Odrodzenie lub ponowne połączenie

1. Wstrzymaj zaplanowane zadania, a następnie cofnij połączenie OAuth w FlashData Settings → Connected apps.
2. Poproś agenta, aby zadzwonił do get_balance raz z zapisanym połączeniem. Powinno nie być uwierzytelniania lub poprosić o ponowne połączenie. Nie zatwierdzaj nowego logowania podczas tej kontroli.
3. Usuń lokalne referencje OAuth z poniższym poleceniem. Aby ponownie połączyć się później, powtórz krok 2 z zatwierdzeniem właściciela i uruchom bezpłatne sprawdzenie połączenia.

#### Usuń zapisane referencje OAuth

```bash
codex mcp logout flashdata
```

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

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

## Więcej opcji konfiguracji

Dodaj umiejętności przepływu pracy do połączenia MCP lub wybierz dostęp CLI lub lokalny serwer MCP.


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

### Dodaj umiejętność MCP

Umiejętność flashdata- mcp uczy Twojego agenta jak używać podłączonych narzędzi. Ponownie wykorzystuje połączenie powyżej.

Uciekaj z projektu. Wybierz natywny FlashData CLI v1.2.1 lub instalatora umiejętności z Node.js 22.20 + i npm. Rozpocznij nową sesję Codex i poproś o użycie flashdata- mcp.

#### FlashData CLI

##### W projekcie

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


#### Node.js / npm

##### W projekcie

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


- [Instalacja CLI](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#install)
- [Przeczytaj umiejętność MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Uaktualnianie lub usuwanie umiejętności](https://flashdata.dev/pl/docs/guides/agent-skill-management/reference.md)

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

### Użyj umiejętności CLI lub rozpocznij proces

Zainstaluj FlashData CLI v1.2.1 i uruchom od Twój projekt. Wybierz jedną kartę dostępu. Przykłady używają domyślnego profilu CLI, oddzielonego od MCP OAuth; zachowuj istniejący profil --profile i --state-dir, jeśli używasz własnych.

Instalacja instalacji CLI w .agents/skills. Rozpocznij nową sesję Codex po instalacji i poproś o użycie google- search.

#### Istniejący klucz API

Wklej klawisz za zgodą google_search na ukryty sygnał. Dla importu bez nadzoru, prześlij go ze swojego tajnego menedżera do auth login --api-key-stdin --non-interactive.

##### 1. Importuj i weryfikuj klucz

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

##### 2. Sprawdź bilans i koszt - brak wyszukiwania

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

# Dalej należy kontynuować tylko wtedy, gdy accessVerified i estimateAvailable są true,
# Zezwala się na google_search, a availableCredits obejmuje estimatedCredits.
```

##### 3. Uruchom raz → ./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

# Przeczytaj zapisany plik: status, results[].organic, usage.credits.
# Terminal JSON informuje o ścieżce wyjścia; zachować bieg ID do odzysku.
```


#### Uratowano dostęp CLI

Ponownie użyj istniejącego klucza lub procesu. Jeśli jest ustawiony FLASHDATA_API_KEY, ma pierwszeństwo przed zapisanym kluczem; weryfikuje konto pokazane przez auth status.

##### 1. Ponowne wykorzystanie i weryfikacja zapisanego dostępu

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

##### 2. Sprawdź bilans i koszt - brak wyszukiwania

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

# Dalej należy kontynuować tylko wtedy, gdy accessVerified i estimateAvailable są true,
# Zezwala się na google_search, a availableCredits obejmuje estimatedCredits.
```

##### 3. Uruchom raz → ./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

# Przeczytaj zapisany plik: status, results[].organic, usage.credits.
# Terminal JSON informuje o ścieżce wyjścia; zachować bieg ID do odzysku.
```


#### Kwalifikowalne badanie

Ponowne użycie istniejącego procesu lub rejestracji raz. W przypadku wygaśnięcia, wyczerpania lub cofnięcia, odzyskania lub żądania. Przed powtarzającymi się zadaniami CLI, żądaj konta i potwierdź recurringAllowed: true w auth status.

##### 1. Ustaw i weryfikuj dostęp do procesu

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

##### 2. Sprawdź bilans i koszt - brak wyszukiwania

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

# Dalej należy kontynuować tylko wtedy, gdy accessVerified i estimateAvailable są true,
# Zezwala się na google_search, a availableCredits obejmuje estimatedCredits.
```

##### 3. Uruchom raz → ./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

# Przeczytaj zapisany plik: status, results[].organic, usage.credits.
# Terminal JSON informuje o ścieżce wyjścia; zachować bieg ID do odzysku.
```


- [Pobierz CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Instalacja CLI](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#install)
- [Odzyskiwanie zapisanego wyniku](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md#recover)
- [Zaskarżyć przed powtarzającymi się zadaniami CLI](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md)

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

### Uruchom lokalne MCP za pomocą klawisza API

Wymaga Node.js 22.18 +, npm i klawisza API z pozwoleniem google_search na pierwsze zadanie. To działa @ flashdata-dev/mcp 0.2.0; nie odczytuje zapisanego klucza FlashData CLI lub żetonów MCP OAuth.

Ustaw klucz w terminalu, zastąp cały wcześniejszy wpis danych flash (w tym jego podrozdział OAuth) poniższym konfiguratorem, a następnie uruchom Codex z tego terminala. Agent może użyć istniejącej zmiennej środowiskowej zamiast ukrytego sygnału.

Po skonfigurowaniu, uruchom w nowej sesji agencyjnej darmowy podłączenie- sprawdź powyżej. Gdy obie kontrole przejdą, użyj pierwszego polecenia zadania. Dostęp do klucza API- nie wymaga logowania mcp.

#### Bash

##### 1. Ustaw klucz bez drukowania go

```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. Zastąp wpis w ~ /.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. Rozpocznij nową sesję w tym terminalu

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Ustaw klucz bez drukowania go

```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. Zastąp wpis w ~ /.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. Rozpocznij nową sesję w tym terminalu

```powershell
codex
```


- [Uruchom darmowe sprawdzenie połączenia](https://flashdata.dev/pl/docs/integrations/codex/reference.md#connection-check)
- [Utwórz klucz API](https://flashdata.dev/app/api-keys)
- [Lokalna dokumentacja MCP](https://github.com/flashdatadev/flashdata-mcp)

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

## Rozwiązywanie problemów

| Problem | Spróbuj tego |
| --- | --- |
| Brak narzędzi FlashData | Uruchom listę kodów mcp, a następnie /mcp w nowej sesji. Sprawdź plik konfiguracyjny i logowanie finish. |
| Brak umiejętności | Sprawdź .agents/skills w tym projekcie. Dla rodzimej instalacji MCP- umiejętności uruchomić umiejętności flashdata zweryfikować --agent kod --skill flashdata- mcp. Przywróć sesję. |
| invalid_client / callback | Porównaj krok 1 dokładnie. Kompletna autoryzacja w przeglądarce, która może dotrzeć do wywołania hosta inicjującego. |
| 401 | Sprawdź, czy połączenie lub klucz zostały cofnięte lub wygasły. W przypadku OAuth, należy ponownie wpisać z zatwierdzeniem właściciela; w przypadku CLI należy uruchomić flashdata auth status. Dodawanie kredytów nie naprawi uwierzytelniania. |
| 403 | Sprawdź wymagane zezwolenie na korzystanie ze źródła. Badania OAuth nie zawiera YouTube Download; użyj jego ustawienia klucza API-. Napraw pozwolenie przed ponownym próbami. |
| 402 | Sprawdź stan konta get_balance lub flashdata. Dodawanie kredytów w Billing lub zatrzymanie zadania; ponowne wpisanie nie dodaje kredytów. |
| 429 | Poczekaj na Retry-After i zmniejszyć współwartość. Zachowaj obecny profil i dowód rejestracyjny; nie tworzyć prób zastępczych. |
| Lokalne MCP nie może odczytać klucza | Ustaw FLASHDATA_API_KEY gdzie rozpoczyna się proces hosta i uruchom go ponownie. Klucz zapisany przez flashdata auth login nie jest automatycznie eksportowany do lokalnego MCP. |
| Plik wyjściowy CLI już istnieje | Przeczytaj ./codex-first-search.json. Aby ponownie wyeksportować zapisany sukces, użyj flashdata runs show codex- first-search- 001 --result --output codex- first-search-copy.json z oryginalnym profilem. Używaj nowego uruchomienia ID tylko do zamierzonego nowego wyszukiwania. |
| Zaplanowane zadanie nie powiodło się | Wprowadź darmowe sprawdzenie ponownego użycia wewnątrz tego środowiska. Dopasuj użytkownika OS, profil hosta, sklep kredytowy i uprawnienia narzędzia. |
| Czas lub nieznany wynik | Przed ponownym uruchomieniem należy zachować polecenie lub zadanie ID i sprawdzić History. Należy użyć get_result, aby przywrócić kontynuację IDs. |

- [Przewodnik po odzyskiwaniu](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md)
- [Dokumentacja Codex MCP](https://learn.chatgpt.com/docs/extend/mcp)

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

## Uwagi do walidacji OAuth

OAuth login, callback, zapisane referencje, bezpłatne rozmowy cenowe, odświeżenie i cofnięcie zostały zweryfikowane na Windows z Codex 0.163.0-alpha.10.2 na 2026-10-21. Ta operacja nie potwierdzała płatnych zapytań ani zaplanowanej egzekucji. Instrukcje konfiguracji zostały sprawdzone w dokumentacji hosta 2026-11-05.

- [Oficjalne umiejętności](https://github.com/flashdatadev/flashdata-skills)
- [Pakiety MCP i źródło](https://github.com/flashdatadev/flashdata-mcp)
