Agent Plugins 1.0 상세 설명: AI 에이전트 간 스킬과 MCP 서버를 위한 휴대용 표준

名称：인사
설명: 사용자에게 인사하고 도움을 제공합니다.

사용자에게 간단히 인사하고 어떻게 도움을 드릴 수 있을지 묻습니다.


### 4단계: 필요한 경우에만 MCP 추가

플러그인에 도구가 필요하면 다음을 추가하세요:

```Plaintext
mcp.json

플러그인이 제대로 작동하기 위해 빈 MCP를 구성하는 것은 필수가 아닙니다.

선택적 구성 요소의 위치가 누락되어도 오류로 간주되지 않습니다.

5단계: 호환 클라이언트에서 테스트

지원하려는 각 클라이언트에서 휴대용 코어를 테스트하세요.

"에이전트 플러그인 호환"이라고 해서 모든 구성 요소와 전송 방식이 구현되어 있다고 가정하지 마세요.

클라이언트는 구성 요소를 점진적으로 채택할 수 있습니다.

더 유용한 패키지는 다음과 같이 구성될 수 있습니다:

reporting-plugin/
├── plugin.json
├── skills/
│   └── weekly-report/
│       └── SKILL.md
├── mcp.json
└── bin/
└── reporting-server

매니페스트:

{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "reporting-plugin",
"version": "1.0.0",
"description": "휴대용 보고 워크플로우 및 도구."
}

MCP 구성:

{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"reporting": {
"type": "stdio",
"command": "./bin/reporting-server",
"cwd": "${PLUGIN_ROOT}"
}
}
}

표준을 준수하는 클라이언트는 다음을 발견할 수 있습니다:

플러그인 식별 정보
주간 보고 스킬
보고 MCP 서버

작성자가 각 클라이언트마다 이러한 휴대용 구성 요소를 완전히 다른 구조로 배치할 필요가 없습니다.

오류 격리가 플러그인을 더 탄력적으로 만듭니다

사양에서 신중하게 설계된 부분 중 하나는 많은 구성 요소 장애가 치명적이기보다는 국지적이라는 점입니다.

예를 들어:

유효하지 않은 스킬은 건너뛸 수 있고 다른 스킬은 계속 로드됩니다.
유효하지 않은 MCP 서버 항목 하나가 모든 서버를 비활성화하지는 않습니다.
실패한 MCP 연결이 독립적인 스킬 로드를 막지 않아야 합니다.
클라이언트는 지원하지 않는 구성 요소 유형을 무시할 수 있습니다.

이는 실제 크로스 클라이언트 생태계에서 매우 중요합니다.

하나의 플러그인이 다음을 제공할 수 있습니다:

스킬 A
스킬 B
MCP 서버 A
MCP 서버 B
클라이언트 확장

특정 클라이언트가 특정 전송 방식을 지원하지 않더라도, 가능한 경우 유용한 휴대용 구성 요소의 나머지 부분은 계속 정상 작동해야 합니다.

그렇지 않으면 상호 운용성이 취약해집니다. 지원되지 않는 선택적 기능 하나가 전체 플러그인을 비활성화할 수 있습니다.

표준을 준수하는 클라이언트는 점진적으로 표준을 채택할 수 있습니다

클라이언트는 v1의 모든 기능을 구현할 필요가 없습니다.

스킬만 지원하는 클라이언트도 매니페스트를 올바르게 로드하고 관련 스킬 동작을 구현하면 표준을 준수할 수 있습니다.

MCP를 지원하는 클라이언트는 적용 가능한 전송 규칙을 충족해야 합니다.

이러한 점진적 방식은 채택 장벽을 낮춥니다.

소규모 클라이언트는 다음부터 시작할 수 있습니다:

plugin.json
+
skills/

이후 MCP를 추가할 수 있습니다.

대규모 클라이언트는 전체 휴대용 코어와 자체 확장 네임스페이스를 구현할 수 있습니다.

이 프로젝트는 단일 공급업체가 아닌 커뮤니티가 운영합니다

AIBase의 제목은 OpenAI가 에이전트 플러그인을 도입했다고 설명합니다.

OpenAI는 분명히 중요한 참여자입니다.

공식 거버넌스 문서는 소유권 구조가 더 광범위함을 보여줍니다.

에이전트 플러그인은 스스로를

커뮤니티가 운영하고 공급업체 중립적인 프로젝트라고 소개합니다.

기술 자문 위원회는 기업 좌석이 예약된 것이 아닌 독립적인 핵심 유지관리자들로 구성됩니다.

정관은 다음을 규정합니다:

어떤 단일 공급업체도 핵심 유지관리자 좌석의 과반수를 통제할 수 없습니다.
기술 제안과 논의는 공개됩니다.
프로젝트 참여는 명시된 규칙에 따라 개방됩니다.
사양 및 문서 자료는 기본적으로 CC BY 4.0을 사용합니다.
스키마, 코드, 소프트웨어 자료는 기본적으로 Apache 2.0을 사용합니다.

프로젝트 홈페이지에 현재 나열된 초기 핵심 유지관리자 대표는 다음에서 왔습니다:

Amazon
Cursor
Microsoft
OpenAI
Vercel

이러한 다중 공급업체 구조가 중요한 이유는 경쟁 클라이언트가 참여 경로를 가질 때 상호 운용성 표준의 신뢰도가 높아지기 때문입니다.

이 표준에는 이미 여러 호환 클라이언트가 있습니다

공식 호환성 페이지에는 현재 다음이 나열되어 있습니다:

VS Code
Cursor
GitHub Copilot
ChatGPT 및 Codex
Kiro

이는 원작자만 지원하는 표준보다 훨씬 강력한 출발점입니다.

지원 매트릭스는 아직 완전히 동일하지 않습니다.

예를 들어 현재 페이지에 나열된 여러 클라이언트는 기존 SSE를 지원하는 반면, ChatGPT 및 Codex는 현재 stdio와 Streamable HTTP를 지원합니다.

중요한 결과는 패키지 형식이 이미 공급업체 경계를 넘었다는 것입니다.

플러그인 작성자는 이제 각 에이전트 환경이 완전히 분리된 생태계라고 가정할 필요 없이 하나의 공유 코어를 대상으로 할 수 있습니다.

에이전트가 장기 실행 시스템이 될수록 이것이 더 중요한 이유

에이전트가 실제 작업을 수행할 때 플러그인 파편화 문제는 더욱 두드러집니다.

간단한 챗봇은 작은 고정 도구 목록으로 작동할 수 있습니다.

진지한 에이전트는 다음이 필요할 수 있습니다:

회사별 프로세스
데이터베이스 접근
브라우저 자동화
배포 도구
보안 점검
문서 워크플로우
재사용 가능한 도메인 지침
전용 스크립트
여러 MCP 서비스

이러한 구성 요소가 기하급수적으로 늘어나면 휴대성이 인프라가 됩니다.

공유 패키징 메커니즘이 없다면 각 회사는 다음과 같은 매트릭스를 유지해야 할 위험에 처합니다:

기능 × 에이전트 클라이언트 × 버전 × 플랫폼

휴대용 패키지 형식은 이 매트릭스의 한 차원을 줄여줍니다.

클라이언트별 작업을 완전히 없애지는 못합니다.

그러나 재사용 가능한 코어의 일관성을 유지하는 데 필요한 중복 작업량을 줄일 수 있습니다.

에이전트 플러그인, MCP, 에이전트 스킬은 서로 다른 문제를 해결합니다

이 세 가지 개념은 관련이 있지만 혼동해서는 안 됩니다.

표준	주요 역할
에이전트 스킬	재사용 가능한 에이전트 지침/워크플로우 자산 정의
MCP	AI 클라이언트와 외부 도구/데이터 서버 간 통신 정의
에이전트 플러그인	스킬과 MCP 구성을 휴대 가능한 방식으로 패키징하는 방법 정의

유용한 사고 모델은 다음과 같습니다:

스킬
= 에이전트가 알아야 할 것 또는 어떻게 작동해야 하는지

MCP
= 에이전트가 외부 기능에 어떻게 연결되는지

에이전트 플러그인
= 이러한 재사용 가능한 부분이 호환 클라이언트에 맞게 어떻게 패키징되는지

따라서 에이전트 플러그인은 기존 구성 요소 표준 위에 있는 계층이지 그 대체물이 아닙니다.

에이전트 플러그인이 해결하지 않는 것

이 표준의 범위는 의도적으로 좁게 유지됩니다.

모든 크로스 에이전트 호환성 문제를 해결하지는 않습니다.

모델을 표준화하지 않습니다

무료 · We0 AI 사용하기

몇 분 만에 쇼케이스 사이트를 만들고 리드를 늘리세요

아이디어를 한 문장으로 입력하면 We0 AI가 쇼케이스 사이트, 페이지, CMS를 생성하고 출시 후 고객과 트래픽 확보를 돕습니다.

무료 등록을 위한 하나의 완전한 프로젝트 생성

하나의 완전한 생성 흐름을 시도하고 첫 번째 프로젝트 초안을 빠르게 보는 데 가장 적합합니다.

무제-1

공들여 나열한 것

채우다

반지름

생성 중

동일한 플러그인도 다른 모델에서 로드되면 동작이 다를 수 있습니다.

권한 인터페이스를 통일하지 않습니다

한 클라이언트는 작업 실행 전에 확인을 요구할 수 있고, 다른 클라이언트는 작업 영역 수준 정책을 사용할 수 있습니다.

인증을 통일하지 않습니다

OAuth 및 자격 증명 저장은 여전히 클라이언트가 관리합니다.

모든 MCP 전송 방식을 보장하지 않습니다

클라이언트는 각기 다른 하위 집합을 구현할 수 있습니다.

v1에서 훅이나 명령을 통일하지 않습니다

이러한 항목은 여전히 클라이언트가 자체적으로 정의합니다.

통합 앱 마켓을 만들지 않습니다

배포는 여전히 핵심 사양 범위 밖에 있습니다.

MCP 프로세스를 샌드박싱하지 않습니다

패키지 경로의 포함이 런타임 격리를 의미하지는 않습니다.

완전히 일관된 동작을 보장하지 않습니다

휴대성은 클라이언트가 공유 계약에 따라 구성 요소를 발견하고 로드할 수 있음을 의미합니다. 각 에이전트 런타임이 해당 구성 요소를 정확히 동일한 방식으로 추론하거나 호출한다는 의미는 아닙니다.

플러그인 작성자를 위한 보안 고려 사항

휴대용 플러그인은 배포 범위를 확대할 수 있습니다.

이로 인해 안전한 기본 구성의 중요성도 높아집니다.

기밀 정보를 포함하지 마세요

다음 위치에 자격 증명을 보관하지 마세요:

plugin.json
mcp.json 헤더
mcp.json 환경 변수 값
패키징된 파일

클라이언트가 관리하는 인증을 사용하세요.

패키지 경로를 제한적으로 유지하세요

플러그인 루트 디렉터리를 벗어나 임의의 호스트 파일에 접근하는 방식에 의존하지 마세요.

로컬 MCP 서버를 실행 코드로 취급하세요

stdio 서버는 프로세스를 시작할 수 있습니다.

사용자와 기업 관리자는 설치하는 내용을 이해해야 합니다.

필요한 권한을 최소화하세요

읽기 권한만 필요한 플러그인은 쓰기 작업을 요구해서는 안 됩니다.

외부 서비스를 문서화하세요

원격 MCP 서버에는 명확한 소유권, 개인정보 보호 및 데이터 사용 정책이 있어야 합니다.

버전 관리를 신중하게 수행하세요

디렉터리 구조가 여전히 유효하더라도 서버 동작의 변경은 호환성을 깨뜨리는 변경이 될 수 있습니다.

개발자가 지금 해야 할 일

1단계: 이식 가능한 부분과 클라이언트별 부분을 구분하세요

현재 플러그인에서 실제로 재사용할 수 있는 부분을 확인하세요:

스킬
MCP 서버
공유 메타데이터

클라이언트 전용 동작은 해당 확장 네임스페이스로 이동하세요.

2단계: 버전이 지정된 스키마를 추가하세요

plugin.json에서 Agent Plugins 1.0.0을 명시적으로 선언하세요.

3단계: 스킬 배치 위치를 표준화하세요

이식 가능한 Agent 스킬을 다음 위치에 배치하세요:

skills/<스킬 이름>/SKILL.md

4단계: MCP 구성을 표준화하세요

루트 수준 파일을 사용하세요:

mcp.json

클라이언트 고유의 구성 파일에만 의존하지 마세요.

5단계: 이식 가능한 기밀 정보를 제거하세요

자격 증명을 각 클라이언트의 인증 시스템으로 마이그레이션하세요.

6단계: 여러 클라이언트에서 패키지를 테스트하세요

상호 운용성은 실제 데모를 통해 검증해야 하며, 당연한 것으로 간주해서는 안 됩니다.

7단계: 사양 업데이트를 추적하세요

현재 사양은 여전히 작업 초안으로 표시되어 있으므로, 프로젝트 저장소, 토론, 스키마 및 호환성 페이지의 변경 사항을 주시하세요.

확인된 내용과 추가 설명이 필요한 내용

설명	상태
Agent Plugins 사양 1.0.0이 게시됨	확인됨
이 사양은 이식 가능한 스킬과 MCP 서버 패키징 방식을 정의함	확인됨
루트 `plugin.json`이 필수임	확인됨
`skills/`는 고정된 스킬 위치임	확인됨
루트 `mcp.json`이 MCP 구성 위치임	확인됨
stdio와 Streamable HTTP가 표준 MCP 전송 유형임	확인됨
레거시 SSE는 인정되지만 클라이언트에게 선택 사항임	확인됨
클라이언트별 확장은 역방향 도메인 네임스페이스를 사용함	확인됨
배포, 설치, 권한 및 사용자 경험이 표준화됨	아니요; 의도적으로 범위에서 제외됨
훅은 이식 가능한 Agent Plugins v1 구성 요소임	아니요; 클라이언트 확장이 될 수 있음
OpenAI가 Agent Plugins를 독점적으로 소유하거나 관리함	아니요
이 프로젝트는 공급업체 중립적이며 커뮤니티가 운영함	공식 거버넌스를 통해 확인됨
1.0.0 버전은 완전히 동결된 최종 표준임	아니요; 사양 페이지는 현재 작업 초안으로 표시됨
모든 호환 클라이언트가 모든 구성 요소와 MCP 전송을 지원함	아니요
ChatGPT, Codex, VS Code, Cursor, GitHub Copilot 및 Kiro가 호환 목록에 포함됨	현재 호환성 페이지에서 확인됨

자주 묻는 질문

Agent Plugins 1.0이란 무엇인가요?

Agent Plugins 1.0은 재사용 가능한 AI 에이전트 확장을 위한 개방형, 공급업체 중립적인 패키지 형식입니다. Agent Skills와 MCP 서버 구성을 이식 가능한 플러그인 디렉터리에 배치하는 방법을 표준화합니다.

Agent Plugins는 OpenAI 전용 표준인가요?

아니요. OpenAI는 프로젝트에 참여하고 ChatGPT와 Codex에서 이 형식을 지원하지만, 공식 프로젝트는 커뮤니티가 운영하며 공급업체 중립적입니다. 초기 핵심 유지관리자 팀에는 Amazon, Cursor, Microsoft, OpenAI 및 Vercel 관련 인물들이 포함되어 있습니다.

Agent Plugin에 필요한 파일은 무엇인가요?

모든 플러그인에는 루트 plugin.json이 필요합니다. 스킬은 skills/ 아래에 저장할 수 있고, MCP 서버는 루트 mcp.json에 설명할 수 있으며, 클라이언트별 기능은 네임스페이스 확장을 사용할 수 있습니다.

Agent Plugins가 MCP를 대체하나요?

아니요. MCP는 여전히 클라이언트와 MCP 서버 간에 사용되는 프로토콜을 정의합니다. Agent Plugins는 MCP 서버 구성 및 기타 재사용 가능한 에이전트 구성 요소를 패키징하는 이식 가능한 방법을 정의합니다.

훅은 Agent Plugins 1.0의 일부인가요?

이식 가능한 핵심 구성 요소로서는 아닙니다. 1버전은 Skills와 MCP 서버를 표준화합니다. 훅은 지원되는 곳에서 클라이언트별 확장 네임스페이스를 통해 구현할 수 있습니다.

어떤 클라이언트가 Agent Plugins를 지원하나요?

공식 호환성 페이지에는 현재 VS Code, Cursor, GitHub Copilot, ChatGPT 및 Codex, Kiro가 나열되어 있습니다. 지원하는 MCP 전송이 서로 다르므로 작성자는 실시간 매트릭스를 확인해야 합니다.

Agent Plugin이 모든 클라이언트에서 동일하게 동작하나요?

아니요. 이 표준은 패키지 발견과 이식 가능한 구성 요소를 다루며, 모델, 권한 인터페이스, 인증 흐름, 마켓플레이스 또는 클라이언트별 런타임 동작을 다루지 않습니다. 플러그인은 이식 가능할 수 있지만 반드시 동일한 실행 동작을 보장하지는 않습니다.

Agent Plugins 1.0이 최종 버전으로 간주되나요?

1.0.0은 표준 스키마를 제공하는 현재 게시 버전입니다. 사양 페이지는 현재 프로젝트 상태를 '작업 초안'으로 표시하므로 개발자는 공개 거버넌스 및 버전 관리 프로세스를 계속 주시해야 합니다.

요약

Agent 플러그인 1.0은 점점 확장되는 에이전트 생태계의 실질적인 문제를 해결합니다. 개발자가 동일한 스킬과 MCP 통합을 클라이언트마다 다른 방식으로 반복해서 패키징해야 하는 문제입니다.

이 사양은 작고 이식 가능한 핵심을 정의합니다. 필수 plugin.json, skills/ 디렉토리의 스킬, mcp.json의 MCP 구성, 패키지 패키징 규칙, 버전 관리 스키마, 네임스페이스가 있는 클라이언트 확장입니다. 배포, 마켓플레이스, 권한, 인증 및 사용자 인터페이스는 여전히 클라이언트가 제어합니다.

이 프로젝트는 VS Code, Cursor, GitHub Copilot, ChatGPT 및 Codex, Kiro를 포함한 여러 주요 에이전트 클라이언트의 지원을 나열합니다. 이는 OpenAI가 참여 유지자 중 하나이기는 하지만, OpenAI 고유의 플러그인 형식이 아닙니다.

버전 1.0.0은 현재 릴리스된 계약이며, 사양 페이지는 여전히 작업 초안으로 표시합니다. 개발자는 지금 바로 채택할 수 있지만 공개 거버넌스 및 버전 관리 프로세스를 추적해야 합니다.

핵심 변화는 간단합니다. 개발자는 각 플랫폼에 대해 동일한 에이전트 확장을 다시 작성할 필요 없이, 스킬과 MCP 통합을 통일된 패키지 구조를 가진 이식 가능한 구성 요소로 취급할 수 있습니다.