For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme
Visão geral Documentação para usuários do ChatGPT e do Codex Casos de uso

Diretrizes para plugins

Requisitos para todos os plugins publicados no Diretório do ChatGPT.

Estas diretrizes se aplicam a todos os plugins listados no Diretório do ChatGPT, inclusive aos plugins MCP e aos que contêm apenas habilidades. Os requisitos específicos para servidores MCP, ferramentas e interfaces opcionais se aplicam somente aos plugins que incluem esses componentes. Para conhecer todo o processo de envio, incluindo as habilidades, as etapas no portal, a análise, a aprovação e a publicação, consulte Enviar plugins.

Visão geral

A confiança é a base do ecossistema de plugins. Quem usa o ChatGPT e o Codex espera encontrar experiências seguras e úteis que respeitem sua privacidade. Quem desenvolve plugins espera um processo justo e transparente. Estas diretrizes estabelecem as políticas que todos os desenvolvedores devem ler e seguir.

Você também pode consultar os princípios de uma excelente experiência no ChatGPT.

As diretrizes a seguir estabelecem os requisitos mínimos que um plugin publicado deve cumprir para continuar disponível no diretório comum ao ChatGPT e ao Codex. Plugins que demonstrem grande utilidade na prática e alto grau de satisfação dos usuários podem se qualificar para distribuição mais ampla, como destaque no diretório ou sugestões proativas.

Como usar estas diretrizes

Comece pelos fundamentos dos plugins, que se aplicam a todos os plugins. Em seguida, leia os requisitos de MCP se o plugin incluir servidores MCP, ferramentas ou uma interface opcional, e a seção Habilidades se ele incluir habilidades. Se o plugin incluir tanto ferramentas MCP quanto habilidades, leia as duas seções.

Fundamentos dos plugins

Finalidade e originalidade

Os plugins devem ter uma finalidade clara e cumprir de forma confiável o que prometem. Em especial, devem oferecer funcionalidades ou fluxos de trabalho que os produtos não ofereçam de forma nativa e que ajudem os usuários a realizar o que costumam pedir nas conversas.

Use apenas propriedade intelectual que pertença a você ou para a qual você tenha permissão de uso. Não use designs enganosos ou que imitem outros produtos, não se passe por terceiros, não envie spam nem apresente telas estáticas sem interação significativa. Os plugins não devem sugerir que a OpenAI os criou ou endossa.

Qualidade e confiabilidade

Os plugins devem funcionar de maneira previsível e confiável. Os resultados devem ser precisos e relevantes para o que o usuário informou. Trate os erros, inclusive os inesperados, com mensagens claras ou comportamentos alternativos.

Os plugins devem ser estáveis, responder rapidamente e estar completos. Plugins de avaliação ou demonstração não serão aceitos.

Nome, descrição e prompts do plugin

Os nomes e as descrições dos plugins devem ser claros, precisos e diretos. Forneça exemplos de prompts que ajudem os usuários a começar a usar o plugin.

  • Nomes: Evite nomes genéricos demais, principalmente palavras isoladas de uso comum que não tenham uma relação explícita com sua marca. Não acrescente “MCP”, “Servidor MCP” ou “Plugin” ao nome de uma empresa ou de um produto.
  • Subtítulos e descrições: Descreva a funcionalidade do plugin sem compará-lo a outros produtos, depreciar alternativas ou fazer afirmações que não possam ser verificadas. Não anuncie preços, assinaturas, períodos de teste gratuitos, descontos ou promoções.

Segurança

Políticas de uso

Não pratique nem facilite atividades proibidas pelas políticas de uso da OpenAI. Os plugins devem evitar comportamentos de alto risco que possam expor os usuários a danos, fraudes ou uso indevido.

Acompanhe as mudanças nos requisitos das políticas e mantenha o plugin em conformidade. Plugins já aprovados podem ser removidos se uma violação for identificada posteriormente.

Adequação ao público

Os plugins devem ser adequados ao público geral, inclusive a usuários de 13 a 17 anos. Não é permitido direcionar plugins explicitamente a crianças menores de 13 anos. Experiências para adultos (18+) passarão a ser aceitas quando houver mecanismos adequados de verificação de idade e controle.

