Requisitos de revisão para servidores MCP remotos

Prepare um servidor MCP remoto e sua interface opcional para revisão pública como parte de um plugin.

Prepare os recursos do servidor MCP remoto para enviar o plugin

Consulte nesta página os requisitos que se aplicam a plugins com servidor MCP remoto. Eles abrangem a verificação da organização, as permissões de gerenciamento, os requisitos do servidor, as cópias dos metadados usadas na revisão e a manutenção das versões.

Quando o servidor MCP remoto estiver funcionando no ChatGPT, envie-o para revisão pelo portal de envio de plugins. Esta página descreve os requisitos aos quais o servidor MCP remoto e a interface opcional devem atender para esse envio.

Só envie o plugin se quiser disponibilizá-lo ao público nos países que você indicar durante o envio. Para uso privado ou restrito a um espaço de trabalho, use uma conexão personalizada com um servidor MCP.

Antes de enviar o plugin, consulte as diretrizes para plugins para saber o que se espera do servidor MCP e da interface opcional. Em Enviar plugins, você encontra o processo completo de envio, aprovação e publicação.

Para conhecer todas as etapas de envio, revisão, aprovação e publicação, tanto para plugins compostos apenas por habilidades quanto para os que usam MCP, consulte Enviar plugins.

Antes de enviar o plugin

Verificação da organização

Antes de enviar qualquer plugin, conclua a verificação de identidade no painel da plataforma OpenAI para o nome que você pretende usar como responsável pela publicação no diretório.

• Se quiser publicar em seu próprio nome, conclua a verificação de pessoa física.
• Se quiser publicar em nome de uma empresa, conclua a verificação da empresa.

A equipe verifica esse requisito durante a revisão. Se o nome da pessoa ou da empresa responsável pela publicação não tiver sido verificado, o envio será rejeitado.

Permissões para enviar plugins

Para criar rascunhos de plugins e enviá-los para revisão, você precisa da permissão api.apps.write. Para consultar os rascunhos e o status da revisão no painel, você precisa da permissão api.apps.read. Os proprietários da organização recebem as duas permissões automaticamente e podem concedê-las aos demais membros por meio de funções no painel da plataforma OpenAI.

Requisitos do servidor MCP remoto

• Hospede o servidor MCP em um domínio acessível ao público.
• Não use um endpoint local ou de teste.
• Se o servidor retornar uma interface, defina uma política de segurança de conteúdo (CSP) que permita exatamente os domínios dos quais o componente busca recursos.

Modelos de URL do servidor MCP

Para a maioria dos plugins, informe uma URL universal do servidor MCP, ou seja, um único endpoint MCP hospedado que funcione para todos os usuários e organizações. Selecione Modelo somente se o plugin usar URLs de servidor MCP específicas para cada espaço de trabalho. Isso ocorre, por exemplo, quando cada cliente tem seu próprio tenant, espaço de trabalho ou endpoint MCP gerenciado. Só oferecemos suporte a URLs baseadas em modelos para desenvolvedores de confiança com quem já temos uma relação estabelecida.

Para enviar um plugin usando um modelo, preencha os dois campos de URL:

• URL de exemplo do servidor MCP: um endpoint MCP real e funcional para a revisão e as verificações automatizadas.
• Modelo de URL do servidor MCP: o padrão de URL que indica qual parte do endpoint MCP varia entre os espaços de trabalho dos clientes.

A URL de exemplo do servidor MCP deve apontar para um endpoint real ao qual a OpenAI possa se conectar durante a revisão do envio. Não insira uma URL fictícia no campo URL de exemplo do servidor MCP.

No Modelo de URL do servidor MCP, use marcadores de posição para as partes que o administrador do espaço de trabalho configurará depois. Os marcadores devem usar a sintaxe {name}. Cada nome deve começar com uma letra, conter apenas letras, números ou sublinhados e ser único.

Verifique se a URL de exemplo do servidor MCP corresponde ao padrão do modelo após a substituição de cada marcador por um valor real.

Por exemplo:

Example MCP Server URL: https://acme.example.com/mcp
Template MCP Server URL: https://{workspace}.example.com/mcp

Envie o plugin para revisão

Quando o plugin atender aos pré-requisitos, você poderá enviá-lo para revisão pelo portal de envio de plugins.

Inicie o processo de revisão

No portal de envio de plugins:

1. Insira os dados do servidor MCP e, se tiver selecionado OAuth, as credenciais OAuth. Em seguida, selecione Verificar ferramentas.
2. Preencha os campos obrigatórios do formulário de envio e marque todas as caixas de confirmação. Informe o nome, o logotipo e a descrição do plugin, as URLs do site da empresa e da política de privacidade, os dados do servidor MCP e das ferramentas, os prompts e as respostas de teste e as informações de localização.
3. Selecione Enviar para revisão.

