Todos Concordaram Sobre o Que é um Plugin de IA. Ninguém Disse Como Instalá-lo.

A Amazon, Cursor, Microsoft, OpenAI e Vercel não concordam em muito. Na semana passada, todos colocaram seus nomes na mesma coisa: a Especificação de Plugins de Agente 1.0.0, uma maneira padrão de empacotar um plugin para agentes de IA. Uma pasta. Um plugin.json no topo, um diretório skills/ ao lado, um mcp.json para as ferramentas.

Essa parte precisava ser feita. Antes disso, cada fornecedor enviava seu próprio sabor de "plugin" e você traduzia entre os sabores manualmente.

Aqui está a parte que me incomoda. A especificação cobre apenas o empacotamento, e isso está claro em seu próprio escopo. Instalação? Distribuição? Colocar um plugin nas cinco configurações de agente que você já mantém? Fora do escopo. A especificação desenha uma caixa limpa em torno do que é um plugin e, em seguida, para na borda da caixa.

Então eu fiz as contas na minha própria máquina. Cinco agentes, um plugin. O jeito manual é cinco arquivos de configuração em cinco formatos diferentes, cinco chances de errar um caminho, cinco reinicializações e uma desinstalação que se transforma em um projeto de arqueologia em todos os cinco. A indústria padronizou a caixa, então deixou todo mundo parado no estacionamento sem caminhão para transportá-la.

O mcptoon 0.7.1 preenche essa lacuna. A mesma ideia que o CLI sempre teve, escrever a configuração nativa de cada agente para você, agora apontada para o novo formato de plugin.

Quatro comandos

mcptoon plugin scan <dir>      # valida um pacote de plugin (somente leitura)
mcptoon plugin install <dir>   # instala no mcptoon + em todos os agentes sincronizados
mcptoon plugin list            # o que está instalado
mcptoon plugin remove <name>   # remove em todos os lugares

scan valida. install propaga. list mostra o que foi instalado onde. remove retira de volta de cada configuração que tocou.

install é o que vale a pena estudar, porque ele toma três decisões que um instalador ingênuo erraria.

As variáveis são resolvidas antes de chegarem a um agente. Pacotes de plugins referenciam ${PLUGIN_ROOT} e ${PLUGIN_DATA}, e a especificação assume que o agente carregador irá expandi-las. A maioria dos agentes não pode. É exatamente por isso que a lacuna existe. O mcptoon é o instalador, então ele expande ambas as variáveis em caminhos absolutos e escreve caminhos simples em cada configuração de agente. Nenhum agente vê uma variável que não pode entender. Quando o mcptoon inicia o servidor stdio de um plugin, ele injeta os mesmos dois nomes como variáveis de ambiente, para que plugins compatíveis com a especificação funcionem em ambas as direções.

Remove alcança onde install alcançou. plugin remove não apenas exclui uma pasta. Ele poda as entradas plugin:server nomeadas de cada configuração de agente que a instalação tocou. Uma coisa que ele mantém de propósito: o diretório de dados do plugin sob ~/.mcptoon/plugins-data/. A especificação pede dados persistentes do plugin, então um cache sobrevive a uma atualização ou a uma reinstalação --force. Exclua essa pasta você mesmo se quiser um slate verdadeiramente limpo.

A validação falha de forma restritiva. plugin scan verifica o manifesto contra um esquema fechado. Campos desconhecidos são rejeitados. Comandos devem ser um único token. URLs remotas devem ser HTTPS, a menos que apontem para loopback. Credenciais em cabeçalhos são rejeitadas. Escapes de caminho como ../ são rejeitados. Um pacote que falha no scan nunca chega a uma configuração de agente.

Experimente

# 1 · instalar (cerca de 250KB, biblioteca padrão pura, zero dependências)
pip install mcptoon

# 2 · validar qualquer pacote de Plugins de Agente, sem efeitos colaterais
mcptoon plugin scan ./meu-plugin

# 3 · instalá-lo em todos os agentes que você tem sincronizados
mcptoon plugin install ./meu-plugin

Porque os plugins são instalados na mesma configuração que qualquer outro servidor MCP, eles herdam tudo o que o mcptoon já faz. O manifesto comprimido que economiza até 99,8% dos tokens de listagem de ferramentas. mcptoon call. mcptoon health. A versão 0.7.1 também adquiriu suporte a stdio cwd ao longo do caminho, então um servidor de plugin pode declarar seu próprio diretório de trabalho.

Os limites honestos

Este é um instalador, não um mercado. Não há busca de registro ainda, você instala a partir de um diretório que já possui. O validador rejeita qualquer coisa que a especificação não define, que é o ponto, mas isso também significa que pacotes não padrão criativos são rejeitados. Diretórios de dados persistem por design. Inícios a frio em servidores stdio ainda custam algumas centenas de milissegundos cada.

A suíte por trás de tudo isso é 610 testes, todos passando no CI, além de uma execução ao vivo de 19 pontos contra configurações de agentes reais.

Os fornecedores definiram o que é um plugin. Colocá-lo em cada agente em sua máquina costumava ser seu problema. Agora é um comando.