Respeito à intenção do usuário

Ofereça experiências que atendam diretamente à solicitação do usuário. Não insira conteúdo sem relação com o pedido nem tente redirecionar a interação. Limite a coleta de dados ao que for razoavelmente necessário para atender à solicitação e estiver de acordo com sua política de privacidade.

Atue apenas no âmbito da tarefa autorizada pelo usuário. Os metadados de plugins e ferramentas não podem tentar obter segredos ou contexto protegido, instruir a execução de ações ou transferências de dados não autorizadas, sobrepor-se às instruções ou proteções da plataforma, ocultar comportamentos ou se passar por terceiros. Codificar ou ofuscar instruções não isenta o plugin desses requisitos.

Concorrência leal

Os plugins não podem incluir, no nível da ferramenta ou do próprio plugin, descrições, títulos, anotações de ferramentas ou outros campos legíveis pelo modelo que manipulem a forma como ele seleciona ou usa outros plugins ou suas ferramentas (por exemplo, instruindo-o a dar preferência a um plugin) ou que prejudiquem a igualdade de condições na descoberta de plugins. Todas as descrições devem apresentar com precisão o valor do plugin sem depreciar alternativas.

Conteúdo e integrações de terceiros

  • Acesso autorizado: Só extraia dados de sites externos de forma automatizada, encaminhe consultas ou faça integrações com APIs de terceiros se tiver a devida autorização e cumprir os termos de serviço do terceiro.
  • Conectores não oficiais: Não podemos aprovar plugins cuja função principal seja atuar como conectores não oficiais de serviços de terceiros, inclusive camadas intermediárias de software que apenas repassam solicitações.
  • Contorno de restrições: Não contorne restrições de API, limites de taxa ou controles de acesso impostos por terceiros.

Privacidade

Política de privacidade

Ao enviar um plugin, inclua uma política de privacidade clara e publicada que explique, no mínimo, as categorias de dados pessoais coletados, as finalidades de uso, as categorias de destinatários, os prazos de retenção dos dados e os controles oferecidos aos usuários. Siga essa política em todos os momentos. Os usuários podem consultá-la antes de instalar o plugin.

Coleta de dados

  • Minimização da coleta: Colete apenas os dados indispensáveis para que o plugin cumpra sua função. As entradas devem ser específicas, ter escopo delimitado e estar explicitamente vinculadas à tarefa. Evite campos incluídos “por precaução” ou dados abrangentes de perfil.
  • Dados restritos: Não colete, solicite nem processe as seguintes categorias de dados restritos:
    • Informações sujeitas ao padrão de segurança de dados do setor de cartões de pagamento (PCI DSS)
    • Informações de saúde protegidas (PHI)
    • Identificadores governamentais (como números de seguridade social)
    • Credenciais de acesso e segredos de autenticação (como chaves de API, códigos de MFA/OTP ou senhas).
  • Dados sensíveis regulamentados: Não colete dados pessoais considerados “sensíveis” ou de “categoria especial” na jurisdição em que a coleta ocorre, a menos que todas as condições a seguir sejam atendidas: a coleta é estritamente necessária para a função declarada do plugin, o usuário deu consentimento válido nos termos da lei e tanto a coleta quanto o uso são informados de maneira explícita e destacada antes ou no momento da coleta.

Transparência e controle pelo usuário

  • Práticas de tratamento de dados: Não realize vigilância, rastreamento ou criação de perfis comportamentais, inclusive por meio da coleta de metadados como registros de data e hora, endereços IP ou padrões de consulta, a menos que essas práticas sejam informadas explicitamente, tenham escopo delimitado, estejam sujeitas a controle efetivo pelo usuário e respeitem as políticas de uso da OpenAI.

Comércio e monetização

Atualmente, os plugins só podem comercializar bens físicos. É proibida a venda direta ou indireta de produtos ou serviços digitais, inclusive assinaturas, conteúdo digital, tokens ou créditos (por exemplo, por meio de ofertas de upgrade em um modelo freemium).