Metadados armazenados durante a verificação das ferramentas

Quando você seleciona Verificar ferramentas, o painel importa para o rascunho os metadados que o endpoint MCP disponibiliza. Eles incluem nomes, títulos e descrições das ferramentas, schemas de entrada e saída, esquemas de segurança, campos _meta, anotações das ferramentas, metadados dos recursos de interface vinculados (incluindo as configurações de CSP) e as instructions do servidor MCP. O painel exibe os valores das anotações fornecidos pelo servidor.

Nas justificativas do envio, explique por que os valores das anotações fornecidos pelo servidor correspondem ao comportamento de cada ferramenta. As justificativas não alteram as anotações. Por exemplo, se o servidor informar readOnlyHint: false, descrever a ferramenta como “na prática, somente leitura” na justificativa não a torna uma ferramenta somente leitura. Se ela realmente for somente leitura, atualize a anotação no servidor para readOnlyHint: true, implante a alteração, selecione Verificar ferramentas novamente, confira o valor atualizado e envie o plugin.

Cada organização pode publicar vários plugins distintos com MCP. Para cada integração com um servidor MCP, só pode haver uma versão publicada por vez e uma versão em revisão por vez. Se precisar fazer alterações após o envio, selecione Cancelar revisão para retirar o envio e reenvie o rascunho da mesma versão.

No momento, projetos com residência de dados na União Europeia não podem enviar plugins com servidores MCP para revisão. Use um projeto com residência de dados global. Se não tiver um, crie um projeto na sua organização atual pelo painel da OpenAI.

Revisão e aprovação

Após o envio, o plugin entra na fila de revisão. Você pode acompanhar o status pelo painel e receberá uma notificação por e-mail sempre que ele mudar.

Revisões e verificações

Podemos executar verificações automatizadas ou revisões manuais para entender como o plugin funciona e se ele pode entrar em conflito com nossas políticas.

Aprovação, rejeição e recursos

Se aprovarmos o plugin, enviaremos uma notificação por e-mail. Após a aprovação, você poderá publicá-lo pelo portal de envio de plugins.

Se o plugin for rejeitado ou removido por causa do servidor MCP, das ferramentas ou da interface, você receberá informações sobre as verificações em que ele não passou. Após fazer as alterações necessárias, você poderá reenviá-lo para revisão. Para recorrer da decisão, responda ao e-mail recebido com uma justificativa clara e quaisquer informações novas que possam ajudar na revisão.

Como obter ajuda

Se tiver dúvidas antes, durante ou depois do envio e não encontrar a resposta na documentação, entre em contato com o suporte da OpenAI. Inclua o ID exibido no portal de envio de plugins para que a equipe de suporte possa identificar seu plugin.

Perguntas frequentes sobre revisão e aprovação

Quanto tempo leva a revisão?

Os prazos de revisão podem variar à medida que desenvolvemos e ampliamos nossos processos. Não entre em contato com o suporte para pedir prioridade na revisão, pois não podemos atender a esses pedidos.

Quais são os motivos mais comuns de rejeição e como posso resolvê-los?

• Não conseguimos nos conectar ao servidor MCP com a URL do MCP e/ou as credenciais de teste fornecidas.
  • Se o servidor exigir autenticação, nossa equipe de revisão precisa conseguir entrar em uma conta de demonstração sem fazer nenhuma configuração adicional.
  • Verifique se a URL e as credenciais estão corretas e se o acesso dispensa MFA. A entrada na conta não deve exigir códigos por SMS nem depender de sistemas que exijam verificação por SMS, e-mail ou outros meios.
  • Confirme que é possível entrar com as credenciais fornecidas. Teste-as fora de redes corporativas, redes locais ou outras redes internas.
  • Confirme que as credenciais não expiraram.
• Um ou mais casos de teste produziram resultados incorretos.
  • Revise todos os casos de teste com atenção e execute cada um novamente. Confira se as saídas correspondem aos resultados esperados. Se houver interface, verifique se ela funciona sem erros, inclusive ao carregar conteúdo e imagens.
  • Verifique se o texto retornado atende ao que o usuário pediu, sem incluir informações irrelevantes, como identificadores pessoais que não sejam pertinentes à solicitação.
  • Verifique se todos os casos de teste passam nas interfaces compatíveis do ChatGPT e do Codex em que o plugin estará disponível.
  • Compare as saídas reais com o comportamento esperado, definido com precisão para cada ferramenta. Corrija as divergências para que os resultados sejam pertinentes ao que o usuário informou e o plugin cumpra sua função de maneira consistente.
  • Se necessário, ao reenviar o plugin, ajuste os casos de teste e as respostas esperadas para que sejam claros e não deixem margem a dúvidas.
