Conecte e teste seu plugin

Teste cada recurso separadamente antes de testar o plugin completo após a instalação. Se o plugin incluir um servidor MCP, comece conectando o servidor ao ChatGPT e avaliando seu funcionamento. Em seguida, empacote o plugin com suas habilidades e teste a experiência completa. Se o plugin contiver apenas habilidades, você pode pular a primeira seção.

Guarde os prompts de avaliação e os resultados ao longo do desenvolvimento para comparar o comportamento entre versões.

Teste um servidor MCP (opcional)

Prepare o endpoint

Confirme que:

• É possível acessar o servidor MCP por um endpoint HTTPS público ou pelo túnel MCP seguro.
• Se você usa um endpoint público, ele aceita HTTP com streaming, normalmente em /mcp. Se usa um túnel, ele consegue acessar o servidor MCP configurado para usar stdio ou HTTP.
• As ferramentas têm nomes, descrições, schemas e anotações.
• A descoberta dos métodos de autenticação funciona para as ferramentas que exigem uma conta.

Use o túnel MCP seguro para conectar um servidor MCP privado ao ChatGPT sem expor o servidor à internet pública. Um túnel de desenvolvimento ou outro serviço de encaminhamento HTTPS também pode fornecer um endpoint para testes locais. Essas opções de teste não substituem o endpoint HTTPS público exigido para o envio do plugin.

Inspecione o servidor MCP

Use o MCP Inspector para listar e chamar as ferramentas diretamente:

npx @modelcontextprotocol/inspector@latest

Teste cada ferramenta com entradas representativas, casos extremos, identificadores ausentes e situações que gerem resultados vazios. Verifique a validação dos schemas, os erros de autenticação, as anotações, o comportamento da ferramenta quanto à confirmação e o resultado que o modelo consegue ler.

Adicione o servidor MCP

As políticas da conta e do espaço de trabalho se aplicam à adição e ao uso de servidores MCP personalizados.

1. Acesse Plug-ins do ChatGPT.
2. Selecione o botão com o sinal de mais e depois Adicionar servidor MCP personalizado.
3. Insira um nome e uma descrição para exibir aos usuários.
4. Em Conexão, escolha o método de conexão:
   • Para um endpoint público, insira a URL do servidor MCP, incluindo o caminho /mcp.
   • Para usar o túnel MCP seguro, selecione Túnel e escolha um túnel disponível ou insira o tunnel_id dele.
5. Configure a autenticação, leia o aviso de risco e selecione Entendo e quero continuar.
6. Selecione Criar como plugin.
7. Confira as ferramentas e os metadados que o ChatGPT identificou no servidor.

Se o ChatGPT não conseguir se conectar, verifique o endpoint HTTPS público com o MCP Inspector ou confira a qual espaço de trabalho o túnel está associado e verifique o status do tunnel-client. Resolva os erros de transporte, inicialização, schema ou autenticação antes de continuar.

Verifique a seleção de ferramentas

Instale o plugin criado e inicie uma nova conversa. Digite @ no campo de mensagem e selecione o plugin. Monte um conjunto de testes que inclua:

• Solicitações diretas que devem chamar uma ferramenta específica.
• Solicitações indiretas que expressem o mesmo objetivo.
• Solicitações de acompanhamento que reutilizem identificadores de resultados anteriores.
• Ações de escrita que exijam autorização ou confirmação.
• Solicitações sem suporte que não devem chamar nenhuma ferramenta.

Para cada solicitação, registre a ferramenta selecionada, os argumentos, o resultado, os erros e o que ocorreu em relação à confirmação. Execute os testes novamente sempre que alterar os nomes, as descrições, os schemas ou as anotações das ferramentas.

Se o servidor retornar uma interface opcional, teste tanto o componente quanto o resultado que o modelo consegue ler.

Teste no Playground da API

Para consultar os registros brutos de solicitações e respostas, abra o Playground da API:

1. Selecione Ferramentas → Adicionar → Servidor MCP.
2. Insira o endpoint HTTPS e conecte-se.
3. Execute os prompts de teste e examine os dados das solicitações e respostas.

Atualize os metadados

Depois de alterar os nomes, as descrições, os schemas ou as anotações das ferramentas, a autenticação ou os recursos da interface:

1. Implante ou reinicie o servidor MCP.
2. Abra a conexão em Plug-ins do ChatGPT.
3. Selecione Atualizar.
4. Confirme que os metadados disponibilizados pelo servidor refletem as alterações.
5. Inicie uma nova conversa e execute novamente os testes afetados.

Esse processo de atualização se aplica a servidores MCP personalizados conectados diretamente ao ChatGPT. Nos plugins publicados, as atualizações de ferramentas passam por revisão contínua. Alterações nas informações enviadas sobre o plugin ou nas habilidades importadas ainda exigem uma nova versão, que precisa passar por revisão e ser publicada.

Antes de empacotar o plugin, confirme que:

• A lista de ferramentas corresponde aos recursos documentados.
• Os resultados estruturados seguem o schema de saída declarado por cada ferramenta.
• As falhas de autenticação retornam mensagens de erro úteis.
• Os prompts dos testes positivos levam à seleção das ferramentas esperadas, e os dos testes negativos não acionam essas ferramentas.
• A interface opcional é renderizada sem erros no console e restaura seu estado corretamente.

Teste o plugin completo

Assim que o servidor MCP estiver funcionando, empacote o plugin completo e instale-o a partir de uma fonte local. Se o plugin contiver apenas habilidades, comece diretamente por esta etapa:

1. Empacote o plugin com suas habilidades, o manifesto e, se aplicável, a conexão com o servidor MCP.
2. Adicione o plugin a um marketplace local e instale-o pelo Diretório de Plug-ins.
3. Inicie uma nova conversa com o plugin ativado.
4. Execute solicitações representativas da lista de casos de uso do plugin.

Monte um conjunto de testes que inclua:

• Solicitações diretas que devem usar uma habilidade.
• Solicitações indiretas que expressem o mesmo objetivo.
• Solicitações de acompanhamento que dependam de um resultado anterior.
• Solicitações para testes negativos, nas quais o plugin não deve ser usado.
• Casos limítrofes que o plugin não atende por decisão de projeto.

Para cada solicitação, verifique se o plugin segue as instruções da habilidade, usa os recursos esperados, conclui todas as etapas necessárias e produz um resultado útil. Registre as etapas omitidas, as ativações desnecessárias e os resultados inconsistentes.

Para plugins com servidor MCP, confirme também que as habilidades chamam as ferramentas corretas, que os resultados das ferramentas retornam ao fluxo de trabalho, que a autenticação funciona após a instalação e que os usuários conseguem concluir, do início ao fim, cada fluxo que combina habilidades e ferramentas.

Antes de enviar o plugin, confirme que:

• Cada habilidade é ativada para as solicitações a que se destina.
• Solicitações formuladas de maneira semelhante produzem um comportamento consistente.
• Solicitações sem suporte não ativam o plugin.
• Após a instalação, o plugin consegue localizar os arquivos incluídos no pacote e resolver as referências.
• Os prompts iniciais do plugin representam fluxos de trabalho que ele consegue concluir.
• Nos plugins com servidor MCP, as habilidades e as ferramentas incluídas no pacote funcionam em conjunto como previsto.