openai-docs

OpenAI Docs

OpenAI 개발자 문서(developers.openai.com MCP 서버)를 사용하여 권위 있고 현재성 있는 안내를 제공합니다. "Docs MCP"는 mcp__openaiDeveloperDocs__search_openai_docs 및 mcp__openaiDeveloperDocs__fetch_openai_doc을 의미합니다. API 참조, 스키마, 파라미터 또는 필수 필드 질문에는 사용 가능할 때 mcp__openaiDeveloperDocs__get_openapi_spec도 사용합니다. 공식 도메인 웹 검색은 해당 도구를 사용할 수 없거나 도움이 되지 않을 때 폴백입니다. Codex에 대한 광범위한 질문은 Docs MCP 전에 매뉴얼 도우미를 사용합니다. 이 스킬은 모델 선택, API 모델 마이그레이션 및 프롬프트 업그레이드 안내도 담당합니다.

API 키 설정

API 기반 앱, 스크립트, CLI, 생성기 또는 도구를 빌드, 실행, 구성, 디버그 또는 구현하는 요청의 경우, 사용 가능할 때 먼저 openai-platform-api-key를 사용하세요. 해당 자격 증명 게이트가 해결된 후 필요에 따라 현재 문서를 위해 이곳으로 돌아오세요.

API 기반 아티팩트를 빌드하거나 실행하지 않는 문서 전용 질문, 인용, 모델/API 안내, 개념 설명 및 예제에는 이 스킬을 직접 사용하세요.

워크플로 구성

출처 우선순위

• Codex 자체 지식의 경우 아래 Codex 출처 경로를 사용하세요. 매뉴얼 도우미, Docs MCP 또는 제한된 불확실성을 언제 사용할지 결정합니다.
• Codex 외 OpenAI 문서 질문의 경우 mcp__openaiDeveloperDocs__search_openai_docs를 사용하여 가장 관련성 높은 문서 페이지를 찾으세요.
• Codex 외 OpenAI 문서 질문의 경우 답변하기 전에 mcp__openaiDeveloperDocs__fetch_openai_doc으로 관련 페이지를 가져오세요. 검색이 잡음이 많으면 더 좁은 Docs MCP 검색을 실행하세요. 알려진 공식 OpenAI 문서 URL이 있거나 발견된 경우 웹 검색 콘텐츠에 의존하기 전에 Docs MCP를 통해 해당 URL을 가져오는 것을 시도하세요.
• API 참조, 스키마, 파라미터 또는 필수 필드 질문의 경우 사용 가능할 때 mcp__openaiDeveloperDocs__get_openapi_spec을 사용하여 관련 가이드 또는 참조 페이지와 함께 API 형태를 확인하세요.
• 명확한 쿼리 없이 Codex 외 페이지를 탐색하거나 발견해야 할 때만 mcp__openaiDeveloperDocs__list_openai_docs를 사용하세요.
• 모델 선택, "최신 모델" 또는 기본 모델 질문의 경우 먼저 https://developers.openai.com/api/docs/guides/latest-model.md를 가져오세요. 해당 페이지를 사용할 수 없으면 references/latest-model.md를 로드하세요.
• 모델 업그레이드 또는 프롬프트 업그레이드의 경우 대상이 최신/현재/기본 또는 달리 지정되지 않은 경우에만 node scripts/resolve-latest-model-info.js를 실행하고, 그렇지 않으면 명시적으로 요청된 대상을 유지하세요.
• 명시적 대상 요청을 유지하세요. 사용자가 "GPT-5.4로 마이그레이션"과 같은 대상 모델을 지정한 경우 latest-model.md가 최신 모델을 명명하더라도 요청된 대상을 유지하세요. 최신 안내는 선택 사항으로만 언급하세요.
• 현재 원격 안내가 필요한 경우 반환된 마이그레이션 및 프롬프팅 가이드 URL을 직접 가져오세요. 직접 가져오기가 실패하면 MCP/검색 폴백을 사용하고, 그것도 실패하면 번들 폴백 참조를 사용하고 폴백을 공개하세요.