Os usuários podem entrar em uma conta paga existente e acessar recursos já incluídos na assinatura. Os plugins não podem exibir planos de assinatura, iniciar novas assinaturas nem promover upgrades.

Se um recurso do plugin exigir um plano ou direito de acesso diferente do que o usuário tem (por exemplo, outro nível de assinatura ou créditos adicionais), o plugin pode explicar esse requisito. A informação deve ajudar o usuário a entender por que o recurso está indisponível, sem iniciar um fluxo de checkout ou outra transação.

Especificamente, os plugins podem:

  • Explicar que determinado recurso não está disponível no plano atual do usuário ou com os direitos de acesso que ele possui.
  • Incluir um link para uma página informativa que descreva os planos ou as opções de acesso disponíveis.

Os plugins não podem:

  • Incluir um link direto para uma página de checkout ou outra página de transação.
  • Incluir um link para uma página que inicie explicitamente o processo de upgrade, assinatura ou conclusão de uma compra.

Os plugins devem oferecer uma experiência de alta qualidade no ChatGPT. Se o mesmo recurso também estiver disponível no seu site ou aplicativo externo, você não pode oferecer uma versão inferior pelo plugin. Os plugins não podem cobrar taxas ou acréscimos específicos do ChatGPT nem adotar preços que penalizem quem acessa um serviço pelo ChatGPT. São permitidos descontos temporários e ofertas promocionais em outras plataformas.

Além disso, os plugins não podem ser usados para vender, promover, facilitar ou viabilizar de forma relevante a oferta dos seguintes bens ou serviços:

Bens proibidos

  • Conteúdo adulto e serviços sexuais
    • Pornografia, mídia sexualmente explícita, serviços adultos de câmera ao vivo, assinaturas de conteúdo adulto
    • Brinquedos sexuais, bonecas sexuais, equipamentos de BDSM, produtos de fetiche
  • Jogos de azar
    • Serviços de jogos de azar com dinheiro real, créditos de cassino, apostas esportivas, tokens de cassinos de criptomoedas
  • Drogas ilegais ou regulamentadas
    • Produtos de maconha ou THC, psilocibina, substâncias ilegais
    • Produtos de CBD com teor de THC acima do limite legal
  • Acessórios para uso de drogas
    • Cachimbos de água, dispositivos para vaporizar concentrados de cannabis, balanças para pesar drogas, equipamentos de cultivo de cannabis comercializados para a produção de drogas
  • Medicamentos sujeitos a prescrição ou restrição de idade
    • Medicamentos vendidos apenas com receita (por exemplo, insulina, antibióticos, Ozempic, opioides)
    • Produtos sujeitos a prescrição e restrição de idade (por exemplo, testosterona, hormônio do crescimento humano, hormônios para fertilidade)
  • Mercadorias ilícitas
    • Produtos falsificados ou réplicas
    • Mercadorias roubadas ou itens sem procedência clara
    • Ferramentas para fraude financeira (dispositivos de clonagem de cartões, terminais de pagamento falsos)
    • Ferramentas de pirataria ou software com proteção violada
    • Contrabando de fauna ou de recursos naturais (marfim, produtos derivados de espécies ameaçadas)
  • Malware, spyware e vigilância
    • Malware, ransomware, programas que registram teclas digitadas, software de perseguição digital
    • Dispositivos de vigilância clandestina (câmeras espiãs, interceptadores de IMSI, rastreadores ocultos)
  • Tabaco e nicotina
    • Produtos de tabaco
    • Produtos de nicotina (cigarros eletrônicos, líquidos para cigarros eletrônicos, sachês de nicotina)
  • Armas e materiais perigosos
    • Armas de fogo, munições, peças de armas de fogo
    • Explosivos, fogos de artifício, materiais para fabricar bombas
    • Armas ilegais ou sujeitas a restrição de idade (canivetes automáticos, socos-ingleses, bestas onde forem proibidas)
    • Armas de defesa pessoal (spray de pimenta, armas de choque, tasers)
    • Mercadorias ou propaganda de caráter extremista

