Enviar plugins exclusivos para desktop

Plugins exclusivos para desktop precisam ser executados localmente no computador do usuário. Isso inclui a maioria dos plugins com um servidor MCP local (stdio) e os plugins que chamam programas locais. Eles aparecem com o selo Somente desktop no diretório de plugins da OpenAI. Os usuários só podem instalá-los pelo aplicativo ChatGPT para desktop e só podem mencioná-los em conversas executadas localmente.

Aprovação necessária: Somente parceiros aprovados podem enviar plugins com um servidor MCP local. Antes de seguir estas etapas, entre em contato com seu representante da OpenAI para confirmar a elegibilidade e garantir que a organização responsável pelo envio esteja na lista de organizações autorizadas.

Antes do envio, empacote seu plugin e teste uma instalação limpa no desktop, além dos principais fluxos de trabalho do plugin. Cumpra os pré-requisitos padrão de envio, incluindo a permissão de envio e a verificação da identidade do desenvolvedor ou da empresa.

Configurar um servidor MCP local

Use a mesma estrutura de plugin usada nos demais plugins. No arquivo mcp.json da raiz, substitua a entrada do servidor HTTP em mcpServers por uma entrada stdio que defina o comando para iniciar o servidor localmente.

O servidor pode usar qualquer linguagem ou ambiente de execução compatível com MCP via stdio. Veja um exemplo de entrada para um servidor Node.js:

{
  "type": "stdio",
  "command": "node",
  "args": ["${PLUGIN_ROOT}/server/dist/index.js"],
  "cwd": "${PLUGIN_ROOT}"
}

Inclua o servidor e suas dependências no pacote. ${PLUGIN_ROOT} é um marcador de posição predefinido.

Enviar um plugin com um servidor MCP local

1. Encontre o ID da organização responsável pelo envio nas configurações da organização na plataforma da OpenAI.
2. Envie o ID ao seu representante da OpenAI e peça que inclua sua organização na lista de organizações autorizadas a enviar plugins com um servidor MCP local. Aguarde a confirmação antes de enviar o plugin.
3. Abra o portal de envio de plugins, selecione Criar plugin e escolha Somente habilidades. Use Enviar ZIP para carregar o pacote do plugin com a configuração do servidor MCP local.
4. Cumpra os requisitos de envio e envie o plugin para análise. Após a aprovação, publique-o pelo portal.

Plugins sem servidor MCP

Se o plugin contém apenas habilidades e precisa ser executado no desktop, defina requires_local_executor como true em extensions.com.openai no arquivo plugin.json da raiz:

{
  "extensions": {
    "com.openai": {
      "requires_local_executor": true
    }
  }
}

Se o pacote for legado e usar .codex-plugin/plugin.json, adicione "requires_local_executor": true diretamente no nível superior desse manifesto.

Essa opção identifica o plugin com o selo Somente desktop. Siga o fluxo padrão de envio. Se o portal informar que o campo não é permitido, envie ao seu representante da OpenAI o ID da organização responsável pelo envio para confirmar se ela tem permissão de envio.