OpenAI 제품 개요

1. Apps SDK: 채팅GPT 앱을 빌드합니다. 웹 컴포넌트 UI와 앱의 도구를 ChatGPT에 노출하는 MCP 서버를 제공합니다.
2. Responses API: 에이전틱 워크플로에서 상태 저장, 멀티모달, 도구 사용 상호작용을 위해 설계된 통합 엔드포인트입니다.
3. Chat Completions API: 대화를 구성하는 메시지 목록에서 모델 응답을 생성합니다.
4. Codex: 소프트웨어 개발을 위한 OpenAI의 코딩 에이전트로, 코드를 작성, 이해, 검토 및 디버깅할 수 있습니다.
5. gpt-oss: Apache 2.0 라이선스로 출시된 오픈 웨이트 OpenAI 추론 모델(gpt-oss-120b 및 gpt-oss-20b)입니다.
6. Realtime API: 자연스러운 음성-음성 대화를 포함한 저지연 멀티모달 경험을 구축합니다.
7. Agents SDK: 모델이 도구와 컨텍스트를 사용하고, 다른 에이전트에 넘기고, 부분 결과를 스트리밍하고, 전체 추적을 유지할 수 있는 에이전틱 앱을 구축하기 위한 툴킷입니다.

Codex 자체 지식

이 경로는 Codex 자체에 대한 질문(구성, 확장, 운영, 문제 해결, 로컬 상태, 제품 표면 또는 Codex 동작이 있어야 하는 위치)에 사용합니다. 플러그인, 스킬, 훅, MCP 서버, 브라우저 또는 자동화를 단순히 언급하는 코드베이스로는 충분하지 않습니다. 일반 소프트웨어 작업의 경우 소프트웨어 작업에 직접 답변하고, Codex 자체 지식이 적용되는지 묻는 경우 해당 메타 질문에 간략히 답변하고 요청된 아티팩트를 계속 진행합니다.

출처 경로

Codex 매뉴얼은 광범위한 Codex 종합 정보의 첫 번째 출처입니다. 매뉴얼과 Docs MCP를 상호 교환 가능한 공식 문서 출처가 아닌 별개의 경로로 취급하세요. 게시된 사용자 Codex 제품 답변의 경우 출처 경로는 완전합니다. 즉, 매뉴얼, 이 경로가 요청할 때 Docs MCP, 공식 OpenAI 웹 폴백, 그리고 현재 세션에서 해당 기능에 대한 질문이 있을 때 표면화된 호출 가능한 기능입니다. developers.openai.com 외부의 지식 베이스는 공개 제품 답변을 위한 이 경로 밖에 있습니다.

광범위한 Codex 동작, 설정, 사용자 지정, 스킬, 플러그인, MCP, 훅, AGENTS.md, 자동화, 표면, 로컬 상태 또는 시스템 맵 질문의 경우:

1. 동일한 스레드의 매뉴얼 및 개요 경로가 여전히 최신 상태일 때 재사용합니다.
2. 그렇지 않으면 일반 쓰기 가능 세션에서 먼저 스킬 로컬 도우미를 실행합니다. 세션이 명시적으로 읽기 전용이거나, 셸 실행을 사용할 수 없거나, 정책에 허용된 임시 캐시가 표시되지 않는 경우에만 시도하지 않고 건너뜁니다.
3. 기본적으로 도우미는 다음 순서로 첫 번째 사용 가능한 임시 캐시 디렉토리를 선택합니다: $TMPDIR/openai-docs-cache, %TEMP%\openai-docs-cache, %TMP%\openai-docs-cache, /private/tmp/openai-docs-cache, /tmp/openai-docs-cache. 작업 공간 전용 쓰기 액세스만으로는 이 임시 캐시에 충분하지 않습니다.
4. 캐시 디렉토리를 재정의해야 하는 경우가 아니면 도우미를 직접 실행하세요. 도우미는 네이티브 fetch를 사용할 수 없거나 프록시 환경 변수가 있을 때 curl로 폴백하므로 셸별 프록시 접두사가 필요하지 않습니다. <skill-dir>을 이 스킬의 실제 디렉토리로 확인하세요. 복사된 로컬 평가 작업 디렉토리에서는 일반적으로 .codex/skills/openai-docs입니다:

node <skill-dir>/scripts/fetch-codex-manual.mjs

캐시 디렉토리를 재정의해야 하는 경우 --cache-dir <cache-dir>를 전달하세요. Windows에서 도우미는 %TEMP% 및 %TMP%를 자동으로 확인합니다. PowerShell에서는 $env:TEMP\openai-docs-cache가 일반적인 명시적 재정의입니다.

도우미 가용성은 명시적인 읽기 전용/셸 없음 정책 또는 실제 명령 결과에 의해 설정된 것으로 간주합니다. 추측된 샌드박스 또는 추측된 도우미 실패는 Docs MCP 또는 웹 검색으로 전환하기에 충분하지 않습니다. 실제 도우미 명령 실패 후에는 아래 가장 좁은 공식 다음 출처로 계속 진행하세요.

도우미는 최신 상태를 확인하고 codex-manual.md를 쓰고 codex-manual.outline.md를 내보냅니다. 개요는 출처 페이지와 제목을 줄 범위에 매핑합니다. 이를 사용하여 관련 매뉴얼 섹션을 선택한 다음 Codex 제품 사실에 대해 대상 매뉴얼 섹션을 읽거나 검색하세요. 스킬 디렉토리를 사용하여 도우미를 찾고 실행하세요. 도우미가 성공한 후 반환된 매뉴얼 및 개요 경로를 Codex 제품 사실 및 용어 범위 확인을 위한 검색 범위로 사용하세요.

후속 Codex 질문에 대해 동일한 스레드의 매뉴얼 및 개요 경로를 재사용하세요. 매뉴얼이 약 하루 이상 전에 가져온 경우, 경로를 사용할 수 없는 경우, 경로가 다른 스레드 또는 불확실한 출처에서 온 경우, 또는 최신 정보가 누락되고 오래된 것이 그럴듯한 경우 먼저 새로고침하세요.

매뉴얼이 지금 의존하기에 충분히 최신인지에 대한 질문의 경우 임시 캐싱이 허용될 때 도우미를 실행하고 반환된 상태, 매뉴얼 경로 및 개요 경로를 기반으로 답변하세요.

매뉴얼이 Codex 주장을 해결하면 그로부터 답변하고 해당 주장에 대한 출처 확장을 중단하고, 문서 조회가 하나의 종속성에 불과했다면 사용자의 더 넓은 작업을 계속하세요. 매뉴얼 출처 페이지 및 알려진 앵커는 매뉴얼이 다루는 자료에 대한 충분한 인용 지원입니다.

세션이 읽기 전용이거나, 셸 실행이 없거나, 허용된 임시 캐시가 없어 도우미를 건너뛴 경우 다음 출처는 Docs MCP입니다. 먼저 mcp__openaiDeveloperDocs__search_openai_docs를 호출한 다음 웹 폴백 전에 관련 결과에 대해 mcp__openaiDeveloperDocs__fetch_openai_doc을 호출하세요.

사용자가 최신 매뉴얼이 사용하지 않는 Codex 용어나 모드를 언급하는 경우, 매뉴얼에서 명백히 인접한 개념을 검색한 다음 정확한 용어가 문서화되지 않았으며 가장 가까운 문서화된 용어를 사용한다고 답변하세요. 프롬프트가 해당 용어가 Codex 동작에 어떻게 매핑되는지 묻는 경우 인접한 매뉴얼 섹션에서 매핑을 해결하세요. 해당 매뉴얼 패스 후에도 정확한 용어가 여전히 중요하거나 현재 그럴듯한 경우 제한된 불확실성 전에 하나의 좁은 Docs MCP 검색/가져오기를 사용하세요. 그렇지 않으면 해당 용어 또는 매핑 주장에 대한 출처 조회가 완료됩니다.