Serviços fraudulentos, enganosos ou de alto risco proibidos

  • Documentos de identidade falsos, documentos forjados ou serviços de falsificação de documentos
  • Esquemas de renegociação de dívidas, recuperação de crédito ou manipulação da pontuação de crédito
  • Serviços financeiros não regulamentados, enganosos ou abusivos
  • Esquemas de empréstimo, cobrança de taxas antecipadas ou construção de histórico de crédito destinados a explorar usuários
  • Ofertas de criptomoedas ou NFTs que envolvam especulação, práticas enganosas contra consumidores ou abuso financeiro
  • Execução de transferências de dinheiro ou criptomoedas ou de operações de investimento
  • Uso abusivo de serviços governamentais, falsa identidade ou manipulação de benefícios
  • Roubo de identidade, uso de identidade alheia ou serviços de monitoramento de identidade que viabilizem uso indevido
  • Determinados serviços jurídicos ou de natureza semelhante que facilitem fraude, evasão ou declarações falsas
  • Esquemas de cobrança que presumam a aceitação na ausência de recusa, esquemas de telemarketing ou de contorno do consentimento
  • Serviços de viagem com alta incidência de estornos, propensos a fraudes ou abusivos

Checkout

Use checkout externo e direcione os usuários ao domínio que você controla para que concluam as compras.

O Checkout Instantâneo está em fase beta e, por enquanto, está disponível apenas para parceiros selecionados de marketplaces. Com o tempo, ele poderá ser disponibilizado para outros marketplaces e varejistas.

Até lá, é obrigatório usar o checkout externo padrão. Nenhuma outra solução de checkout de terceiros pode ser incorporada ou hospedada na interface do plugin. Para saber mais, consulte nossa documentação sobre comércio com agentes de IA.

Publicidade

Os plugins não podem exibir anúncios nem ter a publicidade como finalidade principal. Todo plugin deve oferecer uma funcionalidade clara e legítima que, por si só, seja útil aos usuários.

Verificação de desenvolvedores

Verificação

Todos os plugins devem ser enviados por pessoas ou organizações verificadas. Nas configurações gerais do painel da plataforma OpenAI, você pode confirmar sua identidade e seu vínculo com qualquer empresa em nome da qual deseje publicar. Declarações falsas, comportamentos ocultos ou tentativas de burlar o sistema podem resultar em exclusão do programa.

Dados de contato do suporte

Forneça dados de contato para que os usuários finais possam pedir ajuda ao suporte ao cliente. Mantenha essas informações corretas e atualizadas.

Requisitos de MCP

Estes requisitos se aplicam a plugins que incluem servidores MCP, ferramentas ou uma interface opcional.

Ferramentas

As ferramentas MCP indicam ao ChatGPT e ao Codex como usar os recursos do seu servidor. Definições claras e precisas tornam o plugin mais seguro, facilitam a compreensão pelo modelo e ajudam os usuários a confiar nele.

Nomes de ferramentas claros e precisos

Os nomes das ferramentas devem ser compreensíveis para as pessoas, específicos e descrever o que a ferramenta realmente faz.

  • Cada ferramenta deve ter um nome único no seu servidor MCP.
  • Use linguagem simples que expresse diretamente a ação, de preferência com um verbo (por exemplo, get_order_status).
  • Evite termos enganosos, excessivamente promocionais ou comparativos (por exemplo, pick_me, best, official).
  • Evite jargão interno, siglas sem explicação e identificadores difíceis de interpretar.

Descrições que correspondem ao comportamento

Cada ferramenta deve ter uma descrição preenchida que explique de forma explícita e precisa sua finalidade, como ela funciona, quando usá-la e quais são suas limitações ou efeitos colaterais relevantes. A descrição deve corresponder ao schema e ao comportamento real da ferramenta. Se a descrição deixar dúvidas sobre como a ferramenta funciona ou não explicar seu comportamento por completo, o plugin poderá ser rejeitado.

