Plugins 및 MCP

Enterprise는 Agent Plugins를 통해 agents의 기능을 확장합니다. 이는 개방형 agent-plugins.org 형식의 패키지로, 스킬, MCP server 선언 및 PentAGI 전용 agent profiles를 포함합니다.

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

점진적 공개

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

MCP servers

MCP server는 Settings → MCP Servers에서 Streamable HTTP 또는 레거시 HTTP+SSE를 통해 연결됩니다. stdio만 지원하는 서버는 네트워크 내의 MCP gateway 뒤에서 실행됩니다. PentAGI는 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

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으로 전환된 경우에만 제공합니다.