# Plugins 与 MCP

> 通过 agent-plugins.org 格式的便携式 plugins 和技能，以及基于 Streamable HTTP 或 SSE 的自有 MCP servers，扩展 Enterprise agents。

Enterprise 通过 **Agent Plugins** 扩展 [agents](https://pentagi.com/zh-cn/docs/glossary/#agent) 的能力——这些 [plugin](https://pentagi.com/zh-cn/docs/glossary/#plugin) 包采用开放的 [agent-plugins.org](https://agent-plugins.org/specification) 格式，包含技能、[MCP server](https://pentagi.com/zh-cn/docs/glossary/#mcp-server) 声明以及 PentAGI 特定的 [agent profiles](https://pentagi.com/zh-cn/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/zh-cn/docs/enterprise/plugins-and-mcp/#progressive-disclosure)

planner 仅能看到每个 plugin 的名称、简短描述、其技能名称以及所需的 MCP server。其所选 plugins 的技能会被纳入工作 agent 的提示词中，它们的 MCP 函数会成为 agent 的 [tool](https://pentagi.com/zh-cn/docs/glossary/#tool)——每个 [subtask](https://pentagi.com/zh-cn/docs/glossary/#subtask) 最多 20 个——而脚本和参考资料则在容器内按需读取，因此，在 plugin 被选中之前，庞大的目录几乎不会带来任何开销。

## [MCP servers](https://pentagi.com/zh-cn/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 方式进行连接。仅支持 `stdio` 的服务器需在您的网络上通过 MCP 网关运行；PentAGI 绝不会在其 [sandbox](https://pentagi.com/zh-cn/docs/glossary/#sandbox) 之外执行 plugin 提供的可执行文件。

除非 `MCP_ALLOWED_EGRESS_CIDRS` 列出了该范围，否则 PentAGI 会拒绝私有地址、环回地址、链路本地地址和元数据地址上的 MCP endpoint；因此，对于您网络上的 gateway，请设置其前缀，例如 `10.8.0.0/24`。仅对 `localhost`、环回地址和 `host.docker.internal` 接受纯 HTTP。

新服务器在 **Availability** 下切换为 **On** 之前保持关闭状态：管理员设置 **Default for users**，每位用户可以在 **My state** 下覆盖此设置。agent 通过绑定其功能的 plugin 访问服务器，或者在您启用 **Offer without a plugin** 并选择功能（**Allow direct use**）后直接访问。

凭据为只写：您在添加服务器时输入凭据，之后可以替换或撤销它们——撤销也会将服务器关闭——且 API 永远不会返回这些凭据。它们使用 `MCP_CREDENTIALS_ENCRYPTION_KEY`（64 个十六进制字符；安装程序会生成一个）进行加密。请备份该密钥：一旦存储了凭据，PentAGI 没有它就无法启动。

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

![设置中的 plugins](https://pentagi.com/images/product/ee-plugins.webp)

在 **Settings → Plugins** 中，通过 **New plugin** 或 **Import package**（`.tar.gz` 文件）添加 plugin；导入的 package 会以草稿形式存在，只有在发布后才会提供使用。放置在 `PLUGINS_DIR`（容器内的 `/opt/pentagi/plugins`）中的 packages 会在点击 **Reload registry** 后显示在 **Bundled runtime plugins** 下。

只有当 plugin 所需的 MCP server 已安装并启用时，planner 才能使用这些 plugin。管理员为每个 plugin 设置 **Default for users** — **On**、**Default** 或 **Off** — 每位用户都可以在 **My state**（针对 bundled plugins）或 **My override**（针对其他 plugin）下覆盖此设置。**Default** 遵循 `PLUGINS_ENABLEMENT_MODE`：`auto`（默认值）会提供所有 MCP server 就绪的 plugin，而 `manual` 仅在 plugin 被切换为 **On** 时才提供。