공개 노트

Agent Plugins 1.0 마이그레이션 가이드 — 스킬과 MCP를 한 패키지로

2026-08-17Views 10약 4분생성형 AI 활용

같은 배포 도구를 VS Code용, CLI용, 클라우드 에이전트용으로 따로 포장해 왔다면 가장 큰 비용은 기능 개발이 아니다. 매니페스트와 디렉터리 구조를 반복해서 맞추고, 한쪽의 보안 정책을 다른 쪽에 다시 옮기는 일이다.

2026년 8월 12일 GitHub가 Agent Plugins 1.0 지원을 정식으로 열었다. 대상은 VS Code와 Copilot CLI, Copilot SDK, Copilot 앱이다. 사양은 엿새 앞선 8월 6일에 나왔다. AWS, Anysphere, Microsoft, OpenAI, Vercel이 함께했고 Google도 이날 코어 유지관리자로 합류했다.

이 글은 발표 요약이 아니라 기존 플러그인을 옮길 때 무엇을 바꾸고 무엇을 그대로 둘지 정리한 작업 지침이다.

Before: 클라이언트마다 포장지가 달랐다

스킬이 설명하는 업무 절차와 MCP 서버가 제공하는 도구는 같아도 클라이언트마다 별도 매니페스트와 폴더 구조가 필요했다. 같은 수정이 여러 사본에 흩어졌고, 어느 사본이 최신인지 확인하는 일이 생겼다.

After: 스킬과 MCP를 하나의 설치 단위로 묶는다

Agent Plugins 1.0은 스킬과 MCP 서버 구성을 하나의 플러그인으로 패키징한다. 호환 클라이언트는 패키지에서 자신이 지원하는 요소를 발견한다. 한 번 만든 플러그인을 여러 도구에서 공유하되, 특정 클라이언트만 이해하는 기능은 별도 네임스페이스에 둔다.

기존 GitHub Copilot 플러그인도 당장 옮길 필요는 없다. 1.0 사양을 대상으로 하지 않는 기존 플러그인은 계속 지원된다고 GitHub는 설명한다.

최소 마이그레이션은 세 단계다

1단계: `plugin.json`에 스키마를 선언한다

매니페스트가 어떤 1.0 규칙을 따르는지 명시한다. 자동 완성뿐 아니라 검증과 도구 간 해석의 기준점이 된다.

2단계: 공통 자산을 표준 위치에 둔다

스킬: skills/
MCP 구성: mcp.json

여기에 들어간 내용은 호환 클라이언트가 공통으로 읽을 수 있어야 한다. 특정 앱의 명령이나 전용 동작을 섞으면 이식성이 다시 깨진다.

3단계: Copilot 전용 자산을 격리한다

사용자 정의 에이전트, 명령, 규칙, 훅처럼 Copilot에만 필요한 파일은 com.github.copilot/ 아래로 옮긴다. 다른 클라이언트는 이 폴더를 무시한다. 표준은 공통분모를 만들고, 네임스페이스는 제품별 확장을 보존한다.

파일 구조 예시

my-agent-plugin/
├─ plugin.json
├─ skills/
│  └─ deploy-check/
│     └─ SKILL.md
├─ mcp.json
└─ com.github.copilot/
   ├─ agents/
   ├─ commands/
   ├─ rules/
   └─ hooks/

눈여겨볼 것은 파일 수가 아니라 경계다. skills/와 mcp.json은 다른 클라이언트로 가져갈 공통 계약이다. com.github.copilot/은 처음부터 Copilot 안에서만 쓰기로 한 확장이다.

기업 거버넌스는 새 정책 파일을 만들지 않는다

Agent Plugins 1.0이 여러 클라이언트로 이동하면 허용 목록도 함께 움직여야 한다. GitHub는 별도의 Agent Plugins 정책 파일을 요구하지 않는다. Copilot Business와 Enterprise에서 사용하던 managed-settings.json의 설정을 그대로 적용한다.

키역할enabledPlugins특정 플러그인의 자동 설치 또는 차단extraKnownMarketplaces개발자에게 허용할 추가 마켓플레이스strictKnownMarketplaces관리된 마켓플레이스로 설치 범위 제한

기업 기본값은 기준선을 만들고, 승인된 팀별 예외와 더해진다. 플러그인에 MCP 서버 설정이 포함될 수 있으므로 URL·명령·이름 단위의 MCP 허용 목록도 함께 맞춰야 한다.

마이그레이션 검수표

공통 스킬에 특정 클라이언트 명령이 남아 있지 않은가
MCP 서버 URL과 실행 명령을 허용 목록으로 관리하는가
마켓플레이스 출처를 제한했는가
플러그인 버전과 종속성 버전을 함께 고정했는가
VS Code와 CLI에서 동일 작업을 각각 시험했는가
Copilot 전용 기능이 공통 클라이언트에서 조용히 무시되는가
설치·업데이트·철회 절차가 문서화됐는가

표준화가 끝이 아니라 시작인 이유

패키지를 옮겨 쓰기 쉬워진 만큼 사고가 번지는 범위도 넓어진다. 잘못된 MCP 명령 하나가 여러 클라이언트에 한꺼번에 퍼질 수 있다. 플러그인 사양과 조직의 허용 목록을 같은 주기로 묶어 버전 관리해야 하는 이유다.

한 번 만들고 여러 곳에서 쓸 수 있다는 말의 반대편에는, 한 번의 실수도 여러 곳에서 실행될 수 있다는 사실이 있다. Agent Plugins 1.0의 도입은 패키징 작업이면서 동시에 거버넌스 작업이다.

출처: GitHub Changelog, Agent Plugins 1.0

Agent Plugins 1.0, GitHub Copilot, MCP 서버, 에이전트 스킬, VS Code, Copilot CLI, 플러그인 표준, 개발자 도구, 엔터프라이즈 거버넌스, AI 에이전트