• O plugin retorna tipos de dados sobre usuários que não constam na sua política de privacidade.
  • Audite as respostas das ferramentas MCP no ChatGPT. Faça algumas solicitações realistas e liste todos os campos relacionados ao usuário que o servidor retorna, incluindo campos aninhados e dados de “depuração”. Verifique se as ferramentas retornam apenas o estritamente necessário para atender ao pedido do usuário. Remova informações de identificação pessoal, dados de telemetria e identificadores internos desnecessários (por exemplo, IDs de sessão, rastreamento ou solicitação, registros de data e hora, IDs internos de conta ou logs). Remova também quaisquer segredos de autenticação, como tokens, chaves ou senhas.
  • Considere também atualizar a política de privacidade publicada para que ela descreva explicitamente todas as categorias de dados pessoais que você coleta, processa ou retorna e por quê. Se um campo não for realmente necessário, remova-o em vez de apenas incluí-lo na política.
  • Se um identificador de usuário for realmente necessário, faça com que a ferramenta só o retorne quando o usuário o solicitar explicitamente e ele estiver diretamente ligado à intenção do usuário. Evite “buscar e devolver” o identificador por padrão.
• As anotações que indicam o comportamento da ferramenta parecem não corresponder ao que ela faz:
  • readOnlyHint: defina como true se a ferramenta apenas buscar, consultar, listar ou recuperar dados, sem modificar nada. Defina como false se ela puder criar, atualizar ou excluir algo, disparar ações (enviar e-mails ou mensagens, executar jobs, colocar tarefas em uma fila, gravar logs ou iniciar fluxos de trabalho) ou alterar o estado de alguma outra forma.
  • Indicação de ação destrutiva: defina a anotação de ação destrutiva como true se a ferramenta puder produzir efeitos irreversíveis, como excluir ou sobrescrever dados, enviar mensagens ou transações que não possam ser desfeitas, revogar acesso ou executar ações administrativas destrutivas. Isso vale mesmo que esses efeitos ocorram apenas em determinados modos, com parâmetros padrão ou como efeitos colaterais indiretos. Explique na justificativa o que é irreversível e em quais condições. Inclua as salvaguardas, como etapas de confirmação, opções de simulação ou limites de escopo. Caso contrário, defina a anotação como false.
  • openWorldHint: defina como true se a ferramenta acessar a internet pública ou interagir com entidades externas sem um escopo delimitado. Isso inclui ferramentas somente leitura, como as de pesquisa na Web, e ferramentas de escrita que postam em plataformas públicas, enviam mensagens a destinatários externos, publicam conteúdo, enviam código a repositórios ou enviam formulários. Defina como false se a ferramenta estiver restrita ao escopo de uma conta privada ou de um espaço de trabalho, mesmo que o serviço esteja hospedado externamente.

Publicação e distribuição

Publique o plugin

Após a aprovação do plugin, você poderá publicá-lo pelo portal de envio de plugins. Para isso, selecione Publicar.

Como os usuários encontram o plugin

Depois da publicação, os usuários podem encontrar o plugin no diretório universal compartilhado pelo ChatGPT e pelo Codex das seguintes maneiras:

• Acessando a página do plugin no diretório por um link direto.
• Pesquisando o plugin pelo nome.

Plugins que se mostram muito úteis na prática e alcançam um alto nível de satisfação entre os usuários podem se qualificar para distribuição ampliada, com destaque no diretório ou sugestões proativas, por exemplo. Poucos plugins recebem distribuição ampliada no momento da publicação. Os desenvolvedores não podem solicitar essa modalidade de distribuição.

Perguntas frequentes sobre publicação e distribuição

O que acontece após a aprovação? O plugin aparece automaticamente no diretório?

Após a aprovação, você pode optar por publicar o plugin pelo portal de envio de plugins. É preciso publicá-lo para que ele possa aparecer no diretório universal de plugins.

Por que não vejo meu plugin no diretório?

Os plugins só aparecem nas páginas principais do diretório quando a OpenAI os seleciona para distribuição ampliada. Para confirmar que seu plugin foi publicado, pesquise pelo nome exato usado na publicação ou abra a URL da página dele no diretório pelo portal de envio de plugins.

O que devo fazer se quiser divulgar um comunicado à imprensa ou fazer um anúncio público sobre meu plugin?

Antes de divulgar qualquer comunicado à imprensa ou fazer um anúncio público sobre o lançamento do plugin, escreva para press@openai.com para coordenar a divulgação com nossa equipe de comunicação.

Manutenção contínua

Como funcionam as versões publicadas dos metadados do MCP

