mailinapp
Documentation menu

Conectar Gemini

Gemini llega al servidor MCP de MailInApp a través de tres superficies distintas, según qué producto de Gemini uses. Las tres apuntan a la misma URL, https://mailinapp.com/api/mcp.

App de Gemini (Spark) — consumidor, autoservicio

  1. Ve a gemini.google.com → Configuración y ayuda → Apps conectadas → Apps personalizadas para Spark → Agregar una app personalizada.
  2. Pega https://mailinapp.com/api/mcp como la URL del servidor.
  3. Aprueba la pantalla de consentimiento de OAuth de MailInApp cuando Gemini la abra.

Nada que enviar ni revisar — esta es una conexión de autoservicio, igual que pegar la URL en Claude. Google actualmente restringe las apps personalizadas de Spark a cuentas de Google personales, de EE. UU., mayores de 18 años, con "Mantener actividad" activado y la app de Gemini configurada en inglés — estas son restricciones propias de Google sobre la función, no algo que imponga MailInApp, así que un intento de conexión fuera de ellas falla del lado de Gemini antes de siquiera llegar a MailInApp.

Gemini Enterprise — almacén de datos de servidor MCP personalizado

La integración de MCP personalizado de Gemini Enterprise está desactivada por defecto, detrás de una política de organización que controla tu administrador de Google Workspace, y su configuración de autenticación es manual en lugar de un flujo de pegar-una-URL: un administrador ingresa la URL de autorización, la URL de token, un id y secreto de cliente, y los alcances a solicitar, en lugar de que el cliente se registre a sí mismo.

  • URL de autorización: https://mailinapp.com/oauth/authorize
  • URL de token: https://mailinapp.com/oauth/token
  • Alcances: cualquier combinación de Alcances y permisos, separados por espacios.
  • PKCE: activado (S256).
  • Id/secreto de cliente: Gemini Enterprise requiere un cliente confidencial preregistrado en lugar del registro dinámico que usa Claude — contacta a [email protected] con el URI de redirección que usa tu tenant de Gemini Enterprise y te emitiremos uno.

Dos cosas que vale la pena saber antes de configurar esto: la integración de MCP de Gemini Enterprise es solo Streamable HTTP (sin SSE, que el servidor de MailInApp de todos modos no usa), y limita un almacén de datos a 100 acciones habilitadas — la superficie completa de herramientas de MailInApp se mantiene cómodamente por debajo de eso, así que no hace falta desactivar nada de tu lado.

Antigravity CLI

Antigravity CLI (el sucesor de Gemini CLI) toma cualquier servidor MCP a través de un archivo de configuración en lugar de una pantalla de configuración dentro del producto. Agrega una entrada a mcp_config.json (o .agents/mcp_config.json):

{
  "mcpServers": {
    "mailinapp": {
      "url": "https://mailinapp.com/api/mcp"
    }
  }
}

Antigravity CLI se encarga del flujo de OAuth la primera vez que se conecta, la misma pantalla de consentimiento que cualquier otro cliente.

Prueba tu conexión

Antes de resolver problemas del lado de Gemini, confirma que el protocolo de enlace de MCP en sí funcione bien con el MCP Inspector:

npx @modelcontextprotocol/inspector https://mailinapp.com/api/mcp

Si el Inspector lista las herramientas de MailInApp y abre la pantalla de consentimiento de OAuth, el lado del servidor está bien — cualquier falla restante es una de las restricciones propias de cuenta/región de Gemini de abajo, no de MailInApp.

Una trampa que vale la pena conocer: la interfaz del Inspector puede establecer por defecto su destino de conexión a un marcador de posición local (por ejemplo, http://0.0.0.0:8080) en lugar de la URL que pasaste en la línea de comandos. Si la autorización intenta redirigir a algún lugar inalcanzable como ese en lugar de abrir la pantalla de consentimiento de MailInApp, revisa el campo URL dentro del propio Inspector y confirma que diga la URL completa https://mailinapp.com/api/mcp — volver a escribirla y reconectar resuelve esto. Es una peculiaridad de la propia configuración de transporte del Inspector, no algo que esté haciendo el servidor de MailInApp.

Ser descubierto

Gemini no tiene proceso de envío ni revisión para la lista de Apps conectadas por defecto de la forma en que Claude tiene un directorio — no hay nada a lo que postularse, y nada que MailInApp pueda hacer para aparecer listado ahí. La URL de arriba es todo el mecanismo de distribución para Spark. Si quieres que MailInApp se pueda encontrar y no solo alcanzar mediante un enlace compartido, publícalo en un registro comunitario de MCP — PulseMCP, Smithery, y el directorio oficial modelcontextprotocol/servers indexan todos los servidores MCP remotos de la misma manera. Nada de esto afecta a Gemini Enterprise, que se configura directamente por un administrador en lugar de descubrirse.

Si una conexión deja de funcionar

  • No aparece la opción "Add a custom app" en Apps conectadas — esta es una restricción de elegibilidad propia de Google, no de MailInApp: la función de apps personalizadas de Spark requiere una cuenta de Google personal, de EE. UU., mayor de 18 años, con "Mantener actividad" activado, y la app de Gemini configurada en inglés. La opción no aparecerá en absoluto fuera de esas restricciones, sin importar nada del lado de MailInApp.
  • Conexión Enterprise rechazada por la configuración de tu administrador — el id/secreto de cliente que emitió MailInApp está vinculado al URI de redirección exacto que tu tenant proporcionó en la configuración. Si ese URI cambia, escribe a [email protected] con el nuevo en lugar de reutilizar el cliente anterior.
  • Antigravity CLI reporta un error de conexión — verifica que mcp_config.json sea JSON válido y que el campo url diga exactamente https://mailinapp.com/api/mcp; un objeto mcpServers mal formado es la causa más común.
  • Cambiaste de equipo, o un compañero de equipo revocó tu acceso — como en cualquier otra plataforma, un token de conector de Gemini se revalida contra tu membresía de cuenta activa en cada llamada, así que perder acceso a una empresa desactiva las llamadas de esa conexión de inmediato, sin que tengas que hacer nada de tu lado en Gemini.

Revocar

Sin importar a través de cuál superficie de Gemini te conectaste, Conexiones en el panel de MailInApp (/dashboard/connections) lo lista junto a cualquier otro asistente con un botón de Revocar de un clic — el token deja de funcionar en su siguiente llamada.