Pular para o conteúdo
PentAGI
Enterprise

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 podem fazer por meio de Agent Plugins — pacotes no formato aberto agent-plugins.org com skills, declarações de MCP server e perfis específicos do PentAGI.

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

Revelação progressiva

Um planner vê o nome de cada 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 do agent — no máximo 20 por subtask — e scripts e referências são lidos sob demanda dentro da sandbox, portanto um catálogo grande tem custo baixo até que um plugin seja selecionado.

MCP servers

MCP servers nas Configurações

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

Plugins nas Configurações

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.

Última atualização em