Conecta y prueba tu complemento

Prueba cada capacidad antes de probar el complemento completo instalado. Si el complemento incluye un servidor MCP, comienza por conectar y evaluar el servidor en modo de desarrollador. Luego empaqueta el complemento con sus habilidades y prueba la experiencia completa. Los complementos que solo incluyen habilidades pueden omitir la primera sección.

Conserva tus prompts de evaluación y los resultados durante todo el desarrollo para poder comparar el comportamiento entre versiones.

Prueba un servidor MCP (opcional)

Prepara el punto de acceso

Confirma lo siguiente:

• Se puede acceder al servidor MCP a través de un punto de acceso HTTPS público o del Túnel MCP seguro.
• El punto de acceso público admite HTTP con streaming, normalmente en /mcp, o el túnel puede acceder a su servidor MCP configurado con stdio o HTTP.
• Los nombres, las descripciones, los esquemas y las anotaciones de las herramientas están presentes.
• El descubrimiento de autenticación funciona para las herramientas que requieren una cuenta.

Usa el Túnel MCP seguro para conectar un servidor MCP privado en modo de desarrollador sin exponerlo a la internet pública. Un túnel de desarrollo u otro servicio de reenvío HTTPS también pueden proporcionar un punto de acceso para pruebas locales. Estas opciones de prueba no reemplazan el punto de acceso HTTPS público necesario para enviar el complemento a revisión.

Inspecciona el servidor MCP

Usa MCP Inspector para enumerar y llamar a las herramientas directamente:

npx @modelcontextprotocol/inspector@latest

Prueba cada herramienta con entradas representativas, casos límite, identificadores faltantes y resultados vacíos. Verifica la validación de esquemas, los errores de autenticación, las anotaciones, el comportamiento de confirmación y el resultado legible para el modelo.

Activa el modo de desarrollador

En ChatGPT:

1. Abre Configuración.
2. Selecciona Seguridad e inicio de sesión.
3. Activa el Modo de desarrollador.

La disponibilidad del modo de desarrollador puede depender de las políticas de la cuenta y del espacio de trabajo.

Agrega el servidor MCP

1. Ve a Complementos de ChatGPT.
2. Selecciona el botón con el signo más.
3. Ingresa un nombre y una descripción que se mostrarán a los usuarios.
4. En Conexión, elige el método de conexión:
   • Para un punto de acceso público, ingresa la URL del servidor MCP, incluida la ruta /mcp.
   • Para el Túnel MCP seguro, selecciona Túnel y luego elige un túnel disponible o ingresa su tunnel_id.
5. Crea la conexión.
6. Revisa las herramientas y los metadatos descubiertos en el servidor.

Si ChatGPT no puede conectarse, verifica el punto de acceso HTTPS público con MCP Inspector o revisa la asociación del túnel con el espacio de trabajo y el estado de tunnel-client. Resuelve los errores de transporte, inicialización, esquema o autenticación antes de continuar.

Verifica la selección de herramientas

Inicia una conversación nueva y agrega la conexión MCP desde el menú de herramientas. Crea un conjunto de evaluación que incluya:

• Solicitudes directas que deban llamar a una herramienta específica.
• Solicitudes indirectas que expresen el mismo objetivo.
• Solicitudes de seguimiento que reutilicen identificadores de resultados anteriores.
• Acciones de escritura que requieran autorización o confirmación.
• Solicitudes no admitidas que no deban llamar a ninguna herramienta.

Para cada solicitud, registra la herramienta seleccionada, los argumentos, el resultado, los errores y el comportamiento de confirmación. Vuelve a ejecutar el conjunto cada vez que cambies los nombres, las descripciones, los esquemas o las anotaciones de las herramientas.

Si el servidor devuelve una interfaz de usuario opcional, prueba tanto el componente como el resultado legible para el modelo.

Realiza pruebas con el Playground de la API

Para ver los registros sin procesar de solicitudes y respuestas, abre el Playground de la API:

1. Elige Herramientas → Agregar → Servidor MCP.
2. Ingresa el punto de acceso HTTPS y conéctate.
3. Ejecuta prompts de prueba e inspecciona los datos de las solicitudes y las respuestas.

Actualiza los metadatos

Después de cambiar los nombres, las descripciones, los esquemas o las anotaciones de las herramientas, la autenticación o los recursos de la interfaz de usuario:

1. Despliega o reinicia el servidor MCP.
2. Abre la conexión en Complementos de ChatGPT.
3. Selecciona Actualizar.
4. Confirma que los metadatos que anuncia el servidor hayan cambiado.
5. Inicia una conversación nueva y vuelve a ejecutar las pruebas afectadas.

Este proceso de actualización se aplica a los servidores MCP conectados en modo de desarrollador. Los complementos publicados usan la revisión continua para las actualizaciones de herramientas. Los cambios en la información enviada sobre el complemento o en las habilidades importadas siguen requiriendo una nueva versión, revisión y publicación.

Antes de empaquetar el complemento, confirma lo siguiente:

• La lista de herramientas coincide con las capacidades documentadas.
• Los resultados estructurados coinciden con el esquema de salida declarado de cada herramienta.
• Las fallas de autenticación devuelven mensajes de error útiles.
• Los prompts positivos seleccionan las herramientas esperadas y los negativos no.
• La interfaz de usuario opcional se renderiza sin errores en la consola y restaura el estado correctamente.

Prueba el complemento completo

Una vez que el servidor MCP funcione, o de inmediato si el complemento solo incluye habilidades, empaqueta e instala el complemento completo desde una fuente local:

1. Empaqueta el complemento con sus habilidades, su archivo de manifiesto y su conexión al servidor MCP, cuando corresponda.
2. Agrega el complemento a un marketplace local e instálalo desde el Directorio de complementos.
3. Inicia una conversación nueva con el complemento activado.
4. Ejecuta solicitudes representativas del inventario de casos de uso del complemento.

Crea un conjunto de evaluación que incluya:

• Solicitudes directas que deberían usar una habilidad.
• Solicitudes indirectas que expresen el mismo objetivo.
• Solicitudes de seguimiento que dependan de un resultado anterior.
• Solicitudes negativas que no deberían usar el complemento.
• Casos límite que el complemento no admite por diseño.

Para cada solicitud, verifica que el complemento siga las instrucciones de la habilidad, use los recursos esperados, complete todos los pasos requeridos y produzca un resultado útil. Registra cualquier paso omitido, activación innecesaria o resultado inconsistente.

En el caso de los complementos con un servidor MCP, confirma también que las habilidades invoquen las herramientas correctas, que los resultados de las herramientas se devuelvan al flujo de trabajo, que la autenticación funcione después de la instalación y que los usuarios puedan completar cada flujo de trabajo combinado de principio a fin.

Antes de enviarlo, confirma lo siguiente:

• Cada habilidad se activa ante las solicitudes previstas.
• Las solicitudes formuladas de manera similar producen un comportamiento consistente.
• Las solicitudes no admitidas no activan el complemento.
• Los archivos y las referencias incluidos se resuelven después de la instalación.
• Los prompts iniciales del complemento representan flujos de trabajo que puede completar.
• En el caso de los complementos con un servidor MCP, las habilidades y las herramientas incluidas funcionan juntas según lo previsto.