매뉴얼을 사용할 수 없거나, 도우미가 실패하거나, 임시 캐싱이 허용되지 않거나, 다른 중요한 주장이 누락되었거나 오래된 것으로 보이거나, 사용자가 페이지별 인증이 명시적으로 필요한 경우에만 가장 좁은 공식 다음 출처를 사용하세요. 하나의 특정 Docs MCP 검색을 선호하고, 명확히 관련 페이지를 반환하면 하나의 가져오기를 선호하세요. 해결되지 않은 Codex 기능 이름, 약어, 스케줄링 용어 또는 정확한 오류 텍스트의 경우 이 Docs MCP 단계는 웹 검색 전의 다음 출처입니다. 매뉴얼과 허용된 Docs MCP 갭 필 이후에는 나머지 갭을 제한된 불확실성으로 해결하세요. 공식 도메인 웹 폴백은 해당 Docs MCP 경로를 사용할 수 없거나 도움이 되지 않는 경우에만 사용하세요. 주장이 여전히 확립되지 않은 경우 제한된 불확실성으로 중단하세요. 공식 문서/매뉴얼이 현재 세션에서 이미 표면화된 호출 가능한 기능과 충돌하는 경우 충돌을 명시하고 해당 환경에 대해 확인된 현재 세션 동작을 선호하세요.

문서화되지 않았거나 비공개로 보이는 모델 슬러그, 제품 모드 레이블, 자격 레이블, 계정 액세스 경로 또는 롤아웃 이름의 경우 현재 공개 문서 및 제한된 불확실성으로 답변하세요. 해당 레이블은 공개 출처 경로를 떠나는 이유가 아닙니다.

지원 스타일 진단의 경우 공급자별 웹 조회보다 매뉴얼의 계층별 답변을 선호하세요: 설치/활성화된 플러그인, 번들 앱 또는 커넥터 권한 부여, MCP 설정, 작업 공간/관리자 정책, 재시작 또는 새 스레드 기대치, 그래도 해결되지 않으면 지원 또는 피드백.

출처 경로가 여전히 주장을 확립하지 못하는 경우 제한된 불확실성을 반환하거나 조사 범위를 넓히는 대신 지원, 관리자 또는 제품 피드백으로 라우팅하세요.

해결되지 않은 제품 용어의 경우 매뉴얼과 허용된 공식 다음 출처에서 답변하세요. 해당 출처가 용어를 확립하지 못하는 경우 해당 출처의 제한된 불확실성으로 답변하세요.

표면 맵

Codex 명사 또는 지속적 명령 표면이 겹칠 때 범위와 일치하는 가장 작은 표면을 권장합니다:

• 프롬프트 또는 스레드 컨텍스트 -> 일회성 작업 제약 조건.
• AGENTS.md -> 지속적인 저장소 규칙, 명령, 검증 단계 및 검토 기대치. 가까운 중첩 파일은 하위 트리 아래에 적용됩니다.
• 프로젝트 .codex/config.toml -> 신뢰할 수 있는 저장소 Codex 설정(샌드박스, MCP, 훅, 모델 또는 추론 기본값).
• 글로벌 구성 또는 글로벌 안내 -> 저장소 전반의 개인 기본값.
• 스킬 -> 참조 또는 스크립트가 포함된 재사용 가능한 작업 워크플로.
• 플러그인 -> 명령, 도구, MCP 구성, 훅, 에셋, 앱 또는 마켓플레이스 메타데이터가 포함된 스킬 번들.
• MCP 서버 또는 앱 커넥터 -> 실시간 외부 데이터/작업 또는 권한 있는 개인 앱/작업 공간 데이터. 개인 Google 문서, 캘린더, Slack, GitHub, Notion 및 유사한 데이터에 대해 웹 검색 또는 모델 메모리 대신 커넥터를 사용하세요.
• 자동화 -> 예약된 확인, 알림, 모니터 또는 후속 작업. 기존 스레드에서 연속성이 중요할 때 스레드 하트비트를 사용하세요.
• 훅 -> 도구 호출, 명령 또는 파일 편집 주변의 수명 주기 적용.

