챗GPT 플러그인이란? 만드는 법과 배포·심사 주의사항

챗GPT 플러그인은 스킬(작업 순서 설명서)과 MCP 서버(외부 서비스 연결)를 한 묶음으로 포장해 ChatGPT와 Codex에 설치하는 확장이다. 폴더에 plugin.json과 skills/이름/SKILL.md 두 파일만 있어도 시작할 수 있고, 팀에 나누려면 워크스페이스 게시, 모두에게 열려면 심사를 거쳐 공용 디렉토리에 올린다(2026년 9월 30일 기준). 2024년 4월에 종료된 옛 플러그인과는 이름만 같은 다른 물건이다.

이 글은 플러그인이 무엇으로 이루어졌는지, 만드는 순서, 배포하는 세 가지 길, 심사에서 걸리는 항목을 정리한다. 근거는 OpenAI 개발자 문서의 플러그인 개념, 패키징, 스킬, 제출, 가이드라인 다섯 페이지이며 맥피가 2026년 9월 30일에 원문을 직접 읽고 확인했다. 문서는 이 날짜 기준이고 제출 화면과 규칙은 바뀔 수 있다. 9월 29일 DevDay에서 플러그인 확장이 언급되어 검색이 늘었지만, 아래 절차는 발표 이전부터 문서에 있던 내용이다.

세 줄로 먼저 읽기

• 정체: 플러그인은 스킬, MCP 서버, 선택 화면(UI)을 담은 설치 단위다. ChatGPT와 Codex가 하나의 공용 디렉토리를 함께 쓴다.
• 만들기: 이식형 plugin.json 하나와 스킬 폴더로 시작한다. 가장 빠른 길은 ChatGPT의 @plugin-creator 스킬이다.
• 배포: 내 저장소에서 시험하고, 관리자가 워크스페이스에 게시하고, 공개하려면 ZIP을 올려 심사를 통과한다. 공개 제출은 MCP 서버를 첫 ZIP에 넣어야 한다.

챗GPT 플러그인은 무엇이고 옛 플러그인과 어떻게 다른가

OpenAI 문서는 플러그인을 ChatGPT와 Codex에서 사람들이 찾고, 설치하고, 공유하고, 게시하는 패키지로 정의한다. 스킬은 반복 작업의 순서와 성공 기준을 적은 SKILL.md 폴더이고, MCP 서버는 외부 서비스에 붙어 모델이 부를 수 있는 도구를 내주는 프로그램이다. MCP는 AI가 외부 도구와 데이터에 접근하는 공개 규격이다.

검색하는 사람 중 상당수는 2023년의 플러그인을 떠올린다. 그 플러그인은 2024년 3월 19일부터 새 설치가 막혔고 4월 9일에 대화가 끝났다. OpenAI가 GPTs로 대체한다고 밝힌 내용은 OpenAI 커뮤니티의 플러그인 종료 안내와 Zapier의 플러그인 종료 공지에서 확인할 수 있다. 지금의 플러그인은 그 구조를 잇는 것이 아니라 스킬과 MCP 서버를 묶은 새 패키지다. 이 문서 기준으로 ChatGPT와 Codex는 공용 디렉토리 하나를 함께 쓴다.

구분	옛 플러그인(2023~2024년 4월)	지금의 플러그인(2026년 9월 문서)
상태	2024년 4월 9일 대화 종료	공용 디렉토리 운영
구성	API 명세로 연결	스킬, MCP 서버, 선택 UI
쓰는 곳	ChatGPT	ChatGPT와 Codex

GPTs와 지금 플러그인의 세부 차이를 OpenAI가 한 표로 비교한 문서는 확인하지 못해 표에 넣지 않았다.

플러그인은 어떤 부품으로 이루어져 있나

공식 개념 문서는 플러그인의 모양을 네 가지로 나눈다. 스킬만 넣거나, MCP 서버만 넣거나, 둘 다 넣거나, 서버에 화면(UI)까지 붙인다. 화면은 필수가 아니다. 문서는 사람이 결과를 비교하고 수정하고 확인해야 할 때만 붙이라고 한다. 상품 비교표나 일정 편집이 예다. 단순한 상태 조회에는 필요 없다.

스킬과 MCP 서버를 고르는 기준은 이렇다. 도구를 부르는 순서, 판단 기준, 출력 형식, 예시가 필요하면 스킬이다. 실시간 데이터, 로그인, 권한 제어, 안전하게 통제된 작업이 필요하면 MCP 서버다. 가상의 예를 들면, 광고 리포트 양식을 매주 똑같이 채우게 하는 일은 스킬만으로 되고, 광고 계정의 실제 성과 숫자를 읽어 오려면 MCP 서버가 필요하다. 맥피가 만든 가정이며 OpenAI 문서의 사례가 아니다.

닷츠(상시 에이전트)도 플러그인으로 앱 4,000여 개에 연결한다. 닷츠의 대상 요금제와 안전장치는 챗GPT 닷츠 사용 조건 글에 정리해 두었다.

