Agent Plugins는 AI 에이전트를 확장하는 재사용 컴포넌트를 이식 가능한 플러그인 패키지로 묶기 위한 벤더 중립 표준이다. 1.0.0 명세는 Agent Skills와 MCP 서버를 한 디렉터리 구조 안에 담고, 호환 클라이언트가 이를 일관되게 발견·검증·로드할 수 있게 하는 최소 공통 포맷을 정의한다.
왜 필요한가
AI 에이전트 클라이언트마다 플러그인 구조가 다르면 같은 기능을 여러 번 다시 포장해야 한다. 예를 들어 “문서를 요약하는 스킬 + 사내 API에 접근하는 MCP 서버”라는 조합은 Claude, Codex, Cursor, 사내 에이전트 런타임에서 모두 쓸 수 있지만, 배포 형식이 다르면 작성자는 각 제품별로 폴더와 manifest를 다시 맞춰야 한다.
Agent Plugins는 이 문제를 “모든 기능의 단일 표준화”가 아니라 “이식 가능한 핵심부의 표준화”로 푼다. 설치 UI, 권한 승인, 마켓플레이스, 클라이언트 고유 훅은 각 제품이 유지하되, 공통으로 옮길 수 있는 Skills와 MCP 서버 선언은 같은 구조를 쓰게 한다.
패키지 구조
기본 구조는 작다.
my-plugin/
├── plugin.json
├── skills/
│ └── summarize/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
└── hooks/| 구성 | 역할 |
|---|---|
plugin.json | 플러그인 식별자와 Agent Plugins 명세 버전을 선언 |
skills/ | Agent Skills 명세를 따르는 절차 지식, 스크립트, 참고 자료 |
mcp.json | stdio, Streamable HTTP, legacy HTTP+SSE MCP 서버 선언 |
| reverse-domain namespace | 특정 클라이언트 전용 확장 지점 |
핵심은 skills/와 mcp.json이 한 배포 단위에 공존한다는 점이다. MCP가 도구와 데이터 접근을 제공하고 Skills가 그 도구를 언제, 어떻게 써야 하는지 설명하면, 플러그인은 단순 API 래퍼보다 실행 가능한 작업 단위에 가까워진다.
MCP, Skills, Agent Plugins의 관계
| 계층 | 표준화 대상 | 예시 |
|---|---|---|
| mcp | 에이전트가 외부 도구·데이터를 호출하는 프로토콜 | GitHub 이슈 생성, DB 조회, 브라우저 제어 |
| agent-skills</td><td>Agent Skills | 에이전트가 특정 작업을 수행하는 절차와 참고 자료 | 보안 리뷰 절차, 문서 변환 워크플로 |
| Agent Plugins | Skills와 MCP 서버를 함께 배포하는 패키지 형식 | “Sentry 진단 플러그인”, “사내 문서 QA 플러그인” |
따라서 Agent Plugins는 MCP를 대체하지 않는다. MCP 서버, Skills, 클라이언트별 확장을 한 폴더에 넣어 배포·발견·호환성 확인을 쉽게 만드는 상위 패키징 레이어다.
클라이언트 구현자가 봐야 할 점
Agent Plugins를 로드하는 클라이언트는 manifest validation만으로 끝나지 않는다. 실제 제품에서는 다음 결정을 별도로 내려야 한다.
- 플러그인 설치 시 사용자에게 어떤 권한을 보여줄지
mcp.json에 선언된 서버를 어떤 샌드박스와 자격증명 경계에서 실행할지- Skills가 참조하는 스크립트와 자료를 컨텍스트에 언제 로드할지
- 클라이언트 전용 확장을 어디까지 허용할지
- 플러그인 업데이트와 서명 검증을 어떻게 처리할지
표준이 의도적으로 작은 이유도 여기에 있다. 런타임 보안과 사용자 경험은 클라이언트마다 달라질 수밖에 없고, Agent Plugins는 그 위에 공통 패키지 바닥만 깐다.
누가 쓰면 좋은가
- 도구 제작자: 같은 MCP 서버와 Skills를 여러 에이전트 제품에 배포해야 할 때
- 엔터프라이즈 플랫폼 팀: 사내 표준 에이전트 확장을 하나의 패키지로 관리하고 싶을 때
- 에이전트 클라이언트 개발자: 외부 확장 생태계를 받되, 제품별 권한·설치·UI 정책은 유지하고 싶을 때
- 오픈소스 커뮤니티: 특정 벤더 플러그인 포맷에 갇히지 않는 재사용 가능한 에이전트 확장을 만들 때
거버넌스와 생태계
Agent Plugins는 공개 저장소에서 명세, JSON Schema, 거버넌스, 기여 절차를 관리한다. 초기 Technical Steering Committee에는 Amazon, Cursor, Microsoft, OpenAI, Vercel의 core maintainer가 포함되어 있다. 새 기능 제안은 GitHub Discussions에서 이식성 필요와 구현자 지지를 확인하는 방식으로 논의된다.
관련 문서
- mcp — 에이전트와 외부 시스템을 연결하는 표준 프로토콜
- agent-skills — 에이전트에게 절차적 작업 지식을 제공하는 Skills 시스템
- mcp-tips-vs-agent-skills — MCP와 에이전트 스킬의 역할 차이
- llm-agent-communication-protocols — A2A·MCP 이후의 에이전트 통신 프로토콜 분류
- agentic-resource-discovery — 에이전트 리소스 발견 명세
참고 자료
- Agent Plugins — Agent Plugins 공식 사이트 (2026-08-07 확인)