혼합 범위 요청은 하나의 답변을 강제하는 대신 분할하세요. 예: "항상 X를 수행하되 이 PR에만 해당"은 현재 실행에 프롬프트/스레드 컨텍스트를 기본값으로 사용하고, 지속되어야 하는 경우에만 AGENTS.md 또는 프로젝트 구성을 사용하고, 기계적 적용에만 훅을 사용하고, 예약 또는 후속 작업에만 자동화를 사용합니다.

필요할 때 이 빠른 제품 맵을 사용하세요: CLI는 터미널 우선 로컬 저장소 작업입니다. IDE 확장은 편집기 연결 코딩입니다. Codex 앱은 데스크톱 계획, 검토 및 대화형 작업입니다. 클라우드/웹은 호스팅된 병렬/오프로드 작업입니다. 브라우저 사용/앱 내 브라우저는 Codex 제어 웹 테스트입니다. Chrome 확장 프로그램은 사용자의 Chrome 프로필을 사용합니다. 컴퓨터 사용은 데스크톱 앱 및 OS UI를 제어합니다. config.toml 기본값, requirements.toml 제약 조건 및 관리/정책 정책을 분리하여 유지하세요.

경계 및 출력

• API 키 인증이 채팅GPT, 클라우드 작업 또는 커넥터 액세스를 의미하지는 않습니다. 플러그인/앱/인증 실패의 경우 번들 가용성, 플러그인 설치/활성화 상태, 커넥터/앱 권한 부여, MCP 설정, 재시작/새로고침 기대치, 작업 공간 정책 및 표면별 가용성을 확인한 후 답변하세요.
• 샌드박스 또는 네트워크 거부는 명확한 정당성과 함께 범위가 지정된 에스컬레이션이 필요합니다. 파괴적인 명령, 작업 공간 외부 쓰기 또는 광범위한 액세스 변경은 명시적 승인이 필요합니다.
• 메모리는 사용자 선호도 또는 컨텍스트를 제공할 수 있지만 명시적 프롬프트 지침이 우선하며 메모리는 현재 외부 사실의 출처가 아닙니다.
• 긍정적인 표면 선택 답변의 경우 이 형식을 사용하세요: 권장 사항, 이유, 피해야 할 사항 및 사용된 매뉴얼/출처 증거.
• 페이지별 Codex 인용이 실제로 필요한 경우 이러한 앵커가 자주 적합합니다: AGENTS.md의 경우 concepts/customization#agents-guidance, 스킬의 경우 concepts/customization#skills, 플러그인의 경우 plugins/build#plugin-structure, MCP의 경우 concepts/customization#mcp, 훅의 경우 config-advanced#hooks, 스레드 자동화의 경우 app/automations#thread-automations, 구성의 경우 config-reference#configtoml.

MCP 서버가 누락된 경우

MCP 도구가 실패하거나 OpenAI 문서 리소스를 사용할 수 없는 경우:

1. 설치 명령을 직접 실행하세요: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
2. 권한/샌드박스 문제로 실패하면 즉시 상승된 권한으로 동일한 명령을 다시 시도하고 승인에 대한 1문장 정당성을 포함하세요.
3. 상승된 시도가 실패하는 경우에만 사용자에게 설치 명령을 실행하도록 요청하세요.
4. 사용자에게 Codex를 다시 시작하도록 요청하세요.
5. 모든 것이 실패하면 web-search-tool을 사용하여 수동 설정 단계를 찾으세요.

커스텀 Model Context

사용자가 이 스킬의 동작을 재정의하려면 대신 적절한 사용자 지정 경로를 사용하세요:

• ~/.codex/config.toml 또는 .codex/config.toml: 스킬 활성화/비활성화.
• AGENTS.md: 스킬 사용 방법에 대한 지속적인 저장소 수준 지침.
• 스레드 프롬프트: 특정 세션 재정의.
• 현재 세션의 도구: 사용 가능한 경우.

이 스킬 자체는 모형 변경 또는 현재 세션의 MCP 도구를 통한 특정 문서 검색 동작을 존중합니다.

관련 문서

• OpenAI 개발자 문서
• OpenAI 문서 MCP 서버
• Codex 매뉴얼 출처