Visão geral

Os administradores do espaço de trabalho podem importar um marketplace de plugins do GitHub para o diretório do espaço de trabalho. Um marketplace é um catálogo JSON que lista os plugins a serem importados. Após a importação, a sincronização diária mantém os plugins atualizados com as alterações do repositório.


A sincronização do marketplace importa o conteúdo dos plugins — ela não conecta as contas dos membros do espaço de trabalho nem concede acesso aos apps incluídos em um plugin.


Para uma introdução aos plugins e aos apps incluídos neles, consulte: Plugins no ChatGPT e no Codex.

Antes de começar

• Use uma conta do GitHub com acesso de leitura ao repositório do marketplace e a todos os outros repositórios que ele referencia. Há suporte a repositórios públicos e privados no github.com.

• Obtenha todas as aprovações exigidas pela organização no GitHub para que a conta usada na importação possa acessar esses repositórios.

• Revise o conteúdo do repositório. A importação processa todos os plugins válidos sem uma etapa de aprovação separada para cada um, e as sincronizações futuras podem adicionar novos plugins.

Novos plugins começam com a política de instalação Disponível e autenticação no momento da instalação. Novos marketplaces têm a sincronização automática diária ativada. Após a importação, revise as configurações de cada plugin no espaço de trabalho e os apps necessários.

Importar um marketplace

1. Acesse o Console de administração, selecione o espaço de trabalho desejado do ChatGPT e abra Plugins. Em seguida, selecione Adicionar e escolha Importar marketplace.

2. Em Origem, insira a URL do repositório, como https://github.com/example/team-plugins. Use apenas a URL do repositório, sem incluir a URL de uma branch ou pasta.

3. Se o marketplace estiver em um subdiretório, insira esse diretório em Caminho. Por exemplo, insira team-tools para team-tools/.agents/plugins/marketplace.json. Deixe Caminho em branco para usar a raiz do repositório. Não insira o nome do arquivo de manifesto.

4. Se quiser, preencha Branch, tag ou commit. Deixe o campo em branco para usar a branch padrão do repositório. Use uma branch para receber commits futuros. Ao definir um commit específico, o conteúdo permanece nessa revisão.

5. Selecione Importar marketplace e autorize o acesso ao GitHub quando solicitado.

6. Confira os Resultados da importação e abra cada plugin importado para configurar sua política de instalação e os apps necessários.

A importação inicial pode levar até 1 hora para marketplaces muito grandes. As sincronizações diárias seguintes costumam levar alguns minutos.

Se não for possível importar um plugin, o relatório explicará o erro. Os demais plugins válidos ainda poderão ser importados.

Formatos compatíveis

O diretório selecionado deve conter um manifesto compatível:

• .agents/plugins/marketplace.json para um marketplace do Codex.

• .claude-plugin/marketplace.json para um marketplace compatível com o Claude.

• .claude-plugin/plugin.json para um plugin independente do Claude quando não houver um manifesto de marketplace.

As entradas do marketplace podem referenciar pastas de plugins no mesmo repositório ou origens compatíveis de repositórios do GitHub. A importação para o espaço de trabalho não oferece suporte a outros serviços de hospedagem Git nem a origens de registros de pacotes, como o npm.

Para ver os formatos compatíveis, exemplos de JSON e campos de origem, consulte: Gerenciamento de plugins.

Configurar o acesso no espaço de trabalho

O GitHub fornece o conteúdo dos plugins, enquanto as configurações do espaço de trabalho controlam a instalação e a autenticação. A importação e a sincronização não aplicam valores de políticas do repositório, como AVAILABLE ou ON_USE. Defina essas configurações para cada plugin no seu espaço de trabalho.


Use a Política de instalação para escolher Disponível ou Instalado para cada função elegível. Os apps necessários também devem estar ativados, e os membros devem ter acesso ao serviço conectado e concluir qualquer autenticação exigida.


Sincronizar uma atualização de plugin ou passar a gerenciar um plugin existente pelo GitHub preserva suas políticas do espaço de trabalho. Importar um plugin não concede acesso a apps nem conecta as contas dos membros.


Para saber mais sobre navegação no espaço de trabalho, acesso a apps e controles do espaço de trabalho, consulte: Controles de administração, segurança e conformidade para plugins e apps.

Manter os plugins atualizados

Novos marketplaces verificam diariamente se há atualizações. Para solicitar uma atualização sem esperar pela sincronização automática:

1. Acesse o Console de administração, selecione o espaço de trabalho desejado do ChatGPT e abra Plugins.

2. Abra Marketplaces e selecione o marketplace.

3. Selecione Sincronizar agora.