플러그인은 어떻게 만드나: 5단계

공식 패키징 문서의 순서를 가장 작은 예로 줄이면 다음과 같다.

1단계, 폴더를 만들고 루트에 이식형 매니페스트 plugin.json을 둔다. 이름은 소문자 하이픈(kebab-case)으로 짓는다. 호스트가 이 이름을 플러그인 식별자로 쓰기 때문이다.

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "my-first-plugin",
  "version": "1.0.0",
  "description": "Reusable greeting workflow"
}

2단계, 스킬을 skills/hello/SKILL.md에 쓴다. 이식형 패키지는 루트의 skills/ 폴더를 자동으로 찾기 때문에 매니페스트에 스킬 경로를 따로 적지 않는다. 맨 위 name과 description은 필수이고, 모델이 이 스킬을 언제 켤지 description을 보고 정한다. 그래서 사용자의 목표를 구체적으로 쓴다.

---
name: hello
description: Greet the user with a friendly message.
---

3단계, 외부 서비스가 필요하면 mcp.json에 서버를 적는다. 이식형 형식은 서버마다 통신 방식 type을 적어야 한다. 예시 문서는 "type": "streamable-http"와 서버 주소를 쓴다. 스캐폴딩이 만든 .mcp.json의 이름만 바꿔서는 안 된다는 경고가 문서에 있다.

4단계, 로컬에서 시험할 마켓플레이스에 올린다. 저장소용은 $REPO_ROOT/.agents/plugins/marketplace.json, 개인용은 ~/.agents/plugins/marketplace.json이다. 여기에 source.path로 플러그인 폴더를 가리키고 installation을 AVAILABLE로 둔다.

5단계, ChatGPT 데스크톱 앱을 다시 켠 뒤 플러그인 디렉토리에서 그 마켓플레이스를 골라 플러그인이 보이는지 확인한다. 보이면 설치해서 실제 대화로 스킬이 켜지는지 시험한다.

손으로 만들기 싫으면 @plugin-creator가 빠르다. ChatGPT의 Work 모드에서 @plugin-creator를, Codex에서는 $plugin-creator를 쓴다. 다만 이 스킬은 이식형이 아니라 .codex-plugin/plugin.json 호환 구조를 만든다. 문서는 이 구조도 계속 지원한다고 밝힌다. 포장 방식을 나중에 바꿀 계획이면 처음부터 손으로 이식형을 만드는 편이 낫다.

MCP 서버를 이미 갖고 있다면 ChatGPT 설정의 보안 및 로그인에서 개발자 모드를 켜고, chatgpt.com/plugins에서 더하기 버튼으로 서버 주소를 등록한다. 연결이 만들어지면 브라우저 주소에 plugin_asdk_app으로 시작하는 ID가 보인다. 이 ID를 @plugin-creator에 넘기면 서버 연결이 들어간 플러그인이 만들어진다.

시험하고 배포하는 세 가지 길

첫째, 저장소나 개인 마켓플레이스다. 팀 저장소에 marketplace.json을 두고 codex plugin marketplace add owner/repo 명령으로 추가한다. 시험과 팀 내부 배포에 맞다.

둘째, 워크스페이스 게시다. 워크스페이스 관리자만 할 수 있다. chatgpt.com/plugins의 Personal에서 플러그인의 점 세 개 메뉴를 열어 Publish를 누르고, 접근할 역할을 정한다. 이렇게 게시한 플러그인은 그 조직 안에서만 보이고 공개 디렉토리에는 올라가지 않는다. 관리자는 features.plugin_sharing = false로 이 게시를 막을 수도 있다.

셋째, 공개 디렉토리다. platform.openai.com/plugins에서 ZIP을 올리고, 자동 점검 결과를 고치고, 심사를 요청한다. 승인 뒤 게시 시점은 개발자가 고른다. 게시 후 MCP 서버 변경은 OpenAI가 매일 스캔해서 점검을 통과한 것만 반영하므로 ZIP을 다시 올리지 않아도 된다. 반대로 메타데이터, 스킬, MCP 서버 설정을 바꾸려면 새 ZIP이 필요하다.

공개 심사에서 준비할 것

• 신원: 개인 또는 사업자 인증을 마친 조직이어야 하고, 제출은 조직 소유자나 Apps Management Write 권한자가 한다.
• 서버 연결: 플러그인당 연결할 수 있는 MCP 서버는 하나다. 도메인 소유는 /.well-known/openai-apps-challenge 주소에 토큰을 텍스트로 올려 증명한다.
• 시험 자료: 긍정 사례 5개, 부정 사례 3개(플러그인이 하지 말아야 할 요청), 동작 영상 주소, 릴리스 노트, 로그인이 필요하면 심사용 테스트 계정이다. MFA나 문자 인증이 필요한 계정은 안 된다.
• 이름과 설명: 회사나 제품 이름 뒤에 MCP나 Plugin을 붙이지 않는다. 가격, 무료 체험, 할인 문구는 설명에 쓰지 못한다.
• 대상: 13~17세도 쓸 수 있는 일반 이용자 수준이어야 한다. 13세 미만을 겨냥할 수 없다.
• 독자성: ChatGPT 기본 기능으로 이미 되는 일을 그대로 반복하는 플러그인은 취지에 맞지 않는다고 가이드라인이 밝힌다.

