Se você já publica um plug-in ou conector do Claude Code, escolha o processo de envio de acordo com 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 plug-in somente com habilidades. |
| Um endpoint MCP HTTPS público | Crie um envio com MCP remoto. Inclua todas as habilidades no mesmo rascunho. |
| Um servidor MCP local | Implante-o em uma URL HTTPS pública. Se isso não for possível, procure seu contato na OpenAI para obter suporte a MCP local. |
O Claude usa processos de envio separados para plug-ins do Claude Code e conectores MCP. A OpenAI usa um único pacote de plug-in que pode conter habilidades, servidores MCP ou ambos. As listagens e aprovações do marketplace do Claude não são transferidas.
Se o seu plug-in incluir habilidades, revise as instruções delas com base nas orientações para seguir instruções antes de enviá-las por qualquer uma das duas opções.
Envie um plug-in somente com habilidades
Escolha esse processo quando o plug-in não precisar de um servidor MCP.
Confira o que a OpenAI oferece suporte
| O que seu plug-in do Claude contém | O que fazer |
|---|---|
skills | Mantenha cada habilidade junto de seu SKILL.md, scripts, referências e recursos. Para fazer upload direto de um arquivo compactado do Claude, ele deve incluir pelo menos uma habilidade em skills/<skill-name>/SKILL.md. |
| Diretórios personalizados de habilidades declarados no manifesto | Mantenha os diretórios e suas declarações no manifesto dentro do arquivo compactado. |
| Habilidades que fazem referência explícita ao Claude | Substitua as referências específicas ao Claude nas instruções da habilidade por uma linguagem neutra em relação ao 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 comportamentos reutilizáveis em habilidades. Transforme cada comando Markdown em uma habilidade, mova procedimentos reutilizáveis de agentes para habilidades e incorpore as instruções úteis de persona à habilidade correspondente. |
hooks ou hooks/hooks.json | Adapte os ganchos de comando para o ambiente de execução de ganchos do Codex, incluindo ChatGPT Work e Codex. Os scripts dos ganchos devem estar disponíveis no ambiente de execução e ser considerados confiáveis antes de serem executados. Não dependa de ganchos no Chat comum; o Codex não executa manipuladores de ganchos de prompt ou de agente. |
userConfig ou ${user_config.*} | A OpenAI não executa os prompts de instalação do Claude nem expande variáveis user_config. Siga as orientações em Substitua o userConfig do Claude. Se o plug-in precisar de credenciais ou 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. Em vez disso, retorne o conteúdo como uma resposta comum na conversa; por exemplo, renderize as tabelas dos artefatos como tabelas padrão. O HTML, a persistência, o comportamento de recarga e as interações específicos dos artefatos não são preservados. |
bin/, settings, settings.json, CLAUDE.md ou .claude/settings*.json | Mantenha os utilitários e as instruções necessários no plug-in. Chame os executáveis incluídos usando caminhos relativos ao pacote e remova as configurações exclusivas do Claude. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels ou dependencies | Mova os comportamentos essenciais para habilidades e, em seguida, 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. Um upload somente com habilidades exclui a configuração do servidor MCP, e você não pode enviar uma integração existente de servidor MCP por referência. |
Prepare e faça upload do arquivo compactado
- Confirme que a raiz do arquivo compactado, ou seu único diretório de nível superior, inclui
.claude-plugin/plugin.jsoncom o campodescriptionpreenchido e pelo menos uma habilidade válida emskills/<skill-name>/SKILL.md. - Abra o portal de envio de plug-ins, selecione Criar plug-in, escolha Somente habilidades e faça upload do arquivo compactado.
- Revise o
.codex-plugin/plugin.jsongerado. O portal adiciona os valores padrão de interface que estiverem faltando e normaliza os campos de texto durante a conversão. - Teste as habilidades importadas em um ambiente limpo. Confirme que cada habilidade consegue encontrar os arquivos e executáveis que referencia e não depende de pacotes locais, arquivos ou credenciais não declarados.
- Preencha os campos de listagem e revisão, corrija todos os problemas apontados pela verificação e envie o rascunho.
Se o arquivo compactado não atender aos requisitos para upload direto, siga as orientações em Empacote seu plug-in para criar o manifesto e a estrutura de pacote da OpenAI. Consulte Criar habilidades para conhecer os requisitos das habilidades.
Envie um plug-in com um servidor MCP remoto
Escolha esse processo quando o servidor tiver uma URL HTTPS pública e estável que a OpenAI possa acessar. O servidor pode ter sido local no plug-in do Claude; para esse envio, o que importa é que você o tenha implantado como um serviço remoto.
Confira o que a OpenAI oferece suporte
| O que sua 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. Se isso não for possível, procure seu contato na OpenAI para obter suporte a 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 Com MCP . Mantenha cada SKILL.md junto de seus scripts, referências e recursos. |
| Habilidades que fazem referência explícita ao Claude | Substitua as referências específicas ao Claude nas instruções da habilidade por uma linguagem neutra em relação ao 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 comportamentos reutilizáveis em habilidades. Transforme cada comando Markdown em uma habilidade, mova procedimentos reutilizáveis de agentes para habilidades e incorpore as instruções úteis de persona à habilidade correspondente. |
hooks ou hooks/hooks.json | Adapte os ganchos de comando para o ambiente de execução de ganchos do Codex, incluindo ChatGPT Work e Codex. Os scripts dos ganchos devem estar disponíveis no ambiente de execução e ser considerados confiáveis antes de serem executados. Não dependa de ganchos no Chat comum; o Codex não executa manipuladores de ganchos de prompt ou de agente. |
userConfig ou ${user_config.*} | A OpenAI não executa os prompts de instalação do Claude nem expande variáveis user_config. Siga as orientações em Substitua o userConfig do Claude para mover cada valor para uma entrada explícita, OAuth, armazenamento hospedado ou 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 instruções que exijam criar, reabrir, recarregar ou atualizar um artefato. Retorne o conteúdo como uma resposta normal na conversa; por exemplo, apresente as tabelas dos artefatos como tabelas padrão. O HTML, a persistência, o comportamento de atualização e as interações específicos dos artefatos não são preservados. |
.app.json, apps ou uma integração existente com um servidor MCP | Envie o endpoint do servidor MCP diretamente. Não é possível enviar uma integração existente com um servidor MCP por referência. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels ou dependencies | Mova o comportamento essencial 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 seu 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 Autenticar usuários para consultar os requisitos de produto compatíveis e a especificação de autorização do MCP.
- Adicione esquemas precisos para as ferramentas e anotações de segurança. Teste se cada ferramenta se conecta, autentica, retorna o resultado no formato esperado e exige a confirmação prevista para ações de escrita ou destrutivas.
- Converta todos os comandos ou agentes em habilidades e confira se as habilidades não dependem de pacotes, arquivos ou credenciais locais não declarados.
- Abra o portal de envio de plug-ins, selecione Criar plug-in, escolha Com MCP e envie o endpoint de produção. Adicione as habilidades convertidas ao mesmo rascunho, quando aplicável.
- Verifique o domínio do servidor, configure a autenticação quando o servidor exigir login, preencha os campos de apresentação e revisão, corrija todos os problemas apontados pela verificação e envie o rascunho.
Planeje estas duas etapas de configuração antes do envio:
- Verificação de domínio: Você deve conseguir disponibilizar o token exato do portal
em
/.well-known/openai-apps-challengeno host MCP ou em um host pai permitido. Conclua o desafio quando o portal solicitar. Consulte Configurar o envio do MCP. - OAuth e restrições de domínio do workspace: Se o plug-in usar OAuth, exponha
um endpoint UserInfo que retorne a declaração
emaildo usuário eemail_verified: true. Anuncie e habilite os escoposopenideemail. Consulte Oferecer suporte a restrições de domínio do workspace.
Consulte os requisitos de revisão de servidores MCP remotos antes do envio.
Substitua o userConfig do Claude
Os plug-ins da OpenAI não executam os prompts de instalação de 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 plug-in o utiliza.
| O que o valor controla | Alternativa na OpenAI |
|---|---|
| Uma escolha que pode mudar a cada tarefa | Adicione uma entrada explícita à habilidade ou à ferramenta MCP. Solicite o valor apenas quando o fluxo de trabalho precisar dele. |
| Uma credencial para um serviço remoto | Use OAuth 2.1 por meio do servidor MCP remoto. Não inclua segredos no arquivo da habilidade, no manifesto, nas instruções ou 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 uma entrada de ferramenta. |
| Uma configuração para um script ou hook local do Codex | Use uma variável de ambiente ou um arquivo de configuração documentado. Verifique a configuração antes do uso e, se estiver ausente, retorne um erro que indique como resolver o problema. Não torne essa configuração local obrigatória para o fluxo de trabalho principal do ChatGPT. |
| Um valor fixo, igual para todos os usuários | Inclua um valor padrão que não seja secreto nas instruções da habilidade ou na configuração do serviço hospedado. |
Se um plug-in composto apenas por habilidades precisar de uma credencial ou 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 plug-in composto apenas por habilidades e solicite-o como uma entrada explícita da habilidade.
Cumpra os requisitos de envio
Antes de enviar qualquer um dos dois tipos de plug-in, obtenha acesso de escrita em Gerenciamento de Apps na organização da OpenAI que será proprietária dele. Você também deve concluir a verificação de identidade de pessoa física ou jurídica. Todo plug-in deve passar pela revisão da OpenAI.
Entre em contato com seu parceiro na OpenAI antes do envio se a proposta de valor principal do plug-in exigir execução local, acesso arbitrário a arquivos no computador do usuário, acesso a hardware ou aplicativos, funcionamento offline ou recebimento de mensagens de canais. Esses casos podem exigir uma revisão específica do produto.
Para consultar o fluxo de trabalho completo do portal, veja Enviar plug-ins. Se o portal informar um código de validação do pacote, consulte a referência de erros de envio.