Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Submeter e publicar no diretório

Aula 12 de 14 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Como funciona
  2. 1. Carregar o ZIP
  3. 2. Resolver problemas detetados automaticamente
  4. 3. Submeter para revisão
  5. 4. Publicar
  6. Atualização
  7. Pontos-chave

Lição reescrita a 3 de novembro de 2026 com base na página Upload and submit your plugin da documentação de Plugins da OpenAI. A lição anterior descrevia a publicação numa “ChatGPT Store” com uma etapa de “preços”. Atualmente, submete um ficheiro ZIP do seu plugin através do portal de plugins da plataforma OpenAI, e o plugin é publicado no diretório partilhado pelo ChatGPT e pelo Codex. Fonte: Upload and submit your plugin.

Como funciona

Submete o pacote já construído (Lição 10) como um ficheiro ZIP, resolve quaisquer problemas detetados pelas verificações automáticas e envia-o para revisão. Assim que o seu plugin for aprovado, decide quando o publicar. Posteriormente, as alterações ao seu servidor MCP são detetadas automaticamente após validação; apenas alterações aos metadados ou às competências exigem um novo ZIP. Um servidor remoto é submetido através do caminho With MCP, utilizando um ponto de acesso HTTPS público e estável. Um plugin que execute um servidor MCP local segue o fluxo de trabalho dos plugins para desktop.

1. Carregar o ZIP

Selecione a organização e o projeto que detêm o plugin. Os proprietários da organização podem submeter; outros membros necessitam da permissão Apps Management Write. Verifique a sua identidade — individual ou empresarial — nas definições da sua organização: o nome associado a esta identidade é o que o diretório irá apresentar.

Se o plugin utilizar um servidor MCP, inclua-o no ZIP inicial: não é atualmente possível adicionar um servidor MCP a um plugin existente que possua apenas competências. De seguida, aceda a Plugins, selecione Upload new or existing plugin, escolha a sua identidade de programador, clique em Upload plugin e selecione o seu ZIP. Após a validação, a página de rascunho será aberta. Nunca inclua credenciais ou segredos no ZIP.

2. Resolver problemas detetados automaticamente

A página do plugin separa dois painéis, pois evoluem de forma diferente: Metadata & Skills, que regista a versão do pacote carregado, e MCPs, que mostra o servidor ligado e as suas ferramentas analisadas.

  • Metadados. Aguarde a conclusão das verificações, reveja os Issues, corrija o seu pacote de origem e carregue um ZIP corrigido. Os URLs públicos devem estar acessíveis e identificar o mesmo editor da submissão. O botão Copy issues permite-lhe colar as constatações no ChatGPT ou no Codex para sugerir correções.
  • Competências. As competências são analisadas automaticamente; corrija as suas instruções ou ficheiros com base nas constatações. As análises obrigatórias devem ser aprovadas antes de qualquer submissão.
  • Servidor MCP. Um pacote pode declarar vários servidores, mas apenas um pode ser ligado por plugin. Abra MCPs, selecione o servidor e clique em Connect; verifique o URL e a autenticação, conclua o desafio de verificação do domínio, inicie sessão se necessário, aguarde a análise das ferramentas e reveja as constatações.

A verificação do domínio envolve servir o token de desafio, como texto simples e nada mais, no endereço especificado pelo portal:

https://<challenge-host>/.well-known/openai-apps-challenge

O anfitrião deve ser uma origem HTTPS no nome de anfitrião do servidor MCP ou num domínio pai elegível.

3. Submeter para revisão

Os revisores necessitam de itens específicos para testar a integração. Alguns destes podem ser incluídos em plugin.json para serem importados com o ZIP:

  • Credenciais de teste, se o início de sessão for necessário: uma conta dedicada com dados de exemplo, nunca a conta de um utilizador real, utilizável imediatamente — sem MFA, códigos por e-mail/SMS, ligações mágicas ou acesso a redes privadas. Introduza estas credenciais separadamente, fora do pacote público;
  • Cinco casos de teste positivos: cenário, prompt, ferramentas esperadas, resultado esperado, cada um já executado com a conta de teste;
  • Três casos de teste negativos: um pedido que o plugin não deve satisfazer, o motivo e a recusa, esclarecimento ou alternativa esperada;
  • Um vídeo que demonstre os casos de teste e a funcionalidade do plugin;
  • Notas de lançamento para o pacote submetido.

De seguida, selecione o rascunho, clique em Submit for review e confirme as declarações de conformidade obrigatórias. Apenas uma revisão pode estar ativa por plugin. O feedback chega por e-mail; se for rejeitado, corrija os problemas e submeta um ZIP corrigido, ou recorra respondendo ao e-mail.

4. Publicar

Assim que o plugin for aprovado, abra a versão aprovada e selecione Publish plugin. Os utilizadores podem então encontrá-lo no diretório partilhado pelo ChatGPT e pelo Codex, seja através de uma ligação direta para a sua listagem ou pesquisando pelo seu nome.

Atualização

Coexistem dois fluxos de trabalho. Para metadados, elementos visuais ou competências, carregue um novo ZIP completo com um número de versão incrementado para o plugin existente: a nova versão passa pelas suas próprias verificações e revisão, e a sua publicação substitui a anterior. Para as ferramentas do seu servidor, nada a carregar: após a publicação inicial, a OpenAI analisa o seu servidor diariamente e disponibiliza atualizações elegíveis assim que estas passarem nas verificações automáticas; pode também solicitar uma análise imediatamente após uma implementação. Para alterar o URL de um servidor MCP existente, deve contactar o suporte.

Pontos-chave

  • Submeta um ZIP do seu plugin no portal Plugins sob uma identidade verificada
  • Metadados e competências de um lado, servidor MCP e ferramentas do outro: dois painéis de controlo separados
  • Verificação do domínio através de um token servido em /.well-known/openai-apps-challenge
  • Requisitos de revisão: conta de teste sem MFA, 5 casos positivos, 3 casos negativos, um vídeo e notas de lançamento
  • Após a publicação: novo ZIP para metadados e competências, análise diária para ferramentas