# Plugins и MCP

> Расширяйте возможности Enterprise agents с помощью переносимых plugins и навыков в формате agent-plugins.org, а также собственных MCP servers через Streamable HTTP или SSE.

Enterprise расширяет возможности [agents](https://pentagi.com/ru/docs/glossary/#agent) с помощью **Agent Plugins** — пакетов в открытом формате [agent-plugins.org](https://agent-plugins.org/specification), содержащих навыки, объявления [MCP server](https://pentagi.com/ru/docs/glossary/#mcp-server) и специфичные для PentAGI профили.

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

## [Постепенное раскрытие информации](https://pentagi.com/ru/docs/enterprise/plugins-and-mcp/#progressive-disclosure)

Agent planner видит название каждого [plugin](https://pentagi.com/ru/docs/glossary/#plugin), краткое описание, названия его навыков и необходимые ему MCP servers. Навыки выбранных им plugins включаются в промпт рабочего agent, их MCP-функции становятся инструментами agent — не более 20 на [subtask](https://pentagi.com/ru/docs/glossary/#subtask), — а скрипты и справочные материалы считываются по требованию внутри [sandbox](https://pentagi.com/ru/docs/glossary/#sandbox), поэтому большой каталог обходится дёшево до тех пор, пока plugin не будет выбран.

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

![MCP servers в настройках](https://pentagi.com/images/product/ee-mcp-servers.webp)

MCP servers подключаются в разделе **Settings → MCP Servers** через Streamable HTTP или устаревший HTTP+SSE. MCP servers, поддерживающие только `stdio`, работают за шлюзом MCP в вашей сети; PentAGI никогда не запускает предоставляемые plugin исполняемые файлы вне своей sandbox.

PentAGI отклоняет MCP endpoints на частных, петлевых, link-local адресах и адресах метаданных, если `MCP_ALLOWED_EGRESS_CIDRS` не указывает диапазон, поэтому для шлюза в вашей сети задайте его префикс, например `10.8.0.0/24`. Plain HTTP принимается только для `localhost`, петлевых адресов и `host.docker.internal`.

Новый MCP server остаётся выключенным, пока не будет включён переключателем **On** в разделе **Availability**: администраторы задают значение **Default for users**, а каждый пользователь может переопределить его в разделе **My state**. Agents обращаются к MCP server через plugin, который связывает его функции, или напрямую, если вы включите опцию **Offer without a plugin** и выберете функции (**Allow direct use**).

Учётные данные доступны только для записи: вы вводите их при добавлении MCP server и можете заменить или отозвать их позже — отзыв также отключает сервер — и API никогда не возвращает их. Они шифруются с помощью `MCP_CREDENTIALS_ENCRYPTION_KEY` (64 шестнадцатеричных символа; установщик генерирует один). Сохраните резервную копию ключа: после сохранения учётных данных PentAGI не запускается без него.

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

![Plugins в настройках](https://pentagi.com/images/product/ee-plugins.webp)

Добавьте plugin в разделе **Settings → Plugins** с помощью кнопок **New plugin** или **Import package** (файл `.tar.gz`); импортированный пакет попадает в черновики и становится доступен только после публикации. Пакеты, помещённые в `PLUGINS_DIR` (`/opt/pentagi/plugins` внутри контейнера), появляются в списке **Bundled runtime plugins** после нажатия **Reload registry**.

Plugins становятся доступны planner только после установки и включения необходимых им MCP servers. Администраторы задают для каждого plugin значение **Default for users** — **On**, **Default** или **Off**, а каждый пользователь может переопределить его в разделе **My state** для встроенных plugins или **My override** для остальных. Значение **Default** следует `PLUGINS_ENABLEMENT_MODE`: `auto`, значение по умолчанию, предлагает каждый plugin, чьи MCP servers готовы, тогда как `manual` предлагает plugin только после того, как он будет включён (**On**).