# Plugins e MCP

> Estenda os agents do Enterprise com plugins e habilidades portáteis no formato agent-plugins.org e com seus próprios MCP servers via Streamable HTTP ou SSE.

A edição Enterprise estende o que os [agents](https://pentagi.com/pt-br/docs/glossary/#agent) podem fazer por meio de **Agent Plugins** — pacotes no formato aberto [agent-plugins.org](https://agent-plugins.org/specification) com skills, declarações de [MCP server](https://pentagi.com/pt-br/docs/glossary/#mcp-server) e perfis específicos do PentAGI.

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

## [Revelação progressiva](https://pentagi.com/pt-br/docs/enterprise/plugins-and-mcp/#progressive-disclosure)

Um planner vê o nome de cada [plugin](https://pentagi.com/pt-br/docs/glossary/#plugin), uma breve descrição, os nomes das skills e os MCP servers necessários. As skills dos plugins selecionados entram no prompt do agent em execução, suas funções MCP tornam-se as [tools](https://pentagi.com/pt-br/docs/glossary/#tool) do agent — no máximo 20 por [subtask](https://pentagi.com/pt-br/docs/glossary/#subtask) — e scripts e referências são lidos sob demanda dentro da [sandbox](https://pentagi.com/pt-br/docs/glossary/#sandbox), portanto um catálogo grande tem custo baixo até que um plugin seja selecionado.

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

![MCP servers nas Configurações](https://pentagi.com/images/product/ee-mcp-servers.webp)

Os MCP servers são conectados em **Settings → MCP Servers** via Streamable HTTP ou HTTP+SSE legado. Servidores que só falam `stdio` rodam atrás de um gateway MCP na sua rede; o PentAGI nunca inicia um executável fornecido por plugin fora de sua sandbox.

O PentAGI recusa endpoints MCP em endereços privados, de loopback, link-local e de metadados, a menos que `MCP_ALLOWED_EGRESS_CIDRS` liste o intervalo, então, para um gateway na sua rede, defina seu prefixo, por exemplo `10.8.0.0/24`. HTTP simples é aceito apenas para `localhost`, endereços de loopback e `host.docker.internal`.

Um novo servidor permanece desativado até ser ativado em **On** sob **Availability**: os administradores definem o **Default for users**, e cada usuário pode substituí-lo em **My state**. Os agents acessam um servidor por meio de um plugin que vincula suas funções, ou diretamente assim que você ativa **Offer without a plugin** e seleciona as funções (**Allow direct use**).

As credenciais são somente para gravação: você as insere ao adicionar um servidor e pode substituí-las ou revogá-las depois — a revogação também desliga o servidor — e a API nunca as retorna. Elas são criptografadas com `MCP_CREDENTIALS_ENCRYPTION_KEY` (64 caracteres hexadecimais; o instalador gera uma). Faça backup da chave: uma vez que as credenciais estejam armazenadas, o PentAGI não inicia sem ela.

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

![Plugins nas Configurações](https://pentagi.com/images/product/ee-plugins.webp)

Adicione um plugin em **Settings → Plugins** com **New plugin** ou **Import package** (um arquivo `.tar.gz`); um pacote importado chega como rascunho e só é oferecido depois que você o publica. Pacotes colocados em `PLUGINS_DIR` (`/opt/pentagi/plugins` dentro do container) aparecem em **Bundled runtime plugins** após **Reload registry**.

Os plugins ficam disponíveis para os planners somente quando os MCP servers necessários estão instalados e habilitados. Os administradores definem o **Default for users** de cada plugin — **On**, **Default** ou **Off** — e cada usuário pode sobrescrevê-lo em **My state** para plugins empacotados ou **My override** para os demais. **Default** segue `PLUGINS_ENABLEMENT_MODE`: `auto`, o padrão, oferece todos os plugins cujos MCP servers estejam prontos, enquanto `manual` oferece um plugin somente quando ele é definido como **On**.