맥피는 공개 제출을 생각한다면 첫 ZIP부터 MCP 서버를 넣는 쪽으로 본다. 문서에 이미 올라간 스킬 전용 플러그인에 MCP 서버를 나중에 추가하는 것은 현재 지원되지 않는다고 나오기 때문이다. 내부용이라면 스킬만으로 시작해도 된다.

DevDay 발표 게시물에는 플러그인 확장이 사이드바 항목, 대화형 패널, 파일 뷰어를 지원한다는 대목이 있다. 이 글은 그 세부 절차와 제공 시점을 확인하지 못해 만드는 순서에 넣지 않았다. 발표 전체는 DevDay 2026 발표 정리에 있다.

한국에서 확인할 것

• 설치 가능 여부: 개발자 문서는 요금제별 제공 범위를 밝히지 않는다. 플러그인마다 요금제, 워크스페이스, 역할, 지역에 따라 설치 여부가 다를 수 있으니 내 계정에서 설치 버튼이 뜨는지 직접 본다. 제공 범위는 OpenAI 도움말의 Plugins in ChatGPT and Codex에서 확인한다.
• 국가별 제공: 공개 제출 메타데이터에는 국가별 제공 범위와 번역을 함께 적는 항목이 있다. 한국 이용자를 겨냥하면 한국어 설명과 제공 국가에 한국이 들어 있는지 확인한다.
• 개인정보: 플러그인이 광고 계정이나 고객 데이터를 읽는 MCP 서버라면 서버 운영자가 그 데이터의 처리 주체가 된다. 한국 개인정보 위탁 요건은 OpenAI 문서가 다루지 않은 영역이라 법무나 담당자에게 따로 확인한다.
• 요금: 플러그인 제작과 게시에 별도 요금이 있다는 언급은 문서에서 찾지 못했다. 다만 ChatGPT 요금제별 한도는 계속 바뀌므로 챗GPT 요금제 한도 글을 함께 본다.

자주 하는 실수

가장 흔한 것은 2023년 자료를 따라가는 것이다. OpenAPI 명세와 ai-plugin.json으로 만드는 튜토리얼은 옛 플러그인용이라 지금 쓸 수 없다. 둘째, .mcp.json을 mcp.json으로 이름만 바꾸고 type을 빼먹는 것이다. 이식형 형식은 통신 방식을 서버마다 적어야 한다. 셋째, 스킬의 description을 성의 없이 쓰는 것이다. 모델이 스킬을 켤지 이 문장으로 정하므로 "도움 주기" 같은 문장으로는 잘 켜지지 않는다. 넷째, 워크스페이스에 게시했으니 공개된 줄 아는 것이다. 두 경로는 별개다. 다섯째, 비밀키나 계정 정보를 ZIP에 넣는 것이다. 문서가 명시적으로 금지한다. 여섯째, 다른 플러그인보다 먼저 고르라고 모델에게 지시하는 문구를 설명에 넣는 것이다. 가이드라인의 공정 경쟁 조항에 걸린다.

오늘 해 볼 순서

1. chatgpt.com/plugins를 열어 내 계정에서 디렉토리와 설치 버튼이 보이는지 확인한다.
2. 내 반복 업무 하나를 골라 스킬 하나로 적어 본다. 입력, 순서, 출력 형식을 SKILL.md에 쓴다.
3. @plugin-creator나 위 5단계로 로컬 마켓플레이스에 올려 설치하고, 실제 대화로 스킬이 켜지는지 세 번 시험한다.
4. 외부 데이터가 꼭 필요할 때만 MCP 서버를 붙이고, 공개 제출 계획이면 플러그인 가이드라인을 먼저 읽는다.

문서는 자주 바뀌므로 제출 직전에 개발자 문서의 제출 페이지를 한 번 더 연다.

근거 자료

• OpenAI 개발자 문서, Plugin architecture
• OpenAI 개발자 문서, Package your plugin
• OpenAI 개발자 문서, Build skills
• OpenAI 개발자 문서, Upload and submit your plugin
• OpenAI 개발자 문서, Plugin guidelines
• OpenAI 개발자 커뮤니티, DevDay 2026 발표와 개발자 자료 (2026년 9월 29일)
• OpenAI 도움말, Plugins in ChatGPT and Codex
• OpenAI 커뮤니티, Plugins are no longer supported (옛 플러그인 종료)
• Zapier, Sunsetting the Zapier ChatGPT plugin