# Plugins 및 MCP

> agent-plugins.org 형식의 포터블 plugins와 스킬, 그리고 Streamable HTTP 또는 SSE를 통한 자체 MCP servers로 Enterprise agents를 확장하세요.

Enterprise는 **Agent Plugins**를 통해 [agents](https://pentagi.com/ko/docs/glossary/#agent)의 기능을 확장합니다. 이는 개방형 [agent-plugins.org](https://agent-plugins.org/specification) 형식의 패키지로, 스킬, [MCP server](https://pentagi.com/ko/docs/glossary/#mcp-server) 선언 및 PentAGI 전용 [agent profiles](https://pentagi.com/ko/docs/glossary/#agent-profile)를 포함합니다.

```text
my-plugin/
├── plugin.json      manifest (required)
├── skills/          Agent Skills
├── mcp.json         MCP server declarations
└── com.pentagi/     requirements and agent profiles
```

## [점진적 공개](https://pentagi.com/ko/docs/enterprise/plugins-and-mcp/#progressive-disclosure)

Planner는 각 [plugin](https://pentagi.com/ko/docs/glossary/#plugin)의 이름, 간단한 설명, 스킬 이름 및 필요한 MCP 서버를 확인합니다. 선택한 plugins의 스킬은 작업 agent의 프롬프트에 포함되며, 해당 MCP 함수는 agent의 도구가 됩니다(하위 작업당 최대 20개). 스크립트와 참조 자료는 컨테이너 내부에서 필요할 때 읽혀지므로, plugin이 선택되기 전까지는 대규모 카탈로그의 비용이 거의 들지 않습니다.

## [MCP servers](https://pentagi.com/ko/docs/enterprise/plugins-and-mcp/#mcp-servers)

![설정 화면의 MCP servers](https://pentagi.com/images/product/ee-mcp-servers.webp)

MCP server는 **Settings → MCP Servers**에서 Streamable HTTP 또는 레거시 HTTP+SSE를 통해 연결됩니다. `stdio`만 지원하는 서버는 네트워크 내의 MCP gateway 뒤에서 실행됩니다. PentAGI는 [sandbox](https://pentagi.com/ko/docs/glossary/#sandbox) 외부에서 plugin이 제공하는 실행 파일을 절대 시작하지 않습니다.

PentAGI는 `MCP_ALLOWED_EGRESS_CIDRS`에 범위가 나열되지 않은 경우 사설, 루프백, 링크 로컬 및 메타데이터 주소의 MCP 엔드포인트를 거부하므로, 네트워크의 게이트웨이에 대해서는 예를 들어 `10.8.0.0/24`과 같이 해당 접두사를 설정하십시오. 일반 HTTP는 `localhost`, 루프백 주소 및 `host.docker.internal`에 대해서만 허용됩니다.

새 서버는 **Availability**에서 **On**으로 전환할 때까지 비활성 상태로 유지됩니다. 관리자는 **Default for users**를 설정하며, 각 사용자는 **My state**에서 이를 재정의할 수 있습니다. agent는 기능을 바인딩하는 plugin을 통해 서버에 접근하거나, **Offer without a plugin**을 켜고 기능을 선택(**Allow direct use**)하면 직접 접근할 수 있습니다.

자격 증명은 쓰기 전용입니다: 서버를 추가할 때 입력하며 나중에 교체하거나 폐기할 수 있습니다. 폐기하면 서버도 꺼집니다. API는 자격 증명을 절대 반환하지 않습니다. 자격 증명은 `MCP_CREDENTIALS_ENCRYPTION_KEY`(64자리 16진수 문자열; 설치 프로그램이 하나 생성함)으로 암호화됩니다. 이 키를 백업하십시오: 자격 증명이 저장되면 PentAGI는 이 키 없이는 시작되지 않습니다.

## [Plugins](https://pentagi.com/ko/docs/enterprise/plugins-and-mcp/#plugins)

![설정 화면의 plugins](https://pentagi.com/images/product/ee-plugins.webp)

**Settings → Plugins**에서 **New plugin** 또는 **Import package**(`.tar.gz` 파일)로 plugin을 추가할 수 있습니다. 가져온 패키지는 초안 상태로 도착하며, 게시해야만 사용할 수 있게 됩니다. `PLUGINS_DIR`(컨테이너 내부의 `/opt/pentagi/plugins`)에 배치된 패키지는 **Reload registry** 이후 **Bundled runtime plugins** 아래에 표시됩니다.

Plugins는 필요한 MCP servers가 설치되고 활성화된 경우에만 planners가 사용할 수 있게 됩니다. 관리자는 각 plugin의 **Default for users**를 **On**, **Default** 또는 **Off**로 설정하며, 각 사용자는 번들 plugin의 경우 **My state**에서, 그 외 plugin의 경우 **My override**에서 이를 재정의할 수 있습니다. **Default**는 `PLUGINS_ENABLEMENT_MODE`을 따릅니다: 기본값인 `auto`은 MCP servers가 준비된 모든 plugin을 제공하는 반면, `manual`은 plugin이 **On**으로 전환된 경우에만 제공합니다.