A sincronização pode adicionar novas entradas do marketplace e atualizar plugins existentes. Revise as alterações do repositório antes de fazer o merge, pois a sincronização automática pode importar novos plugins sem outra etapa de importação.

Conferir os resultados da sincronização

Após uma sincronização, confira o status e o relatório salvo. Concluída — N erros significa que a sincronização terminou, mas alguns plugins não puderam ser processados.


Se uma atualização de um plugin existente for inválida, a última versão funcional será mantida. As demais atualizações válidas ainda poderão ser concluídas. Corrija o problema relatado no GitHub e selecione Sincronizar agora para tentar novamente.


Se a interface de administração mostrar Atualizar para um plugin importado individualmente, use essa opção para atualizar o plugin. Atualizar lista de plugins apenas recarrega a lista exibida; essa opção não sincroniza com o GitHub.

Entender a remoção e a exclusão

Remover uma entrada do repositório não exclui a cópia importada para o espaço de trabalho. O plugin recebe o status Não está mais na origem.


Excluir o marketplace no ChatGPT exclui todos os plugins importados dele. Não exclua um marketplace para reconectar o GitHub ou alterar o proprietário.

Reconectar ou alterar o acesso ao GitHub

A sincronização do marketplace usa a conexão com o GitHub do administrador que o importou. Essa conta precisa manter o acesso ao repositório do marketplace e a todos os repositórios referenciados.

Reconectar a conta original

1. Confirme que a conta do GitHub usada na importação ainda tem acesso a todos os repositórios necessários.

2. Peça ao administrador que importou originalmente o marketplace para abrir o plugin do GitHub no ChatGPT e reconectar a própria conta.

Transferir para um novo administrador

O novo administrador do espaço de trabalho pode importar o mesmo marketplace usando a própria conexão com o GitHub:

1. Acesse o Console de administração, selecione o espaço de trabalho desejado do ChatGPT e abra Plugins. Em seguida, selecione Adicionar > Importar marketplace.

2. Insira os mesmos valores de Origem, Caminho e Branch, tag ou commit usados para o marketplace existente.

3. Selecione Importar marketplace e autorize o acesso ao GitHub quando solicitado.

As sincronizações futuras usam a conexão com o GitHub do novo administrador. A conta do novo administrador deve ter acesso de leitura ao repositório do marketplace e a todos os repositórios que ele referencia.

Passar a gerenciar um plugin existente pelo GitHub

Você pode usar um marketplace para gerenciar um plugin existente no espaço de trabalho que foi enviado como arquivo compactado ou que ainda não é gerenciado por uma origem do GitHub. O plugin existente deve estar no mesmo espaço de trabalho e ter o mesmo nome de plugin. Não é possível assumir dessa forma o gerenciamento de um plugin gerenciado por outra origem do GitHub.


Para identificar o plugin existente no seu marketplace:

1. Acesse o Console de administração, selecione o espaço de trabalho desejado do ChatGPT e abra Plugins. Abra o plugin.

2. Copie o ID do plugin que aparece após /admin/plugins/ na URL.

3. Adicione esse ID como pluginId, ao lado de name e source, na entrada correspondente do array plugins do marketplace. Não o adicione ao arquivo plugin.json do plugin.

O plugin mantém seu ID, suas configurações de compartilhamento e suas políticas do espaço de trabalho. O GitHub passa a ser a origem das atualizações futuras, então envios posteriores de arquivos compactados não podem substituir o plugin.


Para ver um exemplo de migração e os requisitos, consulte: Gerenciamento de plugins.

Referenciar um app existente

Um plugin pode referenciar um app existente no arquivo .app.json, na raiz do plugin. Inclua o ponto inicial no nome do arquivo e use o ID do app, não o ID de um plugin. Para um plugin nativo, defina o campo apps em .codex-plugin/plugin.json como ./.app.json.


A referência não cria um app nem concede permissões adicionais. Continuam valendo as configurações existentes de acesso ao app no espaço de trabalho, autenticação, controles de ações e permissões do serviço conectado.


Para saber mais sobre o formato JSON, consulte: Gerenciamento de plugins.

Entender o rótulo Somente no desktop

Um plugin marcado como Somente no desktop não pode ser executado no ChatGPT na web. Plugins importados podem receber esse rótulo quando declaram servidores MCP, por exemplo, em mcp.json ou .mcp.json, mesmo quando um servidor usa uma URL HTTPS remota.


Adicionar uma referência em .app.json não remove, por si só, o rótulo Somente no desktop. Qualquer app referenciado ainda precisa estar disponível para a função do membro, e seus requisitos normais de acesso e autenticação continuam valendo.