Visão geral

Os administradores do espaço de trabalho podem importar um marketplace de plugins do GitHub para o diretório do seu espaço de trabalho. Um marketplace é um catálogo JSON que lista os plugins a importar. 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 — não liga as contas dos membros do espaço de trabalho nem concede acesso às aplicações incluídas num plugin.


Para uma introdução aos plugins e às aplicações que incluem, consulte: Plugins no ChatGPT e no Codex.

Antes de começar

• Utilize uma conta do GitHub com acesso de leitura ao repositório do marketplace e a todos os outros repositórios que este referencia. São suportados repositórios públicos e privados em github.com.

• Obtenha as aprovações exigidas pela organização do GitHub para que a conta utilizada na importação possa aceder a esses repositórios.

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

Os novos plugins começam com a política de instalação Disponível e autenticação no momento da instalação. Os novos marketplaces têm a sincronização automática diária ativada. Após a importação, reveja as definições de cada plugin no espaço de trabalho e as aplicações necessárias.

Importar um marketplace

1. Aceda à Consola de administração, selecione o espaço de trabalho do ChatGPT pretendido e abra Plugins. Em seguida, selecione Adicionar e escolha Importar marketplace.

2. Em Origem, introduza o URL do repositório, por exemplo, https://github.com/example/team-plugins. Utilize apenas o URL do repositório, não o URL de um branch ou de uma pasta.

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

4. Se pretender, preencha o campo Branch, tag ou commit. Deixe-o em branco para utilizar o branch predefinido do repositório. Utilize um branch para receber commits futuros. Se fixar um commit, mantém-se essa revisão.

5. Selecione Importar marketplace e autorize o acesso ao GitHub quando lhe for pedido.

6. Reveja os Resultados da importação e, em seguida, abra cada plugin importado para configurar a respetiva política de instalação e as aplicações necessárias.

A importação inicial pode demorar até 1 hora no caso de marketplaces muito grandes. As sincronizações diárias seguintes demoram normalmente alguns minutos.

Se não for possível importar um plugin, o relatório explica o erro. Os restantes plugins válidos podem ser importados na mesma.

Formatos suportados

O diretório selecionado tem de conter um manifesto suportado:

• .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 autónomo do Claude quando não existe um manifesto de marketplace.

As entradas do marketplace podem referenciar pastas de plugins no mesmo repositório ou origens suportadas de repositórios do GitHub. A importação para o espaço de trabalho não suporta outros serviços de alojamento Git nem origens de registos de pacotes, como o npm.

Para saber mais sobre os formatos suportados, exemplos de JSON e campos de origem, consulte: Gestão de plugins.

Configurar o acesso no espaço de trabalho

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


Utilize a Política de instalação para escolher Disponível ou Instalado para cada função elegível. As aplicações necessárias também têm de estar ativadas, e os membros têm de ter acesso ao serviço ligado e concluir a autenticação exigida.


Sincronizar uma atualização de um plugin ou passar a gerir um plugin existente através do GitHub preserva as respetivas políticas do espaço de trabalho. A importação de um plugin não concede acesso às aplicações nem liga as contas dos membros.


Para saber mais sobre a navegação no espaço de trabalho, o acesso às aplicações e os controlos do espaço de trabalho, consulte: Controlos de administração, segurança e conformidade para plugins e aplicações.

Manter os plugins atualizados

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

1. Aceda à Consola de administração, selecione o espaço de trabalho do ChatGPT pretendido 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 os plugins existentes. Reveja as alterações do repositório antes de as integrar, pois a sincronização automática pode importar novos plugins sem uma nova etapa de importação.

Rever os resultados da sincronização

Após uma sincronização, reveja o respetivo estado e o relatório guardado. Concluída — N erros significa que a sincronização terminou, mas não foi possível processar alguns plugins.


Se uma atualização de um plugin existente for inválida, é mantida a última versão funcional. As restantes atualizações válidas podem ser concluídas na mesma. Corrija o problema indicado no GitHub e, em seguida, selecione Sincronizar agora para tentar novamente.


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

Compreender a remoção e a eliminação

Remover uma entrada do repositório não elimina a respetiva cópia importada para o espaço de trabalho. O plugin é marcado como Já não existe na origem.


Eliminar o marketplace no ChatGPT elimina todos os plugins importados a partir dele. Não elimine um marketplace para restabelecer a ligação ao GitHub ou alterar o proprietário.

Restabelecer a ligação ou alterar o acesso ao GitHub

A sincronização do marketplace utiliza a ligação ao GitHub do administrador que o importou. Essa conta tem de manter o acesso ao repositório do marketplace e a todos os repositórios referenciados.

Voltar a ligar a conta original

1. Confirme que a conta do GitHub utilizada na importação continua a ter 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 voltar a ligar a respetiva conta.

Transferir para um novo administrador

O novo administrador do espaço de trabalho pode importar o mesmo marketplace utilizando a sua própria ligação ao GitHub:

1. Aceda à Consola de administração, selecione o espaço de trabalho do ChatGPT pretendido e abra Plugins. Em seguida, selecione Adicionar > Importar marketplace.

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

3. Selecione Importar marketplace e autorize o acesso ao GitHub quando lhe for pedido.

As sincronizações futuras utilizam a ligação ao GitHub do novo administrador. A conta do novo administrador tem de ter acesso de leitura ao repositório do marketplace e a todos os repositórios que este referencia.

Passar a gerir um plugin existente através do GitHub

Pode utilizar um marketplace para gerir um plugin existente no espaço de trabalho que tenha sido carregado como arquivo ou que ainda não seja gerido por uma origem do GitHub. O plugin existente tem de estar no mesmo espaço de trabalho e ter o mesmo nome de plugin. Não é possível assumir desta forma a gestão de um plugin gerido por outra origem do GitHub.


Para identificar o plugin existente no seu marketplace:

1. Aceda à Consola de administração, selecione o espaço de trabalho do ChatGPT pretendido e abra Plugins. Abra o plugin.

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

3. Adicione esse ID como pluginId, junto de name e source, na entrada correspondente da matriz plugins do marketplace. Não o adicione ao ficheiro plugin.json do plugin.

O plugin mantém o seu ID, as definições de partilha e as políticas do espaço de trabalho. O GitHub passa a ser a origem das atualizações futuras, pelo que os carregamentos posteriores de arquivos não podem substituir o plugin.


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

Referenciar uma aplicação existente

Um plugin pode referenciar uma aplicação existente no ficheiro .app.json, na raiz do plugin. Inclua o ponto inicial no nome do ficheiro e utilize o ID da aplicação em vez de um ID de plugin. Para um plugin nativo, defina o campo apps em .codex-plugin/plugin.json como ./.app.json.


A referência não cria uma aplicação nem concede permissões adicionais. Continuam a aplicar-se as definições existentes de acesso à aplicação no espaço de trabalho, a autenticação, os controlos de ações e as permissões do serviço ligado.


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

Compreender a etiqueta Apenas no computador

Um plugin marcado como Apenas no computador não pode ser executado no ChatGPT na Web. Os plugins importados podem receber esta etiqueta quando declaram servidores MCP, por exemplo, em mcp.json ou .mcp.json, mesmo que um servidor utilize um URL HTTPS remoto.


Adicionar uma referência .app.json não remove, por si só, a etiqueta Apenas no computador. Qualquer aplicação referenciada tem de continuar a estar disponível para a função do membro, e aplicam-se os requisitos habituais de acesso e autenticação dessa aplicação.