Trate os metadados expostos pelo servidor MCP como um contrato de API com controle de versão para o plugin. Quando você verifica o endpoint MCP no portal de envio de plugins, a OpenAI armazena os metadados encontrados junto com a versão em rascunho. Ao enviar a versão, você encaminha essa cópia dos metadados para revisão. Após a publicação, a revisão contínua atualiza as definições das ferramentas sem exigir uma nova versão do plugin. As chamadas de ferramentas e os recursos da interface continuam a usar o servidor MCP em produção.

Revisão contínua e atualizações das ferramentas

Periodicamente, a OpenAI consulta as ferramentas do servidor MCP e as compara com as definições publicadas, incluindo descrições, schemas e anotações.

• Ferramentas excluídas: saem da lista de ferramentas publicadas assim que uma varredura detecta a exclusão, sem esperar pelas verificações automatizadas.
• Ferramentas novas: ficam disponíveis aos usuários somente depois de passar nas verificações automatizadas.
• Ferramentas alteradas: a definição anterior continua em uso até que a definição atualizada passe nas verificações automatizadas ou uma varredura detecte que você removeu a ferramenta. As atualizações aprovadas substituem a definição anterior automaticamente.

Cada ferramenta pode passar nas verificações de forma independente. Por exemplo, você adiciona create_note, altera search para aceitar o parâmetro folder e exclui archive_note. A próxima varredura remove archive_note imediatamente. Se create_note passar, mas a atualização de search ficar pendente, os usuários terão acesso a create_note e continuarão usando a definição anterior de search, sem folder.

Mantenha o servidor compatível com a definição em produção enquanto a atualização estiver pendente. A OpenAI mantém a definição da ferramenta, mas não armazena uma cópia da implementação do servidor. Uma verificação incompleta não aprova a atualização, mesmo que não tenha identificado problemas.

Outras alterações

Consulte a tabela para saber como disponibilizar cada alteração:

As alterações no servidor entram em vigor antes que uma varredura possa detectá-las ou aprová-las. Nesse intervalo, mantenha em funcionamento os schemas de entrada existentes e cada URI publicado de recurso de interface. Se uma implantação violar o contrato em produção, reverta a alteração no servidor sem esperar pela revisão.

Envio de novas versões para revisão

Para alterar as informações enviadas sobre o plugin ou as habilidades importadas, crie um rascunho de uma nova versão do plugin existente e envie-o para revisão. A revisão contínua das ferramentas não substitui esse processo. Cada reenvio inicia uma nova revisão. Descreva as alterações nas notas da versão.

A origem do servidor MCP (scheme, hostname ou port) não pode mudar de uma versão para outra. Para usar outra origem, envie um novo plugin com a nova origem do servidor MCP. Você pode alterar o caminho do endpoint em uma nova versão do plugin existente.

Revisaremos novamente os metadados atualizados do plugin e informaremos por e-mail e pelo portal de envio de plugins se a atualização foi aprovada ou rejeitada. Em caso de rejeição, você poderá fazer ajustes e reenviar a versão ou recorrer da decisão.

Após a aprovação da versão reenviada, você poderá publicar a atualização, que substituirá a versão anterior do plugin.

Se fizer outras alterações no plugin entre o envio e a aprovação e quiser enviar uma nova versão para revisão, cancele a revisão pelo portal de envio de plugins e faça um novo envio.

Substituição de versões publicadas dos metadados e remoção do plugin

Para substituir uma versão publicada do plugin, publique a versão aprovada que vai substituí-la diretamente pelo portal de envio de plugins. Mantenha a versão atual publicada enquanto a nova estiver em revisão. A publicação da versão aprovada substitui a atual, sem que você precise retirar a versão atual de circulação antes.

Retire a versão atual de circulação somente se quiser remover o acesso público ao plugin. Sem outra versão publicada para substituí-la, o plugin ficará indisponível.

Para remover o plugin da organização, do ChatGPT e do Codex, exclua-o pelo portal de envio de plugins.

Requisitos de manutenção

Plugins inativos, instáveis ou que não atendam aos requisitos podem ser removidos. Podemos rejeitar ou remover qualquer plugin de nossos serviços a qualquer momento, por qualquer motivo e sem aviso prévio, inclusive por questões legais, problemas de segurança ou violações de políticas.

Perguntas frequentes sobre manutenção contínua

O que acontece se os usuários denunciarem meu plugin como prejudicial ou enganoso?

A OpenAI analisa as denúncias dos usuários e pode revisar ou investigar o plugin, incluindo o servidor MCP, as ferramentas e a interface. Plugins que violem nossas políticas podem sofrer restrições ou ser removidos. Você pode contestar uma remoção ou outra medida de aplicação das políticas seguindo o processo de recurso descrito nesta página. Analise o feedback regularmente, responda aos comentários e atualize o plugin se identificar problemas.

Quanto tempo leva a revisão das atualizações?

Assim como nas revisões iniciais, não podemos estimar quanto tempo levará a revisão de uma atualização.