Requisitos previos para usar apps conectadas

Antes de comenzar, asegúrate de tener lo siguiente:

  • Un servidor de MCP implementado con un endpoint HTTPS seguro

    Se debe poder acceder públicamente a tu servidor de MCP a través de HTTPS con el transporte HTTP transmisible (por ejemplo, https://api.yourdomain.com/v1/mcp).

    Consulta la guía para desarrolladores de servidores de MCP de Connected Apps Platform para obtener detalles de la implementación.

  • Asegúrate de que tu servidor pueda recibir solicitudes de Google

    Si tu servidor restringe el acceso externo por IP de origen, incluye en la lista de entidades permitidas las siguientes direcciones IP:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Los rangos de IP de salida de Google pueden cambiar con el tiempo, por lo que te recomendamos que los leas en las listas publicadas de Google y que actualices tu lista de entidades permitidas con regularidad:

  • Acceso a una cuenta de desarrollador registrada en Google Connected Console

    Después de acceder, asegúrate de tener uno de los siguientes permisos de Apps conectadas en Google Connected Console:

    • Ver apps conectadas
    • Crear y administrar apps conectadas

    El propietario o administrador de la cuenta también debe aceptar las Condiciones del Servicio de las Apps conectadas. La primera vez que tu organización acceda a las apps conectadas en Google Connected Console, el propietario o administrador de la cuenta deberá acceder y aceptar el acuerdo del programa antes de que los miembros del equipo invitados puedan continuar.

    Si crees que tienes acceso, pero no puedes crear apps conectadas, pídele al propietario de la cuenta o administrador que le otorgue a tu cuenta de usuario el permiso "Ver apps conectadas" o "Crear y administrar apps conectadas" en la página Usuarios y permisos.

  • Capacidad para alojar un archivo de verificación de .well-known en el dominio de tu servidor de MCP

    Para verificar la propiedad del dominio, debes poder entregar un archivo de token de desafío JSON directamente (con HTTP 200 OK y sin redireccionamientos) en https://<your-domain>/.well-known/google-connected-apps.

  • Revisa las categorías de apps conectadas disponibles

    La categoría de tu app conectada se asocia con funciones específicas que debe admitir para garantizar una experiencia del usuario de alta calidad. Una vez que se selecciona una categoría para una app conectada, no se puede cambiar. Obtén más información.

  • Un servidor de MCP implementado con una URL de extremo válida

    Consulta la guía para desarrolladores de servidores de MCP de apps conectadas para obtener más detalles.

  • Metadatos públicos y recursos de marca para tu app conectada

    • Nombre de la app conectada: Es el nombre visible de tu app conectada que se muestra a los usuarios en los productos de Google y que se usa cuando los usuarios mencionan tu app con @.
    • Descripción: Es un resumen conciso de una sola oración (menos de 30 palabras) de lo que tu app conectada puede hacer por los usuarios, como "Haz un seguimiento de tus compras recientes, consulta el estado de entrega y consulta tu historial de pedidos".
    • Ícono: Es un ícono de la app de 512 px × 512 px en formato JPEG o PNG, con un tamaño de archivo máximo de 1 MB (1,024 KB).
    • Capacidades: Al menos 3 tareas de alto valor que tu app conectada puede realizar, como "Buscar en tu historial de pedidos" o "Verificar el estado de la entrega en vivo", más allá de las capacidades predeterminadas definidas por la categoría de tu app. Se muestran a los usuarios para ayudarlos a decidir si quieren conectarla. No incluyas números al principio de tus capacidades.
    • Instrucciones de ejemplo: Al menos 3 consultas de ejemplo que ayuden a los usuarios a comprender qué pueden preguntar. Comienza al menos 2 instrucciones de ejemplo con el nombre de tu app conectada. Menciona el nombre de tu app de forma natural en al menos 1 instrucción (es decir, sin comenzar con el nombre de tu app). No incluyas números al principio de tus instrucciones de ejemplo.
    • URL de las Condiciones del Servicio: Es una URL de acceso público para las Condiciones del Servicio de tu app conectada.
    • URL de la política de privacidad: Es una URL de acceso público para la política de privacidad de tu app conectada.
    • URL del sitio web (opcional): Es un sitio web para tu app conectada.