Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Tích hợp

Codex

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

Trên trang này

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ý.

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
[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. 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
codex mcp login flashdata --scopes mcp:research

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

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

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.

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ệngoogle_search
Tìm đoạn phim YouTube thích hợpyoutube_search
Đọc tựa video, kênh và siêu dữ liệuyoutube_metadata
Lấy một bản tóm tắt của videoyoutube_transcript
Kiểm tra chi phí tín dụng và yêu cầu sẵn sàngget_balance · get_pricing

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.

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

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ụ
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ả.

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.

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
codex mcp logout flashdata

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ủ.

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.

Trong dự án của bạn
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

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.

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

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.

1. Đặt khóa mà không in ra
# 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
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "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
codex

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ăngKiể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 / callbackSo 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.
401Kiể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.
403Kiể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.
402Kiể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ỗiKiể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.

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.