# 플러그 인 및 마켓플레이스 참조

공유 플러그인 및 마켓플레이스 용어, 파일 형식 및 제품별 설명서에 대한 링크를 찾습니다.

플러그 인은 호환되는 Copilot 표면용 사용자 지정을 패키지화합니다. 플러그인 형식, 구성 요소 및 지원되는 위치는 화면에 따라 다릅니다. 플러그인을 설치하려는 환경에 대한 설명서를 사용합니다.

## 플러그인 매니페스트

플러그인은 `plugin.json` 매니페스트에 의해 설명됩니다. Agent Plugins는 호환되는 환경을 위한 이식 가능한 플러그 인 형식을 정의합니다. 매니페스트는 플러그 인 디렉터리의 루트에 있으며 에이전트 플러그 인 스키마를 선언합니다. 에이전트 플러그인 1.0의 경우 `https://agent-plugins.org/schemas/1.0.0/plugin.schema.json`을 사용하세요.
Copilot CLI 는 1.1.0 스키마도 인식합니다.

공유 에이전트 플러그 인 형식은 일부 구성 요소의 표준 위치를 정의합니다. 이러한 구성 요소에 대한 지원은 서피스마다 다를 수 있습니다.

| Component                             | 에이전트 플러그인 위치                           | Notes                             |
| ------------------------------------- | -------------------------------------- | --------------------------------- |
| 기술                                    | `skills/NAME/SKILL.md`                 | 호환되는 인터페이스는 이 위치에서 기능을 찾을 수 있습니다. |
| MCP 서버                                |                                        |                                   |
| `mcp.json` 플러그인 루트에                   | 호환되는 환경은 이 위치에서 MCP 서버 구성을 검색할 수 있습니다. |                                   |
| 표면별 구성 요소                             |                                        |                                   |
| `com.github.copilot/`와 같은 네임스페이스 디렉터리 | 가용성 및 지원되는 구성 요소는 플랫폼에 따라 달라집니다.       |                                   |

에이전트 플러그 인 1.0 디렉터리에서는 다음 구조를 사용할 수 있습니다.

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

매니페스트는 `plugin.json` 에이전트 플러그 인 스키마를 선언합니다.
`mcp.json` 위치 및 루트 `skills/` 위치는 에이전트 플러그인에 의해 정의됩니다. 디렉터리에는 `com.github.copilot/` 이식 가능한 에이전트 플러그 인 구성 요소가 아닌 Copilot 관련 구성 요소가 포함되어 있습니다. 표면이 이 디렉터리에서 로드하는 구성 요소는 표면에 따라 다릅니다. 자세한 내용은 Copilot CLI[GitHub Copilot CLI 플러그 인 참조](/ko/copilot/reference/copilot-cli-reference/cli-plugin-reference#components)을 참조하세요.

Copilot CLI 는 레거시 Copilot 플러그 인 형식도 지원합니다. 서로 다른 구성 요소 검색 동작과 구성 가능한 구성 요소 경로를 가집니다. 매니페스트 필드, 유효성 검사, 파일 위치 및 CLI 관련 동작은 [GitHub Copilot CLI 플러그 인 참조](/ko/copilot/reference/copilot-cli-reference/cli-plugin-reference)을 참조하세요.

[에이전트 플러그인 작성 참조](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference)에서 Visual Studio Code의 플러그인 작성 형식 및 지원되는 동작을 문서화합니다. 한 화면에서 지원되는 구성 요소 또는 매니페스트 동작이 다른 화면에서 지원된다고 가정하지 마세요.

## Marketplace 카탈로그

카탈로그는 `marketplace.json` 마켓플레이스에 대한 메타데이터를 제공하고 최상위 `plugins` 배열의 플러그 인을 나열합니다. 각 플러그인 항목에는 이름, 설명, 버전 및 출처가 포함될 수 있습니다. 소스는 플러그 인 파일이 있는 위치를 식별합니다.
`marketplace.json`의 경우 Copilot CLI 구성 요소만이 유일한 필수 마켓플레이스 구성 요소입니다. 다른 표면에는 추가 요구 사항이 있을 수 있습니다.

마켓플레이스 이름은 리포지토리 이름이 아니라 `name` 필드에서 가져옵니다. 플러그인 식별자는 플러그인 이름과 마켓플레이스 이름을 결합한 것입니다.

```text
PLUGIN-NAME@MARKETPLACE-NAME
```

설정에서 이를 참조할 때 마켓플레이스 및 플러그인 이름을 안정적으로 유지합니다. 마켓플레이스 이름을 변경하면 해당 설정에서 사용하는 플러그 인 식별자가 변경됩니다.

카탈로그 필드 및 지원되는 파일 위치는 플랫폼에 따라 달라질 수 있습니다.
Copilot CLI의 전체 마켓플레이스 카탈로그 필드 및 위치는 [GitHub Copilot CLI 플러그 인 참조](/ko/copilot/reference/copilot-cli-reference/cli-plugin-reference#marketplacejson)을 참조하세요. 리포지토리에 카탈로그를 GitHub 게시하는 단계는 [GitHub 플러그 인 마켓플레이스 만들기 및 공유](/ko/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces)을 참조하세요.

## 플러그인 사용

마켓플레이스를 추가하면 플러그 인을 찾아볼 수 있습니다. 플러그인을 설치하면 작업 영역에 추가됩니다. 플러그 인을 사용하도록 설정하면 해당 표면의 세션에서 해당 구성 요소를 사용할 수 있습니다. 표면별 지침은 다음을 참조하세요.

* [Visual Studio Code에서 플러그인 사용](/ko/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)
* [에 대한 플러그 인 찾기 및 설치 GitHub Copilot CLI](/ko/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [GitHub Copilot 앱 사용자 지정](/ko/copilot/how-tos/github-copilot-app/customize-github-copilot-app)
* [클라우드에서 GitHub Copilot에 대한 설정 구성](/ko/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings)