Se você já publica um plugin ou conector do Claude Code, escolha a forma de envio conforme o que ele inclui: habilidades, um servidor MCP ou ambos.
| O que você tem | O que enviar |
|---|---|
| Habilidades sem servidor MCP | Faça upload de um plugin que contém apenas habilidades. |
| Um endpoint MCP público que usa HTTPS | Crie um envio com servidor MCP remoto. Se houver habilidades, inclua-as no mesmo rascunho. |
| Um servidor MCP local | Consulte Enviar plugins exclusivos para desktop para conferir os critérios de elegibilidade e as instruções de envio. |
O Claude usa processos de envio distintos para plugins do Claude Code e conectores MCP. A OpenAI usa um único pacote de plugin, que pode conter habilidades, servidores MCP ou ambos. As listagens e aprovações do Marketplace do Claude não são transferidas para a OpenAI.
Se o plugin incluir habilidades, revise as instruções de cada uma com base nas orientações sobre o cumprimento de instruções antes de enviá-las por qualquer uma das duas opções.
Enviar um plugin que contém apenas habilidades
Escolha esta opção se o plugin não precisar de um servidor MCP.
Confira o que a OpenAI aceita
| O que o plugin do Claude contém | O que fazer |
|---|---|
skills |
Mantenha cada habilidade junto com seu SKILL.md, seus scripts, suas referências e seus recursos. Para fazer upload direto de um arquivo compactado do Claude, inclua nele pelo menos uma habilidade em skills/<skill-name>/SKILL.md. |
| Diretórios personalizados de habilidades declarados no manifesto | Mantenha no arquivo compactado os diretórios e suas respectivas declarações no manifesto. |
| Habilidades que mencionam o Claude explicitamente | Nas instruções das habilidades, substitua as referências específicas ao Claude por termos que independam do provedor, como “o modelo”. Mantenha o nome de um produto apenas quando a instrução realmente se aplicar a ele. |
commands, commands/, agents ou agents/ |
Converta os comportamentos reutilizáveis em habilidades. Transforme cada comando em Markdown em uma habilidade, transfira os procedimentos reutilizáveis dos agentes para as habilidades e incorpore as instruções de persona que forem úteis à habilidade correspondente. |
hooks ou hooks/hooks.json |
Remova os hooks de ciclo de vida antes de enviar o plugin ao diretório público. Se o plugin depender desses hooks, distribua-o de modo que os usuários possam instalá-lo manualmente no Codex para desktop. Consulte Hooks de ciclo de vida. |
userConfig ou ${user_config.*} |
A OpenAI não exibe os prompts de instalação do Claude nem expande as variáveis user_config. Siga as orientações em Substituir o userConfig do Claude. Se o plugin precisar de credenciais ou de configurações persistentes do usuário, use um servidor MCP. |
| Habilidades que criam ou atualizam artefatos dinâmicos do Claude | A OpenAI ainda não oferece suporte aos artefatos dinâmicos do Claude. Remova as instruções que exigem criar, reabrir, recarregar ou atualizar um artefato. Apresente o conteúdo diretamente na resposta da conversa. Por exemplo, exiba as tabelas dos artefatos como tabelas comuns. O HTML específico dos artefatos, a persistência, o comportamento de recarga e as interações não são preservados. |
bin/, settings, settings.json, CLAUDE.md ou .claude/settings*.json |
Mantenha no plugin os utilitários e as instruções necessários. Para chamar os executáveis incluídos no pacote, use caminhos relativos à raiz do pacote. Remova as configurações exclusivas do Claude. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels ou dependencies |
Transfira os comportamentos essenciais para as habilidades e remova a declaração do Claude. Entre em contato com seu parceiro na OpenAI se o fluxo de trabalho principal exigir o recebimento de mensagens de canais. |
.claude-plugin/plugin.json |
Mantenha o manifesto para fazer upload direto do arquivo compactado do Claude. O portal o converte em .codex-plugin/plugin.json. |
.claude-plugin/marketplace.json, .mcp.json, mcpServers, .app.json ou apps |
Não dependa desses arquivos ou declarações. O upload de um pacote que contém apenas habilidades exclui a configuração do servidor MCP. Você também não pode enviar por referência uma integração existente com um servidor MCP. |
Prepare o arquivo compactado e faça o upload
- Confirme que a raiz do arquivo compactado ou seu único diretório de nível superior contém
.claude-plugin/plugin.jsoncom o campodescriptionpreenchido e pelo menos uma habilidade válida emskills/<skill-name>/SKILL.md. - Abra o portal de envio de plugins, selecione Criar plugin, escolha Apenas habilidades e faça upload do arquivo compactado.
- Revise o arquivo
.codex-plugin/plugin.jsongerado. Durante a conversão, o portal preenche os valores padrão de interface que estiverem ausentes e normaliza os campos de texto. - Teste as habilidades importadas em um ambiente limpo. Confirme que cada habilidade consegue localizar os arquivos e executáveis aos quais faz referência e que não depende de pacotes, arquivos ou credenciais locais que não tenham sido declarados.
- Preencha os campos da listagem e da revisão, corrija todos os problemas apontados pela verificação e envie o rascunho.
Se o arquivo compactado não atender aos critérios para upload direto, siga as orientações em Empacotar seu plugin para criar o manifesto e a estrutura de pacote da OpenAI. Consulte Criar habilidades para conferir os requisitos das habilidades.
Enviar um plugin com um servidor MCP remoto
Escolha esta opção se o servidor tiver uma URL HTTPS pública e estável que a OpenAI possa acessar. Mesmo que o servidor fosse local no plugin do Claude, você pode usar esta opção desde que já o tenha implantado como serviço remoto.
Confira o que a OpenAI aceita
| O que a integração com o Claude contém | O que fazer |
|---|---|
| Um servidor MCP remoto | Reutilize a implementação do servidor. Envie um endpoint HTTPS público e estável que use Streamable HTTP. |
Um servidor MCP local ou uma extensão do Claude Desktop (.mcpb) |
Implante o servidor MCP em uma URL HTTPS pública ou siga as orientações em Enviar plugins exclusivos para desktop para enviar um plugin com um servidor MCP local. O portal não aceita arquivos .mcpb. |
| Habilidades ou diretórios personalizados de habilidades declarados no manifesto | Inclua as habilidades no mesmo envio, na opção Com MCP. Mantenha cada SKILL.md junto com seus scripts, referências e recursos. |
| Habilidades que mencionam o Claude explicitamente | Nas instruções das habilidades, substitua as referências específicas ao Claude por termos que independam do provedor, como “o modelo”. Mantenha o nome de um produto apenas quando a instrução realmente se aplicar a ele. |
commands, commands/, agents ou agents/ |
Converta os comportamentos reutilizáveis em habilidades. Transforme cada comando em Markdown em uma habilidade, transfira os procedimentos reutilizáveis dos agentes para as habilidades e incorpore as instruções de persona que forem úteis à habilidade correspondente. |
hooks ou hooks/hooks.json |
Remova os hooks de ciclo de vida antes de enviar o plugin ao diretório público. Se o plugin depender desses hooks, distribua-o de modo que os usuários possam instalá-lo manualmente no Codex para desktop. Consulte Hooks de ciclo de vida. |
userConfig ou ${user_config.*} |
A OpenAI não exibe os prompts de instalação do Claude nem expande as variáveis user_config. Siga as orientações em Substituir o userConfig do Claude para fornecer cada valor por meio de uma entrada explícita, do OAuth, do armazenamento no serviço hospedado ou da configuração local do Codex. |
| Habilidades que criam ou atualizam artefatos dinâmicos do Claude | A OpenAI ainda não oferece suporte aos artefatos dinâmicos do Claude. Remova as instruções que exigem criar, reabrir, recarregar ou atualizar um artefato. Apresente o conteúdo diretamente na resposta da conversa. Por exemplo, exiba as tabelas dos artefatos como tabelas comuns. O HTML específico dos artefatos, a persistência, o comportamento de recarga e as interações não são preservados. |
.app.json, apps ou uma integração existente com um servidor MCP |
Envie diretamente o endpoint do servidor MCP. Você não pode enviar por referência uma integração existente com um servidor MCP. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels ou dependencies |
Transfira os comportamentos essenciais para habilidades ou ferramentas MCP e remova a declaração do Claude. Entre em contato com seu parceiro na OpenAI se o fluxo de trabalho principal exigir o recebimento de mensagens de canais. |
Prepare e envie o servidor MCP
- Implante o servidor MCP no endpoint HTTPS de produção usando Streamable HTTP. Use OAuth 2.1 quando o servidor acessar dados privados do usuário ou executar ações em nome dele. Siga as orientações em Autenticar usuários para atender aos requisitos de autenticação do produto e à especificação de autorização do MCP.
- Adicione schemas que descrevam com precisão as ferramentas e inclua as anotações de segurança. Teste cada ferramenta para confirmar que ela se conecta, faz a autenticação, retorna o resultado no formato esperado e exige a confirmação prevista para ações de escrita ou destrutivas.
- Converta os comandos ou agentes em habilidades e confirme que as habilidades não dependem de pacotes, arquivos ou credenciais locais que não tenham sido declarados.
- Abra o portal de envio de plugins, selecione Criar plugin, escolha Com MCP e envie o endpoint de produção. Se houver habilidades convertidas, adicione-as ao mesmo rascunho.
- Verifique o domínio do servidor e configure a autenticação se o servidor exigir login. Preencha os campos da listagem e da revisão, corrija todos os problemas apontados pela verificação e envie o rascunho.
Antes do envio, prepare-se para estas duas etapas de configuração:
- Verificação de domínio: Você precisa conseguir disponibilizar o token exato fornecido pelo portal no caminho
/.well-known/openai-apps-challenge, no host do servidor MCP ou em um host pai permitido. Conclua o desafio quando o portal solicitar. Consulte Configurar o envio com MCP. - OAuth e restrições de domínio do espaço de trabalho: Se o plugin usar OAuth, disponibilize um endpoint UserInfo que retorne o atributo
emaildo usuário eemail_verified: true. Anuncie e habilite os escoposopenideemail. Consulte Oferecer suporte às restrições de domínio do espaço de trabalho.
Antes do envio, confira os requisitos de revisão para servidores MCP remotos.
Substituir o userConfig do Claude
Os plugins da OpenAI não exibem os prompts de instalação definidos pelo userConfig do Claude nem expandem referências a ${user_config.*}. Remova essas referências e substitua cada valor de acordo com a forma como o plugin o utiliza.
| O que o valor controla | Alternativa na OpenAI |
|---|---|
| Uma escolha que pode variar a cada tarefa | Adicione um parâmetro de entrada explícito à habilidade ou à ferramenta MCP. Solicite o valor somente quando o fluxo de trabalho precisar dele. |
| Uma credencial de um serviço remoto | Use OAuth 2.1 por meio do servidor MCP remoto. Não inclua segredos no arquivo compactado de habilidades, no manifesto, nas instruções nem nos valores padrão. |
| Uma preferência que deve persistir | Armazene a preferência no serviço hospedado e associe-a ao usuário autenticado. Permita que o usuário a atualize por meio de um fluxo de trabalho explícito ou de um parâmetro de entrada da ferramenta. |
| Uma configuração para um script ou hook local do Codex | Use uma variável de ambiente ou um arquivo de configuração com documentação. Verifique a configuração antes de usá-la. Se estiver ausente, retorne um erro que indique como resolver o problema. O fluxo de trabalho principal do ChatGPT não deve depender dessa configuração local. |
| Um valor fixo, igual para todos os usuários | Defina um valor padrão que não seja secreto nas instruções da habilidade ou na configuração do serviço hospedado. |
Se um plugin que contém apenas habilidades precisar de uma credencial ou de uma configuração que deva persistir entre conversas, adicione um servidor MCP. Use OAuth e armazenamento hospedado para o servidor remoto. Se o valor afetar apenas a tarefa atual, mantenha o plugin com apenas habilidades e solicite o valor como um parâmetro de entrada explícito da habilidade.
Atender aos requisitos de envio
Antes de enviar um plugin por qualquer uma das duas opções, obtenha permissão de escrita em Gerenciamento de Apps na organização da OpenAI que será proprietária do plugin. Você também precisa concluir a verificação de identidade como pessoa física ou jurídica. Todos os plugins devem passar pela revisão da OpenAI.
Entre em contato com seu parceiro na OpenAI antes do envio se a principal funcionalidade do plugin exigir execução local, acesso arbitrário a arquivos no computador do usuário, acesso a hardware ou aplicativos, operação offline ou recebimento de mensagens de canais. Esses casos podem exigir uma revisão específica para o produto.
Para conferir todas as etapas de envio pelo portal, consulte Enviar plugins. Se o portal exibir um código de validação do pacote, consulte a referência de erros de envio.