Prueba, depura y evalúa en el modo de desarrollador de las Apps con Gemini

Usa el modo de desarrollador de las Apps con Gemini para probar de forma interactiva tu servidor de Model Context Protocol (MCP), diagnosticar errores de esquema o de tiempo de ejecución, y comparar la calidad de las herramientas antes de enviar tu app conectada para su revisión en Google Connected Console.

En esta guía, se abarcan las siguientes tareas:

  • Habilitar el modo de desarrollador de las Apps con Gemini en Gemini, crear una app de MCP personalizada y verificar el descubrimiento inicial de herramientas
  • Depura las llamadas a herramientas que fallaron, sincroniza los esquemas actualizados y prueba la autenticación.
  • Simular el contexto del entorno del usuario y configurar la autenticación del cliente

Para obtener una introducción al diseño del espacio de trabajo y las pestañas del inspector, consulta la descripción general del modo de desarrollador de las apps de Gemini.

Habilita el modo de desarrollador de las Apps con Gemini

Si incorporas tu servidor de MCP en Google Connected Console, tu app registrada ya estará disponible cuando habilites el modo de desarrollador de las Apps con Gemini, y podrás omitir el paso 2. Si quieres probar un extremo de servidor de MCP de HTTPS implementado directamente en Gemini antes de registrarlo en la consola, sigue ambos pasos para habilitar el modo de desarrollador de las apps con Gemini y conectar tu servidor como una app de MCP personalizada.

Paso 1: Habilita el modo de desarrollador de las Apps con Gemini

  1. Abre Gemini en tu navegador web.
  2. Haz clic en Configuración > Modo de desarrollador de las Apps con Gemini (o ve directamente a gemini.google.com/devmode).

Paso 2 (opcional): Crea y prueba una app de MCP personalizada