As descrições não podem favorecer nem depreciar outros plugins ou serviços, nem tentar induzir o modelo a escolher as ferramentas descritas em vez das ferramentas de outro plugin. Também não podem recomendar que a ferramenta seja acionada em situações que extrapolem a intenção explícita do usuário e a finalidade do plugin.

Independência e exposição das ferramentas

Cada ferramenta pública deve funcionar de forma independente. Não instrua o modelo a acionar outro plugin ou conector para concluir a operação. Implemente as dependências necessárias no próprio plugin.

Exponha cada operação que o modelo pode chamar como uma ferramenta separada, com descrição clara, schema de entrada e anotações. Não combine descoberta, seleção de operações ou busca de schemas com um executor genérico para viabilizar operações que não tenham sido expostas individualmente para análise.

Anotações corretas

Atribua a readOnlyHint, destructiveHint e openWorldHint valores booleanos explícitos (true ou false) no objeto annotations de cada ferramenta. Não é mais necessário justificar as anotações. Se a análise automatizada identificar um problema em uma anotação, você poderá recorrer e fornecer esclarecimentos ou informações adicionais.

  • readOnlyHint: Use true para consultas, cálculos ou prévias que não modifiquem o ambiente. Use false para alterar o estado externo, persistir artefatos, iniciar tarefas ou fluxos de trabalho que mantenham estado, colocar tarefas em filas ou executar ações de escrita em sistemas externos, como publicar mensagens, enviar e-mails ou fazer upload de arquivos.
  • destructiveHint: Use false para ferramentas somente leitura. Em operações de escrita, use true quando houver efeitos potencialmente destrutivos ou irreversíveis, como exclusão, sobrescrita, cancelamento, revogação de acesso ou envios ou transações irreversíveis. Use false apenas para operações de escrita que acrescentem dados sem efeitos destrutivos ou irreversíveis. A possibilidade de desfazer uma ação não justifica, por si só, definir destructiveHint como false.
  • openWorldHint: Use true para entidades públicas ou sem escopo predefinido, inclusive em pesquisas na Web somente leitura e operações com destinos arbitrários. Uma ferramenta restrita a uma conta privada, um espaço de trabalho ou um catálogo de escopo delimitado pode usar false, mesmo que tenha hospedagem externa. A conectividade por si só não determina esse valor.

As anotações orientam os mecanismos de proteção do cliente. Elas não concedem permissões nem substituem a autenticação, as verificações de autorização e escopo, a validação de entradas ou a confirmação humana para operações irreversíveis.

Entradas mínimas e alinhadas à finalidade

As ferramentas devem solicitar apenas as informações necessárias para concluir a tarefa.

  • Os campos de entrada devem estar diretamente relacionados à finalidade declarada da ferramenta.
  • Não solicite o histórico completo da conversa, transcrições brutas de chats ou campos de contexto abrangentes “por precaução”. A ferramenta só pode solicitar um campo breve que descreva a intenção do usuário para aquela tarefa se isso melhorar de forma significativa a execução e não ampliar a coleta de dados além do que for razoavelmente necessário para atender à solicitação do usuário e às finalidades descritas na sua política de privacidade.
  • Não solicite o contexto acumulado da conversa nem arrays de turnos anteriores.
  • Se necessário, use a localização geográfica aproximada compartilhada pelo sistema. Não solicite dados de localização precisos do usuário (por exemplo, coordenadas de GPS ou endereços).

Comportamento previsível e auditável

As ferramentas devem se comportar exatamente como indicam seus nomes, descrições e entradas.

  • Os efeitos colaterais nunca devem ficar ocultos ou implícitos.
  • Sempre que possível, deve ser seguro repetir uma chamada à ferramenta. Caso contrário, indique explicitamente quando uma nova tentativa puder repetir seus efeitos.

Ferramentas bem projetadas ajudam a evitar surpresas, proteger os usuários e agilizar a análise.

Tratamento de dados pelas ferramentas

