OpenAI 공식 문서 — Plugins 확장

38. Plugins로 기능 묶음 설치하기

플러그인은 스킬 하나가 아니라 커넥터·MCP 서버·브라우저 확장·훅·예약 작업 템플릿까지 한 번에 설치하는 묶음입니다. ChatGPT와 Codex가 같은 카탈로그를 공유합니다.

플러그인은 무엇을 묶은 것인가

공식 문서의 표현대로 플러그인은 "재사용 가능한 워크플로를 하나로 묶은 것"입니다. 스킬 하나가 아니라, 그 워크플로가 돌아가는 데 필요한 조각을 한 번에 설치합니다.

구성 요소	역할
Skills	특정 작업을 처리하는 재사용 지시문. 필요할 때 불려 나옵니다.
Connectors	GitHub·Slack·Google Drive 같은 외부 서비스에 읽기·쓰기로 연결합니다.
MCP servers	외부 시스템의 도구와 구조화된 데이터를 제공하는 백엔드입니다.
Browser extensions	해당 워크플로에 필요한 브라우저 확장 기능입니다.
Hooks	수명 주기 지점마다 실행되는 명령. 신뢰를 명시적으로 부여해야 동작합니다.
예약 작업 템플릿	반복 작업의 출발점으로 쓰는 scheduled task 틀입니다.

스킬과 무엇이 다른가

스킬은 지시문 하나이고, 플러그인은 그 스킬에 커넥터·MCP 서버·훅까지 얹은 묶음입니다. 스킬만 필요하면 @로 직접 부르면 되고, 외부 서비스 연결이나 백엔드가 함께 필요하면 플러그인 단위로 설치합니다. 스킬 자체를 만들고 관리하는 이야기는 9. Skills와 앱 내 확장 흐름에서 다룹니다.

어디서 설치하나

ChatGPT와 Codex가 같은 카탈로그를 씁니다. 들어가는 문만 다릅니다.

• ✓ChatGPT 웹 — Work 모드를 켠 다음 Plugins를 엽니다.
• ✓데스크톱 앱 — ChatGPT 또는 Codex를 고르고 Work가 켜진 상태에서 Plugins를 엽니다.
• ✓Codex CLI — /plugins 명령을 입력합니다.

설치와 호출

부르는 방법은 두 가지입니다. "Gmail 스레드 요약해 줘"처럼 하려는 일을 그대로 말하거나, @로 특정 플러그인이나 스킬을 콕 집어 부르거나입니다. 어떤 것이 동작할지 확신이 없을 때는 @로 지정하는 편이 예측 가능합니다.

제거할 때

플러그인 상세 화면에서 Uninstall plugin을 누릅니다. 워크스페이스가 배포한 플러그인은 이 항목이 보이지 않을 수 있습니다.

플러그인 직접 만들기

공식 문서가 권하는 순서는 스킬을 먼저 만들어 써 보고, 검증되면 플러그인으로 묶는 것입니다. 최소 구조는 아래와 같습니다.

plugin-name/
├── plugin.json
└── skills/
    └── skill-name/
        └── SKILL.md

루트의 plugin.json이 매니페스트입니다. 필수 항목은 다음과 같습니다.

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "plugin-name",
  "version": "1.0.0",
  "description": "무엇을 하는 플러그인인지 한 줄 설명"
}

• ✓스킬 — skills/ 아래 스킬을 자동으로 찾습니다. 각 SKILL.md 머리말에 name과 description이 있어야 합니다.
• ✓묶을 수 있는 것 — 스킬 여러 개, MCP 서버, 또는 둘 다. @plugin-creator 스캐폴드는 훅 등 추가 폴더가 있는 .codex-plugin/ 형태로 만들어 줍니다.

로컬에서 시험하기

• 1@plugin-creator에게 "기존 플러그인으로 새 마켓플레이스를 만들어 줘"라고 요청해 로컬 마켓플레이스에 추가합니다.
• 2앱을 새로고침합니다.
• 3로컬 마켓플레이스에서 설치합니다.
• 4새 대화에서 실제로 쓸 법한 요청으로 시험합니다.

배포는 ChatGPT와 Codex가 함께 쓰는 유니버설 디렉터리에 한 번 게시하면 두 제품 모두에서 검색됩니다. 워크스페이스 안에서만 나누려면 GitHub를 통한 플러그인 관리 흐름을 씁니다.

출처: Build plugins

함께 보면 좋은 문서

• ✓9. Skills — 지시문 단위 확장과 설치 경로
• ✓37. Computer use — Plugins 디렉터리에서 설치하는 대표 사례
• ✓18. Enterprise · Admin · Governance — 워크스페이스 차원의 플러그인 통제