Conecte e teste seu plug-in

Teste cada capacidade antes de testar o plug-in completo instalado. Se o plug-in incluir um servidor MCP, comece conectando e avaliando o servidor no modo de desenvolvedor. Depois, empacote o plug-in com suas habilidades e teste a experiência completa. Para plug-ins que contêm apenas habilidades, você pode pular a primeira seção.

Guarde os prompts e resultados de avaliação durante todo o desenvolvimento para poder comparar o comportamento entre versões.

Teste um servidor MCP (opcional)

Prepare o endpoint

Confirme que:

• O servidor MCP está acessível por um endpoint HTTPS público ou pelo Túnel MCP seguro.
• O endpoint público oferece suporte a HTTP com streaming, normalmente em /mcp, ou o túnel consegue acessar o servidor MCP configurado para usar stdio ou HTTP.
• Os nomes, as descrições, os esquemas e as anotações das ferramentas estão presentes.
• A descoberta de autenticação funciona para ferramentas que exigem uma conta.

Use o Túnel MCP seguro para conectar um servidor MCP privado no modo de desenvolvedor 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 necessário para enviar o plug-in para análise.

Inspecione o servidor MCP

Use o MCP Inspector para listar e chamar ferramentas diretamente:

npx @modelcontextprotocol/inspector@latest

Teste cada ferramenta com entradas representativas, casos extremos, identificadores ausentes e resultados vazios. Verifique a validação de esquemas, os erros de autenticação, as anotações, o comportamento de confirmação e o resultado legível pelo modelo.

Ative o modo de desenvolvedor

No ChatGPT:

1. Abra Configurações.
2. Selecione Segurança e login.
3. Ative o Modo de desenvolvedor.

A disponibilidade do modo de desenvolvedor pode depender das políticas da conta e do workspace.

Adicione o servidor MCP

1. Acesse Plug-ins do ChatGPT.
2. Selecione o botão de adição.
3. Insira um nome e uma descrição que serão exibidos 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 o Túnel MCP seguro, selecione Túnel e escolha um túnel disponível ou insira seu tunnel_id.
5. Crie a conexão.
6. Revise as ferramentas e os metadados descobertos no servidor.

Se o ChatGPT não conseguir se conectar, verifique o endpoint HTTPS público com o MCP Inspector ou confira a associação do túnel ao workspace e o status do tunnel-client. Resolva os erros de transporte, inicialização, esquema ou autenticação antes de continuar.

Verifique a seleção de ferramentas

Inicie uma nova conversa e adicione a conexão MCP pelo menu de ferramentas. Crie um conjunto de avaliação 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 não compatíveis que não devem chamar nenhuma ferramenta.

Para cada solicitação, registre a ferramenta selecionada, os argumentos, o resultado, os erros e o comportamento de confirmação. Execute novamente o conjunto sempre que alterar nomes, descrições, esquemas ou anotações das ferramentas.

Se o servidor retornar uma interface opcional, teste tanto o componente quanto o resultado legível pelo modelo.

Teste pelo Playground da API

Para acessar os logs brutos de requisição e resposta, abra o Playground da API:

1. Escolha Ferramentas → Adicionar → Servidor MCP.
2. Insira o endpoint HTTPS e conecte-se.
3. Execute prompts de teste e inspecione os dados de requisição e resposta.

Atualize os metadados

Depois de alterar nomes, descrições, esquemas, anotações, autenticação ou recursos de interface das ferramentas:

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 foram alterados.
5. Inicie uma nova conversa e execute novamente os testes afetados.

Este fluxo de atualização aplica-se aos servidores MCP conectados no modo de desenvolvedor. Os plug-ins publicados usam revisão contínua para atualizações de ferramentas. Alterações nas informações enviadas sobre o plug-in ou nas habilidades importadas ainda exigem uma nova versão, revisão e publicação.

Antes de empacotar o plug-in, confirme que:

• A lista de ferramentas corresponde às capacidades documentadas.
• Os resultados estruturados correspondem ao esquema de saída declarado por cada ferramenta.
• As falhas de autenticação retornam erros úteis.
• Os prompts positivos selecionam as ferramentas esperadas e os negativos não.
• A interface opcional é renderizada sem erros no console e restaura o estado corretamente.

Teste o plug-in completo

Depois que o servidor MCP estiver funcionando, ou imediatamente se o plug-in contiver apenas habilidades, empacote e instale o plug-in completo a partir de uma fonte local:

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

Crie um conjunto de avaliação 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 de teste negativo que não devem usar o plug-in.
• Casos-limite que o plug-in intencionalmente não oferece suporte.

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

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

Antes do envio, confirme se:

• Cada habilidade é ativada para as solicitações previstas.
• Formulações semelhantes produzem um comportamento consistente.
• Solicitações não compatíveis não ativam o plug-in.
• Os arquivos e as referências incluídos no pacote são encontrados corretamente após a instalação.
• Os prompts iniciais do plug-in representam fluxos de trabalho que ele consegue concluir.
• Para plug-ins com um servidor MCP, as habilidades e ferramentas incluídas no pacote funcionam juntas conforme o esperado.