Projete o schema de entrada para limitar a coleta de dados por padrão. Evite usá-lo para acumular contexto opcional.

  • Minimização da resposta: As ferramentas devem retornar apenas dados diretamente relevantes para a solicitação do usuário e a finalidade declarada da ferramenta. Não inclua informações de diagnóstico, telemetria ou identificadores internos, como IDs de sessão, rastreamento ou solicitação, registros de data e hora ou metadados de logs, a menos que sejam estritamente necessários para atender à consulta do usuário.
  • Limites de acesso aos dados:
    • Evite solicitar dados brutos de localização (por exemplo, cidade ou coordenadas) no schema de entrada. Quando a localização for necessária, obtenha-a por um canal separado controlado pelo cliente (como metadados do ambiente ou um recurso referenciado), para permitir a aplicação das políticas e dos controles de consentimento adequados. Isso reduz a coleta acidental de informações de identificação pessoal, garante o acesso com o mínimo de privilégios e permite auditar o tratamento dos dados de localização e revogar o acesso a eles.
    • Seu servidor MCP não pode obter, reconstruir ou inferir o registro completo do chat a partir do cliente ou de outra fonte. Trabalhe apenas com os trechos e recursos que o cliente ou o modelo escolher explicitamente enviar. Essa separação pode ajudar a impedir que o volume de dados seja ampliado de forma oculta e a limitar a análise ao conteúdo compartilhado intencionalmente.
  • Proteções para ações: Siga as orientações sobre anotações corretas para identificar operações de escrita e ações destrutivas, obter confirmações e proteger os dados enviados.

Autenticação e permissões

Se o seu servidor MCP exigir autenticação, o fluxo deve ser transparente e explícito. Informe aos usuários todas as permissões solicitadas e peça apenas as necessárias para o funcionamento do plugin.

Interface do usuário

Antes de examinar os detalhes, consulte as diretrizes para interfaces opcionais. Elas apresentam padrões de interação, layout e design que ajudam a tornar a interface do plugin intuitiva, confiável e consistente com o ChatGPT.

Iframes e páginas incorporadas

Plugins com interface podem incorporar páginas do próprio domínio registrável do servidor MCP, inclusive editores completos e interfaces administrativas existentes. Por exemplo, um servidor em https://api.example.com/mcp pode incorporar https://app.example.com, pois ambos usam o domínio registrável example.com. Em um serviço de hospedagem compartilhada, ambientes de clientes distintos contam como domínios diferentes. Usar o mesmo provedor de hospedagem não comprova a titularidade do domínio.

Declare cada origem de iframe necessária na CSP do recurso usando _meta.ui.csp.frameDomains (ou a propriedade legada _meta["openai/widgetCSP"].frame_domains). No caso de domínios de terceiros, limite a incorporação por iframe aos casos em que a experiência incorporada for essencial.

Ao enviar um plugin que usa iframes, continua sendo obrigatório apresentar uma justificativa. Explique o que cada página incorporada faz, por que o plugin a incorpora e quem controla seu domínio. O uso de iframes pode exigir análise adicional ou encaminhamento a outra instância de avaliação. A aprovação pode demorar mais, e o plugin pode ser rejeitado se não for possível avaliar o conteúdo. Compartilhar o domínio do servidor MCP não garante a aprovação.

Todos os demais requisitos para plugins também se aplicam às páginas incorporadas, inclusive os de checkout e de privacidade.

Testes

Antes de enviar um plugin, teste minuciosamente o servidor MCP, as ferramentas e a interface opcional em uma ampla variedade de cenários.

Os plugins e todos os seus componentes de interface devem funcionar de forma confiável no ChatGPT, tanto em computadores quanto em dispositivos móveis.

Credenciais de teste

Ao enviar um plugin com um servidor MCP que exige autenticação, forneça login e senha de uma conta de demonstração com todos os recursos e dados de exemplo. Plugins que exigirem etapas adicionais de login, como criar uma nova conta ou usar autenticação de dois fatores por meio de uma conta inacessível, serão rejeitados.

Habilidades

As habilidades passam por verificação automática e devem cumprir nossas políticas de segurança, privacidade e uso. Plugins que contêm apenas habilidades devem atender a todos os requisitos de metadados e listagem descritos acima. Esses plugins podem estar sujeitos a requisitos adicionais de elegibilidade para inclusão no Diretório.