데스크톱 전용 플러그인은 사용자의 컴퓨터에서 로컬로 실행해야 합니다. 로컬 MCP 서버(stdio)를 사용하는 플러그인 대부분과 로컬 프로그램을 호출하는 플러그인이 여기에 해당합니다. OpenAI 플러그인 디렉터리에서는 이러한 플러그인에 데스크톱 전용 배지가 표시됩니다. 사용자는 ChatGPT 데스크톱 앱에서만 이러한 플러그인을 설치할 수 있으며, 로컬에서 실행되는 스레드에서만 해당 플러그인을 멘션할 수 있습니다.
승인 필요: 승인된 파트너만 로컬 MCP 서버를 사용하는 플러그인을 제출할 수 있습니다. OpenAI 담당자에게 제출 자격을 확인하고 플러그인을 제출할 조직을 허용 목록에 등록해 달라고 요청하세요. 담당자로부터 등록 확인을 받은 후 다음 단계를 진행하세요.
제출하기 전에 플러그인을 패키징한 다음, 플러그인을 설치한 적이 없는 데스크톱 환경에서 설치 과정과 주요 워크플로우를 테스트하세요. 제출 권한을 확보하고 개발자 신원 또는 사업자 정보를 인증하는 등 표준 제출 사전 요건을 충족하세요.
로컬 MCP 서버 구성하기
다른 플러그인과 동일한 플러그인 구조를 사용하세요. 루트 디렉터리의 mcp.json에서 mcpServers 아래의 HTTP 서버 항목을 로컬 서버 실행 명령어가 정의된 stdio 항목으로 바꾸세요.
stdio를 통한 MCP 통신을 지원하는 언어나 런타임이면 무엇이든 서버에 사용할 수 있습니다. 예를 들어 Node.js 서버 항목은 다음과 같이 작성할 수 있습니다.
{
"type": "stdio",
"command": "node",
"args": ["${PLUGIN_ROOT}/server/dist/index.js"],
"cwd": "${PLUGIN_ROOT}"
}서버와 해당 종속성을 패키지에 포함하세요. ${PLUGIN_ROOT}는 기본 제공 플레이스홀더입니다.
로컬 MCP 서버를 사용하는 플러그인 제출하기
- OpenAI 플랫폼 조직 설정에서 플러그인을 제출할 조직의 ID를 확인하세요.
- OpenAI 담당자에게 ID를 보내고 로컬 MCP 플러그인 제출 허용 목록에 조직을 등록해 달라고 요청하세요. 등록 확인을 받은 후 제출하세요.
- 플러그인 제출 포털을 열고 플러그인 만들기를 선택한 다음 스킬만 옵션을 선택하세요. ZIP 업로드 버튼을 사용해 로컬 MCP 구성이 포함된 플러그인 패키지를 업로드하세요.
- 제출 요건을 충족한 다음 플러그인을 제출해 검토를 요청하세요. 승인을 받으면 포털에서 게시하세요.
MCP 서버가 없는 플러그인
스킬만 포함된 플러그인을 데스크톱에서 실행해야 한다면 requires_local_executor 값을 true로 설정하세요. 이 설정은 extensions.com.openai 아래에 추가하며, 해당 항목은 루트 디렉터리의 plugin.json에 있습니다.
{
"extensions": {
"com.openai": {
"requires_local_executor": true
}
}
}.codex-plugin/plugin.json을 사용하는 레거시 패키지라면 "requires_local_executor": true를 해당 매니페스트의 최상위 수준에 추가하세요.
이 플래그를 설정하면 플러그인에 데스크톱 전용 배지가 표시됩니다. 표준 제출 플로우를 따르세요. 포털에서 해당 필드를 허용하지 않는다는 메시지가 표시되면 OpenAI 담당자에게 플러그인을 제출할 조직의 ID를 보내 제출 권한을 확인하세요.