플러그인 UI 변경 내역

ChatGPT 앱은 https://chatgpt.com/connector_platform_oauth_redirect를 고정 OAuth 콜백 URL로 사용할 수 있습니다. 이를 사용하려면 앱의 보호 리소스 메타데이터와 OAuth 메타데이터가 동일한 인가 서버를 가리키고, 해당 서버가 RFC 9207에 따른 발급자 식별을 지원해야 합니다.

클라이언트 ID 메타데이터 문서(CIMD)를 사용하는 앱은 https://chatgpt.com/oauth/client.json을 고정 클라이언트 ID로도 사용할 수 있습니다. 발급자 식별을 지원하지 않는 서버에서는 콜백이 기존 방식대로 동작합니다. 자세히 알아보기.

_meta["openai/visibility"]는 사용 중단 예정(deprecated)입니다. 값을 private으로 설정하면 모델에는 도구가 숨겨지지만 앱에 공개할지는 지정되지 않아 도구의 공개 대상이 불분명할 수 있습니다. _meta.ui.visibility를 사용해 도구를 모델에만, 앱에만 또는 양쪽 모두에 공개할지 지정하세요.

이제 ChatGPT 사용자는 연결된 앱이 항상 권한을 요청할지, 변경하기 전에 요청할지, 중요한 변경을 하기 전에만 요청할지 선택할 수 있습니다. 개인 계정에서는 모든 앱에 공통으로 적용할 설정과 앱별 설정을 지정할 수 있습니다. Business 및 Enterprise 관리자는 워크스페이스 전체의 기본값과 앱별 기본값을 관리합니다.

이제 ChatGPT는 초기화 시 hostContext.styles.variables를 통해 표준화된 MCP Apps 호스트 CSS 변수를 제공합니다. 호스트 테마가 바뀌면 ui/notifications/host-context-changed 알림을 통해 변수 값을 갱신합니다. 앱은 이 변수를 사용해 호스트별 색상을 하드코딩하지 않고도 ChatGPT의 라이트 테마와 다크 테마에 맞춰 화면을 표시할 수 있습니다.

이제 ChatGPT가 위젯을 실행할 때 window.openai.toolResponseMetadata는 숨겨진 _meta 필드를 포함한 MCP 도구 결과의 표준 메시지 구조를 그대로 유지합니다.

사용자 승인이 필요한 도구의 경우, 이제 ChatGPT는 도구 입력을 위젯의 초기 전역 변수에 미리 넣는 대신 사용자가 승인한 후 MCP Apps 수명 주기의 ui/notifications/tool-input 알림을 통해 위젯에 전달합니다.

이제 ChatGPT는 초기화 과정에서 MCP 서버가 반환하는 지침을 읽습니다. 이 지침을 도구 메타데이터와 함께 활용해 여러 도구를 연계하는 워크플로우, 제약 조건, 서버 전체에 적용되는 지침을 파악합니다.

플러그인 UI 및 MCP 서버 문서의 도구 예제에 outputSchema를 추가했습니다. 두 문서에서는 구조화된 콘텐츠를 반환하는 도구에 출력 스키마를 선언하도록 권장합니다.

승인받은 Apps SDK 통합 기능을 Codex 플러그인으로 배포할 수 있었습니다. 출시 당시에는 Codex에서만 플러그인을 사용할 수 있었습니다.

사용자의 ChatGPT 파일 라이브러리를 이용할 수 있으면 위젯에서 window.openai.selectFiles()를 호출해 라이브러리에 있는 파일을 선택할 수 있습니다.

사용자의 ChatGPT 파일 라이브러리를 이용할 수 있으면 위젯에서 window.openai.uploadFile(file, { library: true })를 호출해 업로드한 파일을 라이브러리에 저장할 수 있습니다.

window.openai.uploadFile이 이제 이미지 외의 파일 형식도 지원합니다.

이제 ChatGPT는 MCP Apps 사양과 완전히 호환됩니다.

window.openai.openExternal({ href, redirectUrl })는 redirectUrl: false 설정을 지원합니다. 이 설정을 사용하면 호스트가 외부 링크 끝에 ?redirectUrl=...를 추가하지 않습니다.

window.openai.setOpenInAppUrl({ href })를 호출하면 전체 화면에서 “에서 열기”를 선택할 때 열리는 URL을 변경할 수 있습니다. 이 메서드를 호출하지 않으면 ChatGPT는 기존처럼 위젯의 현재 iframe 경로를 엽니다.

openai/widgetDescription 값이 있으면 리소스를 생성할 때 resource.description보다 이 값을 우선 적용합니다.

window.openai.sendFollowUpMessage는 scrollToBottom 매개변수를 지원합니다. 기본값은 true이며, false를 전달하면 맨 아래로 자동 스크롤하지 않습니다.

ChatGPT의 회사 지식 기능과 호환되도록 search와 fetch 도구를 구현하는 방법을 가이드에 추가했습니다. 자세히 알아보기.

이제 도구 호출에 _meta["openai/session"]이 포함됩니다. 이 익명화된 대화 ID를 사용하면 같은 ChatGPT 세션에 속한 요청을 서로 연결할 수 있습니다.

이제 window.openai.requestModal({ template })를 호출할 때 registerResource의 템플릿 URI를 전달하면 등록된 다른 UI 템플릿을 열 수 있습니다.

플러그인 UI에서 상태를 유지하는 방법에 대한 가이드를 공개했습니다.

모든 코드 스니펫에 복사 기능을 추가했습니다.

개발자용 통합 변경 로그를 공개했습니다.