Registra, prueba y publica tu app conectada

Una vez que cumplas con los requisitos previos, sigue estos pasos para registrar, configurar, probar y publicar tu app conectada.

Paso 1: Crea una app conectada

Para crear una app conectada, sigue estos pasos:

  1. Accede a Google Connected Console.
  2. En la página principal, selecciona Crear app.
  3. En el diálogo Elige lo que quieres crear, haz lo siguiente:
    • Si se te solicita que aceptes las Condiciones del Servicio de las apps conectadas, selecciona Ver condiciones, revisa y acepta el acuerdo y, luego, selecciona Crear. Solo un administrador de la cuenta puede aceptar el acuerdo.
    • De lo contrario, selecciona Crear en la tarjeta App conectada.

  4. En el cuadro de diálogo Asigna un nombre a tu app conectada, escribe un nombre para tu app conectada. Este es el nombre que se usará para mostrar tu app conectada en los productos de Google y es la forma en que los usuarios mencionarán tu app conectada con @. Selecciona Siguiente.

  5. En el cuadro de diálogo Selecciona una categoría de app conectada, elige el dominio, la categoría o el sector de tu app en el menú Selecciona una categoría.

  6. En el cuadro de diálogo Elige el tipo de conexión, selecciona una de las siguientes opciones:

    • Servidor de MCP: Conecta un servidor de MCP para proporcionar tus servicios a los usuarios de Gemini y de la Búsqueda en la Web, Android y iOS.
    • MCP de Android: Expón las funciones integradas en el dispositivo a Gemini en Android para que pueda activar acciones y completar tareas para los usuarios en tu app.

    Obtén más información para configurar una app conectada de MCP de Android. Solo puedes elegir un tipo de conexión por app conectada, y no se puede cambiar más adelante.

  7. Selecciona Crear app conectada.

Se abrirá la página de resumen de la administración de tu app conectada (Configura y prueba tu app conectada), en la que puedes configurar los detalles de la app, la conexión del servidor de MCP y los verificadores.

Paso 2: Ingresa los detalles de tu app conectada

Para proporcionar más detalles sobre tu app conectada y configurar cómo se muestra a los usuarios, sigue estos pasos:

  1. En la página de resumen de la app conectada, en la fila Detalles de la app, selecciona Comenzar (o Administrar si estás actualizando los detalles existentes).
  2. En la parte superior de la página Detalles de la app, verifica el campo Nombre de la app conectada. Puedes actualizar el nombre si es necesario. Se muestra a los usuarios en los productos de Google y se usa cuando los usuarios mencionan tu app con @.
  3. En la sección Detalles públicos, en Ícono, sube el ícono de la app (JPG o PNG, de hasta 1 MB y 512 px × 512 px).

  4. Completa los siguientes campos:

    • Descripción: Ingresa un resumen conciso de una sola oración (menos de 30 palabras) que describa las funciones principales de tu app conectada y lo que puede hacer. Este texto se muestra a los usuarios, pero no se usa como instrucciones del modelo.
    • Funciones: Ingresa al menos tres tareas de alto valor que pueda realizar tu app conectada. Selecciona Agregar capacidad para agregar más entradas. No incluyas números al principio de tus capacidades. Incluye solo una capacidad por entrada. Si tu categoría incluye capacidades predefinidas, estas aparecen en la parte superior de la lista y no se pueden modificar.
    • Instrucciones de ejemplo: Ingresa al menos tres instrucciones de ejemplo que ayuden a los usuarios a comprender qué pueden preguntar. Selecciona Agregar instrucción de ejemplo para agregar entradas.
      • Comienza al menos dos instrucciones con @<YourAppName> (por ejemplo, @Order Tracker where is my last order?).
      • Menciona <YourAppName> de forma natural en al menos una instrucción sin comenzar con el nombre de tu app (por ejemplo, Track my recent order on Order Tracker).
      • No incluyas prefijos numerados (1., 2., 3.) ni encierres las instrucciones entre comillas ("...").

    • Localización en varios idiomas: Para proporcionar traducciones de Descripción, Funciones y Instrucciones de ejemplo, une el texto de cada configuración regional en etiquetas de idioma dentro del campo de entrada. Por ejemplo:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Connected Console valida automáticamente tus etiquetas y muestra las configuraciones regionales detectadas debajo de cada campo (por ejemplo, Found translations for 2 languages: en-US, es-ES).

    • URL de las Condiciones del Servicio: Ingresa un vínculo válido de https:// o http:// a tus Condiciones del Servicio.

    • URL de la política: Ingresa un vínculo válido de https:// o http:// a tu Política de Privacidad.

    • URL del sitio web (opcional): Ingresa un vínculo a tu sitio web para fines de atribución.

  5. Selecciona Guardar en la parte inferior de la página para volver a la página de resumen.

