For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색

플러그인 빌드

ChatGPT와 Codex에서 재사용할 수 있는 기능을 만들고 테스트하세요

플러그인을 빌드하거나 제출하려면 developers.openai.com의 전체 개발 문서를 참조하세요.

이 페이지에서는 플러그인을 간략히 소개합니다. 플러그인은 설치 가능한 패키지로, 스킬이나 MCP 서버 또는 둘 다를 포함할 수 있습니다. MCP 서버는 선택적으로 UI를 반환할 수도 있습니다.

ChatGPT와 Codex는 하나의 통합 플러그인 디렉터리를 공유합니다. 공개 플러그인을 한 번 게시하면 두 제품의 지원되는 화면에서 동일한 등록 항목을 찾을 수 있습니다. 개발 중에는 통합 디렉터리에 제출하기 전에 로컬 마켓플레이스에서 패키지를 테스트하세요.

GitHub를 통해 워크스페이스에 배포하는 방법은 플러그인 관리를 참조하세요.

개인 워크플로우 하나를 계속 다듬는 중이라면 스킬부터 시작하세요. 해당 워크플로우를 공유하거나 관련 스킬을 패키지로 묶거나, 외부 서비스에 연결하거나 안정적인 기능을 팀에 배포하려면 플러그인을 빌드하세요.

@plugin-creator로 플러그인 만들기

가장 빠르게 설정하려면 ChatGPT Work 모드에서 기본 제공 @plugin-creator 스킬을 사용하거나 Codex에서 $plugin-creator를 사용하세요.

원하는 결과, 포함할 스킬이나 MCP 서버, 테스트용 로컬 마켓플레이스 등록 항목이 필요한지를 설명하세요. 예를 들면 다음과 같습니다:

@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.

이 스킬은 지원되는 .codex-plugin/plugin.json 호환성 매니페스트를 만들고 플러그인 폴더를 정리하며, 플러그인을 로컬 마켓플레이스에 추가할 수도 있습니다. 이렇게 생성된 기본 구조는 수동 생성 예제에서 사용하는 이식 가능한 루트 plugin.json 형식과 다릅니다. 선택적으로 추가할 수 있는 파일과 디렉터리는 기본 구조를 참조하세요.

완료되면 다음을 진행하세요:

  1. .codex-plugin/plugin.json을 검토하세요.
  2. skills/ 아래에 포함된 각 스킬을 확인하세요.
  3. ChatGPT나 Codex를 새로고침하고 해당 로컬 마켓플레이스 소스에서 플러그인을 설치하세요.
  4. 새 대화에서 대표적인 요청으로 플러그인을 테스트하세요.

플러그인에 MCP 서버가 포함되어 있다면 먼저 서버를 빌드하고 테스트한 다음, @plugin-creator에 등록된 연결 정보를 제공하세요. 도구, 인증, 배포, 테스트에 관한 전체 절차는 MCP 서버 워크플로우를 따르세요.

스킬만 포함된 플러그인 수동으로 만들기

이식 가능한 Agent Plugins 패키지의 최소 구성은 루트 매니페스트와 하나 이상의 스킬입니다:

meeting-follow-up/
├── plugin.json
└── skills/
    └── meeting-follow-up/
        └── SKILL.md

플러그인 루트에 plugin.json을 만드세요:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps"
}

이식 가능한 패키지는 skills/의 스킬을 자동으로 찾습니다. skills/meeting-follow-up/SKILL.md를 추가하세요:

---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---

Review the meeting notes. Return:

1. Decisions
2. Action items with owners
3. Open questions

플러그인 이름은 케밥 케이스로 정하고 일관되게 유지하세요. ChatGPT와 Codex가 워크플로우를 언제 적용해야 하는지 판단할 수 있도록 스킬 설명을 구체적으로 작성하세요.

@plugin-creator로 폴더를 로컬 마켓플레이스에 추가한 다음, 공유하기 전에 플러그인을 설치하고 테스트하세요.

개발 문서에서 계속 알아보기

전체 개발 안내는 플러그인 문서를 참조하세요. 다음 내용을 다룹니다:

플러그인을 탐색, 설치, 활성화 또는 제거하는 방법은 플러그인 사용을 참조하세요.