# Codex

Cung cấp công cụ Google Search và YouTube cho Codex để lập trình và nghiên cứu.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/integrations/codex
Xem lại: 2026-11-05 by FlashData

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

## Trước khi bắt đầu

Đã có Cây Codex CLI đã cài đặt và làm việc. Máy chủ này MCP thiết lập OAuth Vì Google Search, YouTube SearchSiêu dữ liệu và bản sao. Bạn có thể tạo ra một FlashData tài khoản trong lúc đăng ký.

- [Dùng CLI Kĩ năng hoặc bắt đầu thử nghiệm](https://flashdata.dev/vi/docs/integrations/codex/reference.md#cli)
- [Cài đặt Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

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

## 1. Thêm MCP máy phục vụ

Nhập mục này vào/.codex/config.toml (hoặc config.toml dưới CODEX_HOME). Giữ khách đã đăng ký ID và gọi lại URL như đã trình bày.

### ~/.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. Ký vào

Chạy lệnh đăng nhập. Trong trình duyệt, ký hoặc tạo và kiểm tra một tài khoản, sau đó chấp thuận truy cập. Đợi thiết bị cuối xác nhận đăng nhập. Hàng loạt người sử dụng tín dụng của tài khoản đó.

### Đăng nhập

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


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

### Kiểm tra kết nối miễn phí

Bắt đầu một cuộc sống mới Codex phiên chạy và kiểm tra /mcp cho Flashdata. Gửi dấu nhắc này, cả hai cuộc gọi nên thành công. Số 0 vẫn xác nhận kết nối hoạt động.

#### Dán vào người đại diện của anh

```text
Sử dụng kết nối kiểu flashdata MCP.
nhỏ get_balance có {} và get_pricing có {"source":"google_search","request_count":1}.
Báo cáo tín dụng và mức giá ước tính. Đừng tìm kiếm.
```


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

## 3. Chạy nhiệm vụ đầu tiên của bạn

Gửi cái này cho tác nhân liên lạc của anh. kiểm tra miễn phí; tìm kiếm đơn lẻ sử dụng tín dụng.

### Nhắc công việc đầu tiên

```text
Dùng trình phục vụ Flashdata MCP. Kiểm tra số dư của tôi và giá của một cái Google Tìm kiếm.
Nếu được tài trợ, hãy gọi cho tôi. google_search một lần có truy vấn "site:docs.python.org/3/library/venv.html create virtual environment"num 5 và chế độ "realtime".
Giải thích làm thế nào để tạo ra a Python Môi trường ảo sử dụng các nguồn đã gửi về.
Nguồn tin và báo cáo về tín dụng thực tế đã được sử dụng. Dừng lại sau nhiệm vụ này.
```


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

### Những gì bạn nên nhìn thấy

Tìm kiếm một kết thúc google_search Công cụ điện thoại với status: done, liên kết từ results[].organic và câu trả lời dựa trên những nguồn đó. Sử dụng đến từ usage.credits; đó không phải là số lượng kết quả. Kết quả rỗng nên được báo cáo là rỗng.

- [Kiểm tra lịch sử yêu cầu](https://flashdata.dev/app/jobs)

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

## Những gì bạn có thể yêu cầu

Cái này OAuth kết nối bao gồm công cụ nghiên cứu. YouTube Download sử dụng chủ sở hữu API Name API hay CLI.

| Tác vụ | Công cụ MCP |
| --- | --- |
| Tìm nguồn web cho câu trả lời hay thực hiện | google_search |
| Tìm đoạn phim YouTube thích hợp | youtube_search |
| Đọc tựa video, kênh và siêu dữ liệu | youtube_metadata |
| Lấy một bản tóm tắt của video | youtube_transcript |
| Kiểm tra chi phí tín dụng và yêu cầu sẵn sàng | get_balance · get_pricing |

- [Công cụ và lược đồ MCP](https://flashdata.dev/vi/docs/mcp/reference.md)
- [Thiết lập YouTube Download](https://flashdata.dev/vi/docs/guides/youtube-download-guide/reference.md)

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

## Dùng lại quyền truy cập các tác vụ lặp lại

Dùng cùng một cách Codex hồ sơ, OS người dùng và cửa hàng chứng nhận. Tạo thời gian biểu trong máy tác nhân hoặc bộ lập lịch đã có; FlashData cung cấp các công cụ dữ liệu.


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

### Kiểm tra truy cập đã lưu

Kiểm tra miễn phí này trong một phiên làm việc mới trong môi trường theo lịch trình. Cả hai cuộc gọi nên thành công mà không cần đăng nhập trình duyệt mới.

#### Dùng lại kiểm tra

```text
Dùng lại kết nối flashdata MCP đã có.
nhỏ get_balance có {} và get_pricing có {"source":"google_search","request_count":1}.
Báo cáo xem cả hai có thành công không. Không tìm kiếm hoặc tạo truy cập mới.
```


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

### Tạo tác vụ lặp lại

Trong lịch trình của chủ nhà, hãy chọn thời gian và múi giờ, ví dụ hàng ngày tại 09:00 Asia/Shanghai. Hãy dùng nó như một cơ thể nhiệm vụ. Chạy nó một lần ở đó và kiểm tra báo cáo đã lưu trước khi hiệu lực tái phát.

#### Thi thể tác vụ

```text
Dùng lại kết nối flashdata MCP đã có. Kiểm tra get_balance và get_pricing cho một người Google Tìm kiếm.
Nếu được phép và được tài trợ, hãy chạy. google_search Một lần cho "site:docs.python.org/3/library/venv.html create virtual environment" với num 5 và chế độ "realtime".
Lưu báo cáo có ngày tháng với nguồn URLstrích đoạn và tín dụng thực tế được sử dụng.
Hãy dừng truy cập bị thu hồi hoặc không đủ tín dụng; tôn trọng Retry-After. Không tạo một phiên tòa, yêu cầu quyền truy cập mới hoặc lặp lại một yêu cầu không rõ kết quả.
```

- [Đang đệ quy hướng dẫn tác vụ](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)
- [CLI Lên kế hoạch và hồi phục](https://flashdata.dev/vi/docs/guides/cli-automation/reference.md#recurring)

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

### Thư mục lưu trữ và cập nhật văn bản

Codex giữ OAuth trong các cửa hàng đã được cấu hình. Khác biệt OS người dùng, hồ sơ hay môi trường thực hiện có thể cần sự kết nối được chấp nhận riêng.

Người dẫn chương trình cập nhật một giờ. OAuth Bảng điều khiển truy cập bằng cách xoay bảng hiệu cập nhật. Tái kết nối khi 90- trợ cấp hàng ngày hết hạn hoặc bị thu hồi. Mỗi bản cài đặt sở hữu cửa hàng tượng trưng của nó; không chia sẻ các tập tin đã được cập nhật giữa các máy.


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

### Thu hồi hoặc tái kết nối

1. Tạm dừng các tác vụ theo lịch, rồi hủy tên OAuth kết nối FlashData Settings → Connected apps.
2. Yêu cầu tác nhân gọi get_balance một lần với sự kết nối được lưu. Nó sẽ thất bại trong việc xác thực hoặc yêu cầu tái kết nối. Không chấp nhận đăng nhập mới trong khi chọn.
3. Nhấc bỏ địa phương OAuth Thông tin với lệnh dưới đây. Để kết nối lại sau, lặp lại bước 2 với sự chấp thuận của chủ sở hữu và kiểm tra kết nối miễn phí.

#### Đã lưu OAuth Thông tin

```bash
codex mcp logout flashdata
```

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

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

## Thêm tùy chọn thiết lập

Thêm kỹ năng lưu thông công việc vào MCP kết nối hay chọn CLI Truy cập hay địa phương MCP máy chủ.


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

### Thêm MCP Kĩ năng

Kĩ năng của Flashdata-mcp đã dạy người đại diện của bạn cách sử dụng các công cụ kết nối. Nó tái sử dụng kết nối ở trên.

Chạy khỏi dự án của anh. Chọn bản địa FlashData CLI v1.2.1, hoặc các kỹ năng cài đặt với Node.js 22.20+ và npm. Khởi động một phiên chạy Codex mới và yêu cầu sử dụng flashdata-mcp.

#### FlashData CLI

##### Trong dự án của bạn

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


#### Node.js / npm

##### Trong dự án của bạn

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


- [CLI cài đặt](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md#install)
- [Đọc kỹ năng MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Cập nhật hoặc gỡ bỏ các kỹ năng](https://flashdata.dev/vi/docs/guides/agent-skill-management/reference.md)

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

### Dùng CLI Kĩ năng hoặc bắt đầu thử nghiệm

Cài đặt FlashData CLI v1.2.1 và chạy khỏi dự án của bạn. Chọn một thẻ truy cập. Ví dụ sử dụng mặc định CLI hồ sơ, tách ra MCP OAuth; giữ cho bạn tồn tại --profile và --state-dir nếu bạn sử dụng các tùy chỉnh.

Cài đặt CLI kỹ năng vào .agents/skills. Bắt đầu một cuộc sống mới Codex phiên chạy sau khi cài đặt và yêu cầu sử dụng Google tìm kiếm.

#### Phím API tồn tại

Dán một phím bằng google_search Cho phép tại dấu nhắc ẩn. Để nhập vô ích, ống nó từ người quản lý bí mật của bạn đến auth login --api-key-stdin --non-interactive.

##### 1. Nhập và xác minh phím

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

##### 2. Kiểm tra sự thăng bằng và chi phí — không tìm kiếm

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

# Tiếp tục chỉ nếu accessVerified và estimateAvailable phải true,
# google_search được cho phép, và availableCredits bao gồm estimatedCredits.
```

##### 3. Chạy một lần ./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

# Đọc tập tin đã lưu: results[].organic, usage.credits.
# Thiết bị cuối JSON báo cáo đường dẫn ra; giữ cho chạy ID để hồi phục.
```


#### Lưu truy cập CLI

Hãy dùng lại chìa khóa hay thử nghiệm đã có. Nếu FLASHDATA_API_KEY là thiết lập, nó cần ưu tiên hơn chìa khóa đã lưu; kiểm tra lại lời tường thuật do auth status.

##### 1. Dùng lại và xác nhận truy cập đã lưu

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

##### 2. Kiểm tra sự thăng bằng và chi phí — không tìm kiếm

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

# Tiếp tục chỉ nếu accessVerified và estimateAvailable phải true,
# google_search được cho phép, và availableCredits bao gồm estimatedCredits.
```

##### 3. Chạy một lần ./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

# Đọc tập tin đã lưu: results[].organic, usage.credits.
# Thiết bị cuối JSON báo cáo đường dẫn ra; giữ cho chạy ID để hồi phục.
```


#### Thử ra vô lý

Dùng lại một lần thử ra hay đăng ký đã có. Nếu đã quá hạn, kiệt sức hoặc thu hồi, phục hồi hoặc tuyên bố như vậy. Trước khi tái phát CLI tác vụ, lấy tài khoản và xác nhận recurringAllowed: true in auth status.

##### 1. Cài đặt và xác nhận truy cập thử nghiệm

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

##### 2. Kiểm tra sự thăng bằng và chi phí — không tìm kiếm

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

# Tiếp tục chỉ nếu accessVerified và estimateAvailable phải true,
# google_search được cho phép, và availableCredits bao gồm estimatedCredits.
```

##### 3. Chạy một lần ./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

# Đọc tập tin đã lưu: results[].organic, usage.credits.
# Thiết bị cuối JSON báo cáo đường dẫn ra; giữ cho chạy ID để hồi phục.
```


- [Tải về CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [CLI cài đặt](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md#install)
- [Phục hồi kết quả đã lưu](https://flashdata.dev/vi/docs/guides/cli-automation/reference.md#recover)
- [Bị cáo trước khi tái diễn CLI tác vụ](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md)

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

### Chạy cục bộ MCP với một API Khóa

Yêu cầu Node.js 22.18+, npm và a API phím với google_search Cho phép nhiệm vụ đầu tiên. Chạy cái nàyflashdata-dev/mcp 0.2.0; nó không đọc FlashData CLIĐã lưu chìa khóa hoặc MCP OAuth đồ đạc.

Đặt chìa khóa trong thiết bị cuối, thay thế toàn bộ mục nhập kiểu flashdata trước đó (bao gồm cả nó OAuth Phần phụ) với cấu hình bên dưới, sau đó bắt đầu Codex từ nhà ga đó. Một tác nhân có thể sử dụng một biến môi trường đã có thay vì dấu nhắc ẩn.

Sau khi thiết lập, hãy chạy dấu nhắc kết nối miễn phí ở trên trong một phiên chạy tác nhân mới. Một khi cả hai kiểm tra đều được thông qua, hãy dùng dấu nhắc đầu tiên. API- Truy cập phím không cần thiết đăng nhập mcp.

#### Bash

##### 1. Đặt khóa mà không in ra

```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. Thay thế mục nhập trong ~/.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. Chạy một phiên chạy mới trong thiết bị cuối này

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Đặt khóa mà không in ra

```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. Thay thế mục nhập trong ~/.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. Chạy một phiên chạy mới trong thiết bị cuối này

```powershell
codex
```


- [Chạy kiểm tra kết nối miễn phí](https://flashdata.dev/vi/docs/integrations/codex/reference.md#connection-check)
- [Tạo ra một API Khóa](https://flashdata.dev/app/api-keys)
- [Cục bộ MCP Tài liệu](https://github.com/flashdatadev/flashdata-mcp)

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

## Khắc phục sự cố

| Vấn đề | Thử cái này đi |
| --- | --- |
| Không FlashData công cụ | Chạy danh sách thư mục dạng Mcp, sau đó /mcp trong một phiên họp mới. Kiểm tra tập tin cấu hình và finish Đăng nhập. |
| Thiếu kỹ năng | Kiểm tra .agents/skills trong dự án này. Cho một người bản địa MCP- giết cài đặt, chạy flashdata probite --agent Sổ tay --skill Tia sáng-mcp. Khởi động lại phiên chạy. |
| invalid_client / callback | So sánh bước 1 Chính xác. Hoàn toàn cho phép trong một trình duyệt mà có thể đạt được cuộc gọi trở lại của máy. |
| 401 | Kiểm tra xem kết nối hay phím đã bị hủy hay hết hạn. Vì OAuth, lặp lại ký với sự chấp thuận của chủ sở hữu; CLIchạy flashdata auth status. Đang thêm tín dụng sẽ không sửa chữa xác thực. |
| 403 | Kiểm tra xem có cho phép nguồn chưa. Nghiên cứu OAuth không bao gồm YouTube Download; sử dụng API- Thiết lập khóa. Sửa chữa sự cho phép trước khi thử lại. |
| 402 | Kiểm tra get_balance hoặc đăng ký kết thúc tài khoản. Thêm tín dụng vào Billing hoặc dừng lại; đăng ký lại không thêm tín dụng. |
| 429 | Đợi Retry-After và giảm bớt sự đồng thuận. Bảo tồn hồ sơ hiện thời và chứng minh đăng ký; không tạo thử ra cách thay thế. |
| Cục bộ MCP không thể đọc khóa | Đặt FLASHDATA_API_KEY nơi máy khởi động lại nó. Name auth login không tự động xuất sang cục bộ MCP. |
| CLI Tập tin xuất đã tồn tại | Đọc ./codex-first-search.json. Để xuất khẩu lại thành công đã lưu, hãy dùng flashdata runs show codex- Tìm kiếm đầu tiên.001 --result --output codex-first-search-copy.json với hồ sơ gốc. Dùng một lần chạy mới ID Chỉ để tìm kiếm mới có mục đích. |
| Việc đã lập lịch bị lỗi | Kiểm tra lại trong môi trường đó. Khớp OS người dùng, hồ sơ máy, cửa hàng chứng nhận và quyền công cụ. |
| Kết quả không có thời hạn hoặc không rõ | Giữ yêu cầu hay công việc ID và kiểm tra History Trước khi phục hồi. Dùng get_result để tiếp tục cung cấp IDs. |

- [Hướng dẫn phục hồi](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md)
- [Codex MCP Tài liệu](https://learn.chatgpt.com/docs/extend/mcp)

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

## OAuth ghi chú hợp lệ

OAuth Đăng nhập, gọi lại, lưu ủy nhiệm, một cuộc gọi giá trị miễn phí, cập nhật và gửi lại được kiểm tra trên Windows có Codex 0.163.0-alpha.10.2 trên 2026-10-21. Cuộc chạy đua đó không xác nhận các yêu cầu được thanh toán hoặc được lên lịch thi hành án. Thiết lập hướng dẫn đã được kiểm tra chống lại tài liệu hướng dẫn máy về 2026-11-05.

- [Kĩ năng chính thức](https://github.com/flashdatadev/flashdata-skills)
- [MCP gói và nguồn](https://github.com/flashdatadev/flashdata-mcp)
