Guía para desarrolladores de servidores de MCP de Connected Apps Platform

Las Apps Conectadas ayudan a los usuarios a acceder a contenido y servicios en una amplia variedad de recorridos, dentro de los productos de Google aplicables.

Las apps conectadas proporcionan los siguientes beneficios.

  • Control sobre qué funciones y servicios se deben poner a disposición de la Connected Apps Platform: Mantienes un control detallado sobre el alcance de la integración.
  • Atribución y descubrimiento de la marca: Cuando seleccionas una plataforma de Google para integrarla con tu app, tu marca se destaca.
  • Mayor potencial de participación: Las apps conectadas ayudan a los usuarios a acceder a tu servicio para realizar acciones cuando las necesitan, lo que aumenta la probabilidad de una mayor participación y satisfacción de los usuarios.

Opciones de integraciones

Un servidor de MCP y las AppFunctions son las dos formas principales y complementarias de integrar las capacidades de tu app en los productos de Google aplicables.

  • Servidor de MCP (descrito en esta guía para desarrolladores):

    • Esta es nuestra ruta predeterminada recomendada para las capacidades fundamentales multiplataforma.
    • El servidor de MCP te permite escalar en Android, iOS y la Web. Si tienes APIs web existentes o un servidor de MCP remoto, puedes aprovecharlos con nuestra especificación de servidor de MCP. Esta es tu ruta para lograr el máximo alcance con la mínima sobrecarga.

  • MCP para Android (guía para desarrolladores)

    • Las AppFunctions están diseñadas para crear experiencias de Android integradas y más profundas. Las AppFunctions pueden aprovechar el contenido integrado en el dispositivo para resolver intents a través de una integración profunda con el SO Android y las plataformas de la IU del sistema.
    • Acciones que requieren contexto y una integración estrecha con el estado actual de una app
    • La compatibilidad está disponible a través de una biblioteca de Jetpack.

Proceso de extremo a extremo

En esta guía, se describe el proceso de extremo a extremo para compilar, probar, registrar y, luego, implementar un servidor remoto del Protocolo de contexto del modelo (MCP) para integrar tus servicios en los productos de Google aplicables.

Fase 1: Compilación: Desarrolla tu servidor de MCP remoto

Cuando desarrolles un servidor de MCP remoto con la especificación del Protocolo de contexto del modelo, te recomendamos que establezcas instrucciones del sistema estructuradas, anotaciones de seguridad explícitas, definiciones de esquemas claras y vinculaciones de metadatos de la IU.

  • Instrucciones explícitas del servidor: Cuando inicialices tu servidor de MCP, define instrucciones del servidor claras que describan tu dominio y capacidades. Debido a que los modelos de IA dependen de estas instrucciones del servidor para reconocer cuándo delegar tareas a tu servidor, te recomendamos proporcionar instrucciones claras del servidor para facilitar el enrutamiento preciso de los modelos en los productos de Google aplicables.
  • Anotaciones de herramientas de seguridad y ejecución: Declara anotaciones de protocolo explícitas para cada herramienta, como marcar las operaciones de consulta de solo lectura con readOnlyHint=True o las acciones destructivas o que cambian el estado con destructiveHint=True. También puedes marcar las operaciones que requieren confirmaciones en Google Connected Console.
  • Esquemas con tipos fuertemente definidos y cadenas de documentación semánticas: Proporciona tipos de argumentos explícitos y cadenas de documentación de parámetros detalladas. Documenta los valores de campo esperados con claridad (como los filtros de categoría o los parámetros de ubicación permitidos) para optimizar la exactitud de las llamadas a herramientas del modelo.
  • Vinculaciones de metadatos de recursos de IU (opcional): Vincula los resultados de la herramienta directamente a los recursos de IU personalizados definiendo anotaciones de metadatos (p.ej., meta={"ui": {"resourceUri": "ui://..."}}). Si se proporcionan, esto le indica al cliente que renderice widgets de IU interactivos, enriquecidos y con la marca en iframes de zona de pruebas seguros directamente dentro de la interfaz de conversación.

Fase 2: Validación (prueba de forma local con MCP Inspector)

Antes de alojar tu servicio de forma remota, valida las declaraciones de herramientas y la renderización de la interfaz en un entorno de zona de pruebas local.

  • Inicialización del servidor local: Ejecuta tu servidor de MCP remoto de forma local en tu máquina de desarrollo.
  • Validación de la herramienta Inspector: Conéctate al servidor local con la herramienta Inspector de MCP (npx @modelcontextprotocol/inspector).
  • Ejecución y verificación de la IU: Invoca herramientas individuales, inspecciona las cargas útiles de entrada y salida de JSON sin procesar, y confirma que los recursos de IU personalizados se rendericen como se espera directamente en tu navegador web.

Fase 3: Implementa y prueba con el modo de desarrollador de Gemini

Debes implementar tu servidor de MCP en un extremo HTTPS público para que esté disponible de forma remota y se pueda probar en el modo de desarrollador de Gemini. Puedes alojarlo en cualquier proveedor de servicios en la nube o infraestructura que prefieras.

El siguiente paso es validar tu endpoint público en el modo de desarrollador de Gemini.

  • Verificación de Gemini en vivo: Prueba la ejecución de herramientas en vivo con el modo de desarrollador de Gemini. Usa las pestañas de depuración integradas, como el registro de eventos, los esquemas de herramientas, la simulación de entorno (fecha, hora y ubicación) y la configuración de autenticación, para verificar las respuestas del modelo antes de solicitar la aprobación final y la publicación.

Fase 4: Registro: Configura con Google Connected Console

Después de validar la ejecución local, envía tu solicitud de acceso y registra los detalles de tu integración en Google Connected Console.

  • Solicitud de acceso: Solicita acceso con el formulario de interés.
  • Configuración y publicación de la consola: En Google Connected Console, define los detalles de tu app, configura la autenticación y los extremos, descubre herramientas, administra los entornos de vista previa y los verificadores, y envía tu aplicación para su revisión y publicación. Lee la guía.