Paso 3: Ingresa tu extremo de MCP y verifica la propiedad del dominio

Antes de que Google pueda conectarse a tu servidor de MCP o sincronizar tus herramientas, debes proporcionar la URL del extremo de tu servidor de MCP y verificar que el dominio en el que se aloja es de tu propiedad.

Para ingresar tu extremo de MCP y verificar la propiedad del dominio, sigue estos pasos:

  1. En la página de resumen de la app conectada, en la tarjeta Configuración de MCP y herramientas, selecciona Comenzar (o Administrar si estás actualizando detalles existentes). Se abrirá el paso 1 (Extremos del servidor de MCP) del flujo de configuración de MCP.
  2. En Conecta el extremo de tu servidor de MCP, ingresa la URL HTTPS completa del extremo de tu servidor de MCP (por ejemplo, https://api.yourdomain.com/v1/mcp).

  3. En Verifica tu dominio, completa la verificación del token de desafío para tu dominio (si ya verificaste el dominio o su dominio superior en tu cuenta de desarrollador, se mostrará automáticamente como verificado):

    1. En la tarjeta Verifica la propiedad del dominio, selecciona Descargar token. El navegador descargará un archivo llamado google-connected-apps.json con la siguiente estructura:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Sube y aloja este contenido JSON en tu servidor en https://<your-domain>/.well-known/google-connected-apps.

      • Asegúrate de que se pueda acceder públicamente al extremo a través de HTTPS, que devuelva HTTP 200 OK directamente sin redireccionamientos HTTP y que incluya tu token dentro del array verification_tokens.

    3. Regresa a Google Connected Console y selecciona Verificar dominio.

    4. Una vez que la verificación se realiza correctamente, la fila Dominio verificado con token de desafío muestra una marca de verificación verde y desbloquea la sección Credenciales de acceso que se encuentra debajo.

Paso 4: Configura las credenciales de acceso

Después de verificar tu dominio, configura cómo se autentica Google con tu servidor de MCP y recupera las definiciones de herramientas de tu servidor.

Para configurar las credenciales de acceso, haz lo siguiente:

  1. En la sección Proporciona credenciales de acceso (en el paso 1 de la página Configuración de MCP y herramientas), selecciona Comenzar (o Actualizar credenciales para modificar una configuración existente).

  2. En ¿Tu servidor requiere autorización?, selecciona una de las siguientes opciones:

    • No: Selecciona esta opción si se puede acceder públicamente a tu servidor de MCP sin autenticación y, luego, selecciona Confirmar.

    • Sí: Selecciona esta opción si alguna de las herramientas que expone tu servidor de MCP requiere autorización. Luego, en Selecciona el modelo de autorización que usa tu servidor de MCP, elige tu flujo de autenticación:

      • Máquina a máquina (credenciales de cliente de OAuth): Selecciona esta opción para la autenticación de servicio a servicio (RFC 6749) en la que Google se comunica directamente con tu servidor de MCP a través de un ID de cliente y un secreto compartidos sin redireccionamientos de acceso del usuario final:
        1. Ingresa tu ID de cliente (obligatorio) y el secreto del cliente (opcional).
        2. De manera opcional, ingresa un Extremo de autorización (opcional) y un Extremo de token (opcional) si tu servidor no los anuncia con /.well-known/oauth-authorization-server.
        3. Selecciona Registrar cliente (o Actualizar cliente).

      • Delegado por el usuario (código de autorización): Selecciona esta opción si tu servidor de MCP requiere que los usuarios individuales accedan y autoricen acciones con sus propias cuentas a través de la Vinculación de la Cuenta de Google:

        1. Agrega los URIs de redireccionamiento de OAuth de Google a la lista de entidades permitidas: En el banner Asegúrate de haber agregado los URIs de redireccionamiento proporcionados a la lista de entidades permitidas, selecciona Ver (o selecciona el ícono de copia) para inspeccionar los URIs de redireccionamiento específicos de la app que se generaron para tu app conectada. Agrégalos a la lista de entidades permitidas de tu servidor de OAuth y, luego, regresa a Google Connected Console.
        2. En Selecciona cómo Google debe autenticarse con tu servidor de OAuth, elige cómo se registra tu cliente de OAuth:
          • Registro previo: Elige esta opción si generas un ID de cliente y un Secreto de cliente (opcional) estáticos en tu proveedor de OAuth. También puedes proporcionar un extremo de autorización personalizado (opcional) y un extremo de token personalizado (opcional).
          • Metadatos de ID de cliente o Registro dinámico de clientes (recomendado): Elige esta opción si tu servidor admite los documentos de metadatos de ID de cliente (CIMD) de OAuth o el Registro dinámico de clientes (RFC 7591). Google verifica primero la CIMD y recurre al DCR con tus extremos de descubrimiento de .well-known. De manera opcional, también puedes especificar extremos de autorización y de token personalizados.

        3. En Autentica con tus credenciales de desarrollador, como seleccionaste Delegado por el usuario como tu modelo de autorización, debes acceder a tu servidor antes de que Google pueda recuperar las herramientas. Selecciona una de las siguientes opciones:

          • Autenticar mediante ventana emergente (recomendado): Abre tu flujo de autenticación en un diálogo superpuesto. Esta es la experiencia predeterminada.
          • Autenticar mediante redireccionamiento (resguardo): Abre el flujo de autenticación con un redireccionamiento de pantalla completa en la misma pestaña o ventana. Usa esta opción si el diálogo no se renderiza debido a restricciones de visualización o encabezados de seguridad (como X-Frame-Options o Content-Security-Policy).

          Te recomendamos que primero intentes autenticarte con el diálogo. Si no puedes autenticarte con el diálogo, usa el método de redireccionamiento. Tu selección también determina la experiencia de acceso de los usuarios cuando usan tu app conectada por primera vez.

        4. Selecciona Registrar cliente (o Actualizar cliente).

Paso 5: Proporciona los detalles de la cuenta de prueba (solo para la autorización delegada por el usuario)

Si tu app conectada requiere autenticación, debes proporcionar credenciales de prueba iniciales, completadas previamente con datos de muestra realistas y con la autenticación de dos factores (2FA) inhabilitada, junto con las instrucciones de prueba a tu representante de Google. Esto permite que el equipo de revisión y QA de Google verifique la ejecución de la herramienta sin que lo bloqueen entornos de pruebas vacíos, muros de pago o desafíos de 2FA. Si Google no puede probar por completo tu app conectada, es posible que se rechace durante la revisión.

Paso 6: Sincroniza tus herramientas

Para crear cada versión de tu app conectada, Google se sincroniza con el extremo que proporcionaste para obtener las herramientas disponibles y tomar una instantánea. Estas son las herramientas que estarán disponibles para los usuarios en esa versión. Mientras la versión de tu app conectada esté en versión preliminar y disponible para los verificadores, puedes seguir realizando cambios en tu servidor y volver a sincronizar las herramientas para actualizarlas. Esto crea una nueva instantánea de tus herramientas.

Cuando publiques, se usará la instantánea más reciente de tus herramientas para esa versión de tu app conectada. Ya no podrás realizar cambios en tus herramientas, descripciones ni detalles del servidor. Para actualizar tus herramientas o sincronizar cualquier modificación de tu servidor, crea una nueva versión de la app conectada. Te recomendamos crear un extremo nuevo para cada versión de tu app conectada.

Para sincronizar herramientas, haz lo siguiente:

  1. En la sección Herramientas de sincronización, haz lo siguiente:

    1. Selecciona Herramientas de sincronización.
    2. Si se te solicita que accedas, autentícate con una cuenta de desarrollador que tenga permisos para enumerar todas las herramientas que deseas exponer a los usuarios. No se sincronizan las herramientas a las que tu cuenta no puede acceder.
    3. Una vez conectado, Connected Console muestra la cantidad de herramientas sincronizadas, junto con el botón Volver a sincronizar herramientas.

  2. Selecciona Siguiente en la parte inferior de la página para avanzar al paso 2 de la configuración de MCP y herramientas.

Paso 7: Determina cómo y dónde los usuarios experimentan tu app

En la sección Herramientas de la página Configuración de MCP y herramientas, configura los parámetros básicos, como la ubicación geográfica en la que está disponible tu app conectada, su idioma y los productos de Google en los que quieres que esté disponible.

  1. En Disponibilidad, junto a Hacer que la versión esté disponible en, configura las siguientes opciones de segmentación:
    • Países o regiones: Selecciona las ubicaciones geográficas en las que debería estar disponible tu app conectada.
    • Idiomas: Selecciona los idiomas que admite tu app conectada.
    • Productos: Selecciona los productos de Google en los que estará disponible tu app conectada.

  2. En la sección Herramientas, después de Disponibilidad, revisa las herramientas sincronizadas desde tu servidor de MCP. Selecciona cualquier herramienta de la lista Herramientas para establecer su configuración en el panel Administrar herramienta de la derecha:

    • Habilitar herramienta: Activa o desactiva el interruptor Habilitar herramienta para incluir o excluir la herramienta en tu app conectada. Las herramientas inhabilitadas no estarán disponibles en tu app conectada para que los usuarios interactúen con ellas.

    • Contexto adicional: Selecciona si tu herramienta requiere indicadores contextuales de Google para funcionar:

      • Configuración regional: Es la configuración regional determinada por la Cuenta de Google del usuario.
      • Ubicación aproximada: Es la ubicación física de los usuarios o del dispositivo dentro de un área mayor o igual a 3 kilómetros cuadrados (por ejemplo, la ciudad en la que se encuentra el usuario).
      • Ubicación precisa: Es la ubicación física del usuario o dispositivo con una precisión de 50 metros o menos.

    • Confirmación del usuario: Selecciona Se requiere confirmación del usuario para exigir la confirmación explícita del usuario antes de ejecutar la herramienta (esta opción se preselecciona automáticamente si las anotaciones de MCP de tu herramienta especifican destructiveHint: true).

  3. Si tu servidor de MCP proporciona recursos de IU, cambia a la pestaña Recursos de IU junto a Herramientas para inspeccionar los recursos de IU de tu servidor (text/html, text/html;profile=mcp-app, text/javascript y text/css), verificar qué herramientas están vinculadas a cada recurso y revisar la Política de Seguridad del Contenido (CSP) connectDomains y resourceDomains.

  4. Selecciona Guardar en la parte inferior de la página.

Una vez que se hayan guardado los detalles de la app y la configuración de MCP y herramientas, tu configuración estará disponible automáticamente para que los verificadores que hayas agregado obtengan una vista previa, y el estado de tu versión en la página de resumen se actualizará a Disponible para verificadores.

Paso 8: Prueba tu app conectada

Para que tu app conectada esté disponible para los verificadores, debes agregarlos en la pantalla Administrar verificadores. Solo los usuarios que agregues a tu lista de verificadores podrán ver tu app conectada no publicada e interactuar con ella. Solo puedes agregar verificadores que tengan una cuenta de @gmail.com.

  1. En la página de resumen de tu app conectada, en la tarjeta Prueba tu app, selecciona Agregar verificadores (o Administrar verificadores si ya agregaste algunos).

  2. En la pantalla Administrar verificadores, selecciona las listas de direcciones de correo electrónico existentes o elige Crear lista de direcciones de correo electrónico para agregar las Cuentas de Google autorizadas para probar tu integración. Asegúrate de incluir tu propia dirección de correo electrónico si quieres probar la app.

  3. Selecciona Guardar.

  4. Los verificadores de la app de Gemini pueden invocar tu app conectada escribiendo @ seguido del nombre de la app conectada y seleccionándola en el menú. También puedes ver y conectar tu app en Gemini. Para ello, navega a Configuración y ayuda → Apps conectadas en la barra de navegación de la izquierda.

  5. Te recomendamos que pruebes exhaustivamente tu integración:

    • Prueba todas tus instrucciones de ejemplo.
    • Prueba las invocaciones explícitas de @<AppName> y las consultas de lenguaje natural.
    • Verifica el flujo de autenticación de extremo a extremo, la ejecución de la herramienta, los mensajes de confirmación del usuario y los recursos de la IU.

Cuando estés conforme con las pruebas, podrás enviar tu app conectada a Google para que la revise.

Paso 9: Inicia una revisión de tu app conectada y publícala después de que se apruebe

Antes de que tu app conectada esté disponible para todos los usuarios, Google revisa y prueba tu integración.

Para enviar tu app conectada para su revisión, haz lo siguiente:

  1. En la página de resumen de tu app conectada, en la tarjeta Versiones que se encuentra en el lado derecho de la página, selecciona Enviar para revisión (se habilita una vez que se completa la configuración de la app y se encuentra en versión preliminar sin problemas de bloqueo).

  2. Mientras se revisa tu versión, ten en cuenta lo siguiente:

    • Connected Console crea automáticamente una nueva versión de borrador editable para que los verificadores puedan seguir obteniendo una vista previa de tu app y puedas preparar ediciones futuras sin interrumpir la revisión.
    • Bloquea cualquier cambio en la versión en revisión.
    • Para ver los detalles de solo lectura de la versión en revisión o cancelar la revisión, selecciona el botón de más opciones (⋮) en la tarjeta En revisión y selecciona Ver detalles de la app o Cancelar revisión.

  3. Una vez que Google complete la revisión, recibirás una notificación y se actualizará la tarjeta Versiones:

    • Si se encuentran problemas: En la tarjeta Versiones, se muestra el mensaje Se encontraron problemas. Selecciona Ver problemas para inspeccionar los resultados específicos de la revisión. Actualiza tu configuración o el servidor de MCP en tu versión preliminar editable, verifica las correcciones con los verificadores y vuelve a seleccionar Enviar para revisión.
    • Si se aprueba: En la tarjeta Versiones, se mostrará el mensaje Lista para publicar. Selecciona Publicar cuando tengas todo listo para lanzar tu app conectada a los usuarios.

¡Felicitaciones! Tu app conectada ya se publicó y se está lanzando para los usuarios en los productos de Google que seleccionaste.

Administración de versiones posterior a la publicación y continua

Una vez que se publique, la tarjeta inferior de Versiones mostrará el estado Publicada junto con el número de versión publicada de tu app conectada, la fecha de publicación y el recuento de países o regiones, idiomas y productos de segmentación. Puedes seleccionar el menú de más opciones (⋮) en la tarjeta Publicada y seleccionar Ver detalles de la app en cualquier momento para inspeccionar la configuración de solo lectura de tu versión publicada.

Mientras la versión publicada permanece activa en producción, puedes usar el panel Edita y prueba tu app conectada de la izquierda (o seleccionar Crear nueva versión si no existe un borrador) para configurar, obtener una vista previa y probar las actualizaciones en una versión nueva (Version <N+1>) de forma independiente antes de enviarla para su revisión y publicación.