Para conectar tu servidor de MCP como una app personalizada en el modo de desarrollador de las Apps con Gemini, haz lo siguiente:

  1. En el cuadro de diálogo Elige una app, haz clic en + Crear nueva.
  2. En el cuadro de diálogo Conectarse a un servidor de MCP, ingresa el extremo HTTPS público de tu servidor en URL del servidor de MCP (asegúrate de que la URL comience con https://, por ejemplo, https://your-app-link.com/mcp).
  3. Si tu servidor requiere credenciales de OAuth registradas previamente, haz clic en Configuración adicional > Mostrar más para ingresar el ID de cliente y el Secreto de cliente de OAuth y, luego, haz clic en Siguiente.
  4. En el cuadro de diálogo de confirmación de seguridad y privacidad, revisa cómo interactúa Gemini con tu servidor de MCP personalizado:
    • Ejecución de herramientas: Gemini ejecuta las herramientas de tu servidor de MCP para activar y ejecutar las funciones disponibles para gestionar tus solicitudes.
    • Recuperación y uso compartido de datos: Gemini recupera y administra recursos, esquemas y contexto expuestos por los endpoints de tu servidor de MCP, y puede compartir la información a la que tiene acceso según la configuración de tu Cuenta de Google o cuando interactúa con otras apps conectadas.
    • Confianza y desconexión: Asegúrate de confiar en el servidor de MCP y revisa su política de privacidad antes de continuar. Puedes desconectar el servidor en cualquier momento desde la página de Apps conectadas o borrar su vínculo de las conexiones de tu Cuenta de Google.
  5. Selecciona Comprendo y acepto los riesgos de seguridad y privacidad relacionados con la conexión de esta app personalizada. Luego, haz clic en Conectar.
  6. En el cuadro de diálogo Guarda tu app personalizada, ingresa un nombre visible para tu app personalizada, verifica que las herramientas de tu servidor aparezcan en la lista Acciones disponibles y haz clic en Conectar.
  7. En el panel lateral del Modo de desarrollador de las Apps con Gemini, selecciona la pestaña Esquemas de herramientas para revisar la información sobre cada herramienta de tu app conectada, incluidas las definiciones de parámetros, las insignias de seguridad (Solo lectura, Destructivo, Requiere autenticación), el Esquema sin procesar y la Estructura de respuesta.
  8. En el panel de chat de la izquierda, ingresa instrucciones en lenguaje natural o @mention (por ejemplo, @MyApp show my profile) y supervisa la pestaña Registro de eventos para ver cómo funciona tu herramienta.

Depura las llamadas a la herramienta

Cuando una llamada a la herramienta falla o produce argumentos inesperados, puedes inspeccionar la telemetría de diagnóstico, actualizar el servidor de MCP de backend y volver a cargar el esquema en caliente sin borrar el historial de conversaciones.

Para depurar una llamada a la herramienta que falló, haz lo siguiente:

  1. En el panel derecho, selecciona la pestaña Registro de eventos.
  2. Haz clic en el evento con errores en la lista Telemetría para expandir sus detalles y revisar la carga útil de la solicitud Tool call y la respuesta Tool result:
    • Errores de conexión y de red: Verifica los mensajes de error y la latencia para comprobar que se pueda acceder a tu extremo.
    • Errores de autenticación: Si el evento devuelve 401 o 403, verifica el estado del token de OAuth o las credenciales del cliente en la pestaña Autenticación.
    • Discrepancias en la validación del esquema: Si el servidor devuelve un error de parámetros no válidos de MCP (-32602), compara los argumentos JSON generados por el modelo en Tool call con los tipos de parámetros, las propiedades obligatorias y las instrucciones de formato en la pestaña Esquemas de herramientas.
    • Excepciones del entorno de ejecución del servidor: Inspecciona el código de error y el mensaje de JSON-RPC en Tool result para diagnosticar excepciones del backend.
  3. Para resolver el problema, actualiza la implementación del servidor de MCP o define mejor las descripciones de las herramientas y los parámetros. Para obtener orientación sobre cómo escribir esquemas de herramientas y respuestas de error claros, consulta los estándares de integración de apps conectadas de MCP.
  4. En la pestaña Esquemas de herramientas, haz clic en Sincronizar esquema. Gemini vuelve a recuperar tools/list de tu servidor de MCP y actualiza las definiciones de herramientas activas, mientras conserva el hilo de chat actual.
  5. Vuelve a intentar la consulta. En la pestaña Registro de eventos, confirma que la llamada a la herramienta reproducida devuelva 200 OK y renderice la respuesta esperada en la vista previa del chat.

Simula el contexto y la autenticación del entorno

Puedes probar cómo responden tus herramientas de MCP a diferentes ubicaciones, zonas horarias, configuraciones regionales y métodos de autenticación de los usuarios directamente en el panel del inspector.

Anula el contexto del entorno

Para simular el contexto del usuario en herramientas que dependen de la fecha, la hora o la configuración regional, haz lo siguiente:

  1. En el panel derecho, selecciona la pestaña Entorno.
  2. En Fecha y hora, selecciona una Fecha simulada y una Hora simulada para probar expresiones de tiempo relativas (como "mañana por la mañana" o "este sábado por la tarde").
  3. En Preferencias, selecciona un Idioma para simular la configuración regional del usuario (por ejemplo, en-US).
  4. Ejecuta una instrucción de prueba en el panel de chat para evaluar tu herramienta con el contexto simulado.
  5. Para restablecer la configuración predeterminada del entorno, haz clic en Restablecer.

Configura la autenticación de clientes

Para configurar o cambiar el método de autenticación que se usa durante la sesión del modo de desarrollador de las Apps con Gemini, haz lo siguiente:

  1. En el panel derecho, selecciona la pestaña Autenticación.
  2. En Configuración de autenticación del cliente, selecciona uno de los siguientes modos de autenticación:
    • Registro dinámico de clientes: Usa un flujo de OAuth para negociar credenciales automáticamente con tu servidor de autorización. Para obtener más información, consulta la guía de implementación de OAuth 2.1. Si corresponde, ingresa tu extremo en Agrega un vínculo de una app personalizada.
    • Registro manual de clientes: Te permite proporcionar un ID de cliente y un secreto del cliente registrados previamente de forma manual. Expande Configuración avanzada para configurar anulaciones de flujo adicionales.
  3. Haz clic en Guardar y espera a que aparezca el mensaje Guardado. Luego, ejecuta una instrucción de prueba para verificar que las herramientas autenticadas se ejecuten correctamente.

Recursos adicionales