# Codex

코딩 및 연구에 대한 Codex Google Search 및 YouTube 도구를 제공합니다.

Canonical 참고: https://flashdata.dev/ko/docs/integrations/codex
검토: 2026-11-05 FlashData

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

## 시작하기 전에

Codex CLI의 특징 설치 및 작업이 있습니다. 이 호스팅 MCP 설정은 Google Search, YouTube Search, Metadata 및 Transcript의 OAuth를 사용합니다. 로그인 중에 FlashData 계정을 만들 수 있습니다.

- [CLI 기술을 사용하거나 시험 시작](https://flashdata.dev/ko/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 세션을 시작하고 Flashdata에 /mcp를 확인하십시오. 이 프롬프트를 전송; 두 호출은 성공해야합니다. 0 균형은 여전히 작업 연결을 확인합니다.

#### 당신의 대리인에 붙여넣기

```text
flashdata MCP 연결을 사용하세요.
get_balance에는 {}, get_pricing에는 {"source":"google_search","request_count":1}를 전달해 호출하세요.
사용 가능한 크레딧과 예상 요금을 보고하세요. 검색은 실행하지 마세요.
```


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

## 3. 첫 번째 작업을 실행

당신의 연결 대리인에 이것을 보내십시오. 체크는 무료입니다; 단일 검색은 크레딧을 사용합니다.

### 첫 번째 작업 프롬프트

```text
flashdata MCP 서버를 사용하십시오. Google 검색의 잔액과 가격을 확인합니다.
펀딩된 경우, 쿼리 "site:docs.python.org/3/library/venv.html create virtual environment", num 5 및 모드 "realtime"로 한 번 google_search를 호출합니다.
반환된 소스를 사용하여 Python 가상 환경을 만드는 방법을 설명합니다.
Cite 소스 및 보고서 실제 크레딧 사용. 이 작업을 중지합니다.
```


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

### 당신이 볼 수 있습니다

완료된 google_search 도구는 status: done, results[].organic의 소스 링크 및 그 소스에 따라 답변을 호출합니다. 사용법은 usage.credits에서 옵니다; 결과의 수가 아닙니다. 빈 결과는 빈으로 보고되어야 합니다.

- [Inspect 요청 내역](https://flashdata.dev/app/jobs)

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

## 자주 묻는 질문

이 OAuth 연결은 연구 공구를 포함합니다. YouTube Download는 API 또는 CLI를 통해 소유자 API 열쇠와 목적지 저장을 사용합니다.

| 의논하기 | MCP 도구 |
| --- | --- |
| 답변 및 구현을위한 웹 소스 찾기 | google_search |
| 관련 YouTube 동영상 찾기 | youtube_search |
| 동영상 제목, 채널 및 메타데이터 읽기 | youtube_metadata |
| 요약에 대한 비디오의 성적표 | youtube_transcript |
| 사용 가능한 신용 및 요청 비용 확인 | get_balance · get_pricing |

- [MCP 도구 및 스키마](https://flashdata.dev/ko/docs/mcp/reference.md)
- [YouTube Download 설정](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md)

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

## recurring 작업에 대한 액세스 재사용

동일한 Codex 프로파일, OS 사용자 및 자격 저장을 사용하십시오. 에이전트 호스트 또는 기존 스케줄러의 일정을 작성하십시오. FlashData는 데이터 도구를 공급합니다.


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

### 저장된 접근

예약된 환경에서 신선한 세션에서 무료 체크를 실행하십시오. 두 호출은 새로운 브라우저 로그인없이 성공해야합니다.

#### 자주 묻는 질문

```text
기존 flashdata 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/ko/docs/guides/recurring-tasks/reference.md)
- [CLI 스케줄링 및 복구](https://flashdata.dev/ko/docs/guides/cli-automation/reference.md#recurring)

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

### Credential 저장과 새로 고침

Codex는 OAuth 토큰을 구성한 자격 증명 저장소에 보관합니다. 다른 OS 사용자는, 단면도 또는 실행 환경 그것의 자신의 승인한 연결을 필요로 할지도 모릅니다.

호스트는 회전식 갱신 토큰을 사용하여 유효 기간이 1시간인 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 기술 추가

flashdata-mcp 기술은 연결된 도구를 사용하는 에이전트를 가르칩니다. 위 연결을 재사용합니다.

당신의 프로젝트에서 실행. 기본 FlashData CLI v1.2.1를 선택하거나 Node.js 22.20+ 및 npm를 가진 기술 설치자를 선택하십시오. 새로운 Codex 세션을 시작하고 flashdata-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/ko/docs/guides/flashdata-cli/reference.md#install)
- [MCP 기술 읽기](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [업데이트 또는 기술을 제거](https://flashdata.dev/ko/docs/guides/agent-skill-management/reference.md)

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

### CLI 기술을 사용하거나 시험 시작

FlashData CLI v1.2.1를 설치하고 당신의 프로젝트에서 실행하십시오. 1개의 접근 탭을 선택하십시오. 예제는 MCP OAuth과 별도로 기본 CLI 프로파일을 사용합니다. 기존 --profile 및 --state-dir를 유지하면 사용자 정의를 사용할 수 있습니다.

설정 설치 CLI 기술 .agents/skills. 설치 후 새로운 Codex 세션을 시작하고 Google-search를 사용하도록 요청하십시오.

#### 기존 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를 지킵니다.
```


#### Eligible 시험

기존의 평가판을 재사용하거나 한번 등록하십시오. 만료된 경우, 소진 또는 재조정, 복구 또는 청구. CLI 작업을 반복하기 전에 계정을 주장하고 auth status에서 recurringAllowed: true를 확인합니다.

##### 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/ko/docs/guides/flashdata-cli/reference.md#install)
- [저장된 결과를 복구](https://flashdata.dev/ko/docs/guides/cli-automation/reference.md#recover)
- [CLI 작업을 재발송하기 전에 클레임](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md)

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

### API 키로 로컬 MCP 실행

Node.js 22.18+, npm 및 API 키와 google_search의 첫 번째 작업에 대한 권한이 필요합니다. 이 실행 @flashdata-dev/mcp 0.2.0; 그것은 FlashData CLI의 저장된 키 또는 MCP OAuth 토큰을 읽지 않습니다.

터미널의 키를 설정하면 이전 플래시 데이터 입력 (OAuth 하위 섹션 포함)을 아래 구성으로 교체 한 다음 그 터미널에서 Codex를 시작합니다. 에이전트는 숨겨지은 프롬프트 대신 기존의 주사 환경 변수를 사용할 수 있습니다.

설정 후, 새로운 에이전트 세션에서 위의 무료 연결 체크 프롬프트를 실행합니다. 모두 체크 패스를 한 번, first-task prompt를 사용하십시오. API-key 액세스는 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/ko/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 도구 없음 | 코드 mcp 목록을 실행, 다음 /mcp 신선한 세션. config 파일과 finish 로그인을 확인합니다. |
| 기술 누락 | 이 프로젝트에서 .agents/skills를 확인하십시오. 네이티브 MCP-skill 설치를 위해서는 Flashdata 기술을 실행하여 --agent 코덱 --skill 플래시데이터-mcp를 확인합니다. 세션을 재시작합니다. |
| invalid_client / callback | 단계 1를 정확히 비교하십시오. 호스트의 콜백을 시작할 수 있는 브라우저의 인증. |
| 401 | 연결 또는 키가 재발 또는 만료되었는지 확인하십시오. OAuth를 위해, 소유자 승인을 가진 반복 표시에서; CLI를 위해, flashdata auth status를 실행하십시오. 신용을 추가하면 인증이 되지 않습니다. |
| 403 | 요청된 소스 권한 확인. 연구 OAuth는 YouTube Download를 포함하지 않습니다; 그것의 API-key 설치를 사용하십시오. 재발송하기 전에 허가를 수정합니다. |
| 402 | get_balance 또는 flashdata 계정 잔액을 확인하십시오. Billing에서 크레딧을 추가하거나 작업을 중지하십시오. 다시 로그인하면 크레딧을 추가하지 않습니다. |
| 429 | Retry-After만큼 기다리고 동시 실행 수를 줄이세요. 현재 프로필과 등록 증명을 유지하고 대체 체험을 만들지 마세요. |
| 로컬 MCP는 키를 읽을 수 없습니다 | 호스트 프로세스가 시작되고 다시 시작되는 FLASHDATA_API_KEY를 설정합니다. flashdata 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를 확인하십시오. 반환 continuation IDs를 위한 get_result를 사용하십시오. |

- [복구 가이드](https://flashdata.dev/ko/docs/guides/agent-recovery/reference.md)
- [Codex MCP 문서](https://learn.chatgpt.com/docs/extend/mcp)

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

## OAuth 검증 노트

OAuth 로그인, 콜백, 저장된 자격 증명, 무료 가격 통화, 새로 고침 및 재발견은 Codex 0.163.0-alpha.10.2 2026-10-21를 가진 Windows에 확인되었습니다. 즉, 유료 쿼리 또는 예정된 실행을 유효하지 않았다. 설정 지침은 2026-11-05의 호스트 문서에 대해 확인되었습니다.

- [공식 기술](https://github.com/flashdatadev/flashdata-skills)
- [MCP 패키지 및 소스](https://github.com/flashdatadev/flashdata-mcp)
