ES
Gemini CLI · Servidor MCP

Servidor MCP para Gemini CLI: mensajería, email y calendario

Un solo comando gemini mcp add conecta el servidor MCP de Unipile. Después, su agente construye funciones de LinkedIn, WhatsApp, email y calendario en su proyecto y prueba cada llamada en su aplicación de Development. Nada que instalar ni ejecutar en local.
Prueba gratis de 7 días, sin tarjeta.
Gemini CLI · booking-app
Unipile MCP conectado
Sarah
Añade la agenda de citas a mi app de reservas.
Leer endpointGET /v2/{account_id}/calendarsesquema cargado
Se han añadido la ruta de disponibilidad y la ruta de reserva. Los eventos se crean en el calendario que conectó el usuario.
3 archivos modificados · probado en la app de Development
Describa la próxima función…
Caso de uso

Añada LinkedIn, WhatsApp y email a su producto desde Gemini CLI

Añada LinkedIn, WhatsApp, email o calendario a su producto. A través del servidor MCP de Unipile, Gemini CLI lee la referencia de la API, escribe el código en su stack y prueba cada petición.
Conecte el servidor MCP de Unipile a Gemini CLIUnipile MCP conectado
Seleccione los canales que quiere conectardeveloper.unipile.com/mcp
Conectar todos los canales10 canales
LinkedInLinkedIn/v2/{account_id}/chats
WhatsAppWhatsApp/v2/{account_id}/chats
InstagramInstagram/v2/{account_id}/chats
TelegramTelegram/v2/{account_id}/chats
GmailGmail/v2/{account_id}/emails
OutlookOutlook/v2/{account_id}/emails
IMAPIMAP/v2/{account_id}/emails
Google CalendarGoogle Calendar/v2/{account_id}/calendars
Outlook CalendarOutlook Calendar/v2/{account_id}/calendars
↑↓navegar espacioseleccionar ↵conectaruna URL, una cabecera
settings.json, de usuario o de proyecto

Añada el servidor MCP de Unipile a Gemini CLI

El servidor es remoto: una URL sobre streamable HTTP y una cabecera, nada que ejecutar en local. Un solo comando lo escribe en settings.json, de usuario o de proyecto, y Gemini CLI se conecta al arrancar.
Antes de empezar: Gemini CLI con sesión iniciada, en una carpeta de confianza, una aplicación de Development en el dashboard de Unipile con una clave Account API con scope, y una cuenta de prueba vinculada mediante Hosted Auth.
1
gemini mcp add, una líneaescribe settings.json por usted
U
Ajustes de usuario~/.gemini/settings.json
P
Ajustes de proyecto.gemini/settings.json (scope por defecto)
E
Clave desde una variable de entorno$UNIPILE_API_KEY en headers
?
¿De usuario o de proyecto?El comando usa por defecto el scope de proyecto (.gemini/settings.json). Pase --scope user para todos los proyectos de la máquina.
terminal
# Registre el servidor MCP alojado de Unipile para todos los proyectos (scope user) gemini mcp add --transport http --scope user \ --header "X-API-KEY: your-scoped-api-key" \ unipile "https://developer.unipile.com/mcp?branch=v2.0" # MCP server "unipile" added to user settings. (http) # Verifique, o escriba /mcp dentro de una sesión gemini mcp list # ✓ unipile: https://developer.unipile.com/mcp?branch=v2.0 (http) - Connected
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "type": "http", "headers": { "X-API-KEY": "your-scoped-api-key" } } } }
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "type": "http", "headers": { "X-API-KEY": "$UNIPILE_API_KEY" } } } } // Versionado con el repositorio: mantenga la clave en el entorno, no en el archivo.
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "type": "http", "headers": { "X-API-KEY": "${{UNIPILE_API_KEY}}" } } } } // export UNIPILE_API_KEY=your-scoped-api-key antes de lanzar gemini
Guarde el archivo y lance gemini en una carpeta de confianza. Verificado en gemini-cli 0.60.0.
httpUrl o url. Escriba httpUrl, o url con "type": "http": una url a secas se interpreta como SSE y aparece como Disconnected. Guarde la clave en $UNIPILE_API_KEY y deje sin definir la opción trust del servidor, para que Gemini CLI siga confirmando cada acción.

Verifique la conexión

  1. 1Desde el terminal, gemini mcp list muestra unipile como Connected; Disabled significa que la carpeta no es de confianza.
  2. 2Dentro de una sesión, /mcp lista todos los servidores con su estado, y /mcp desc describe cada acción.
  3. 3En un chat, pida Con el MCP de Unipile, lista los endpoints de búsqueda de personas en LinkedIn y sus parámetros obligatorios y espere rutas reales como respuesta.
Prompts, no código de pegamento

Dé el prompt a su agente

Tres trabajos de integración, cada uno con el prompt para pegar en Gemini CLI, los endpoints que ejecuta el agente en https://api.unipile.com con su X-API-KEY, y lo que llega a su proyecto.
Gemini CLI · booking-appApp de Development
Añade la programación de citas a mi app de reservas: lee la disponibilidad de cada usuario durante una semana y crea la reunión en el calendario que conectó, Google u Outlook.
Leer endpointGET /v2/{account_id}/calendars/{calendar_id}/eventsesquema cargado
Ejecutar peticiónPOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Se han añadido GET /api/availability (eventos en la ventana solicitada, franjas ocupadas calculadas en el servidor) y POST /api/bookings, que crea el evento con sus asistentes en el calendario del usuario y guarda el ID de evento devuelto. Las zonas horarias se toman del calendario. Evento de prueba creado en la app de Development.4 archivos modificados · probado en la app de Development

Disponibilidad y creación de eventos en el calendario que conectó su usuario

Google Calendar y Outlook Calendar comparten las mismas rutas de calendario. Gemini CLI lee los esquemas de calendario, evento y asistente, escribe la lógica de disponibilidad y la ruta de reserva, y crea un evento en un calendario de prueba.
Endpoints que usa el agente
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Ver todos los canales del servidor MCP de Unipile
Gemini CLI · support-inboxApp de Development
Nuestra bandeja ya sincroniza LinkedIn y WhatsApp con Unipile. Añade Instagram y Telegram con el mismo modelo de hilos y el mismo endpoint de respuesta.
Buscar endpoints"chats messages attendees"3 resultados
Ejecutar peticiónGET /v2/{account_id}/chats200 OK
Sin modelo nuevo: los chats de Instagram y Telegram pasan por las mismas rutas de chats y mensajes, así que el job de sincronización recorre ahora todas las cuentas conectadas sea cual sea el proveedor, y el endpoint de respuesta envía desde la cuenta propia del chat. Se han añadido las dos etiquetas de proveedor y se ha ejecutado la sincronización en la app de Development con una cuenta de prueba de Instagram y otra de Telegram.3 archivos modificados · 4 canales en una lista

Mismas rutas, dos canales más, ningún modelo nuevo

Todos los proveedores de mensajería usan las mismas rutas de chat, así que ampliar una bandeja consiste en vincular cuentas mediante Hosted Auth. El agente revisa los campos propios de cada proveedor y mantiene intacto su modelo de hilos.
Endpoints que usa el agente
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Construir una bandeja unificada con un agente
Gemini CLI · crm-appApp de Development
Revisa mi integración actual de Unipile en busca de ID incorrectos, reintentos inseguros y llamadas que deberían ser webhooks, y propón las correcciones.
Leer endpointPOST /v2/{account_id}/chats/{chat_id}/messages/sendesquema cargado
Leer endpointPOST /v2/webhooks/endpoints/esquema cargado
Tres problemas encontrados: la llamada de envío usaba la primera cuenta del workspace en lugar de la cuenta del chat; el wrapper de reintentos reenviaba mensajes tras un timeout; la bandeja consultaba la ruta de chats cada 30 segundos. Parches propuestos: ID de cuenta tomado del chat, reintentos limitados a las lecturas, un endpoint de webhook para los eventos de mensajes. Aplicados y verificados en la app de Development.3 hallazgos · 3 parches · verificado en la app de Development

Una auditoría frente al contrato real, no frente a la memoria

El agente compara su código con los esquemas reales de petición y respuesta: campos de cuenta, llamadas idempotentes, bucles de polling que los webhooks sustituyen. La revisión llega como un diff, probado en su aplicación de Development.
Endpoints que usa el agente
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Conecte webhooks con un agente
Primero, una aplicación de Development Dé a Gemini CLI una clave con scope de una aplicación de Development, separada de Production.
Cuentas de prueba, peticiones reales El agente ejecuta peticiones en cuentas de prueba, en nombre del usuario autenticado que las vinculó, dentro de los límites de cada proveedor.
Valide cada flujo Compruebe el flujo de conexión, una lectura y una escritura por función, y la entrega de un webhook.
Después, pase a Production Nada toca las cuentas de sus usuarios hasta que cambie la clave. Consulte seguridad y compliance.
Resolución de problemas

Errores habituales y qué significan

Lo que muestran gemini mcp list y /mcp cuando una entrada no es correcta, y la solución de cada caso.
No MCP servers configured.
Coloque mcpServers en el nivel superior de ~/.gemini/settings.json o .gemini/settings.json, sin coma final.
Disconnected
Use httpUrl, o url con "type": "http", ya que una url a secas se interpreta como SSE.
Disabled, carpeta sin confianza
Acepte el aviso de confianza en el primer arranque, o ejecute gemini trust en el proyecto.
Añadido en el sitio equivocado
Añada --scope user a gemini mcp add, que por defecto usa el archivo de proyecto .gemini/settings.json.
401 Unauthorized en las peticiones
Connected no comprueba la clave: exporte la variable indicada en headers y use una clave Account API con scope.
Timed out
Revise la red, cualquier proxy y la URL antes de definir timeout en la entrada.
6000+ Empresas que innovan con Unipile
La confianza de los líderes del sector
1 API
Racionalizar las operaciones de los principales canales de comunicación
2 días
Rápida integración en directo con una configuración mínima
30%
Reducción de los esfuerzos y recursos de mantenimiento

Seguridad y conformidad integradas

Protección de nivel empresarial para sus datos y flujos de trabajo Más información sobre nuestra seguridad
SOC 2 Tipo II
SOC 2 Tipo II
Certificado
Controles de seguridad auditados de forma independiente que garantizan la protección de datos y la integridad operativa.
GDPR
GDPR
Conforme
Pleno cumplimiento de la normativa europea de protección de datos para la privacidad de los usuarios.
99.9%
Tiempo de actividad de la plataforma en los últimos 24 meses
24/7
Asistencia global con API de alto rendimiento

FAQ del servidor MCP en Gemini CLI

Las preguntas que la gente escribe de verdad: httpUrl o url, dónde vive settings.json, un comando en lugar de JSON, cómo mantener la clave fuera del archivo, Disconnected, No MCP servers configured, la extensión de VS Code y las claves.
La documentación define httpUrl como el endpoint streamable HTTP y url como un endpoint SSE. El comando gemini mcp add --transport http escribe url junto con "type": "http", y ambas formas conectan en las versiones actuales. Si escribe el archivo a mano, use httpUrl: una url sin type se interpreta como SSE, la causa más citada de un servidor Disconnected.
Los ajustes de usuario en ~/.gemini/settings.json, los de proyecto en .gemini/settings.json en la raíz de su proyecto, ambos bajo la clave mcpServers , y los de proyecto tienen prioridad sobre los de usuario. Ojo con el valor por defecto del comando: gemini mcp add escribe en el scope de proyecto salvo que pase --scope user.
Sí, y es la vía recomendada: gemini mcp add --transport http --scope user --header "X-API-KEY: your-scoped-api-key" unipile "https://developer.unipile.com/mcp?branch=v2.0". El flag --header es repetible y puede ir en cualquier posición del comando. Verificado en gemini-cli 0.60.0.
Escriba el valor de la cabecera como "$UNIPILE_API_KEY" o "${UNIPILE_API_KEY}". Gemini CLI expande las variables de entorno en settings.json, cabeceras incluidas, así que el archivo de proyecto se puede versionar sin ningún secreto y cada desarrollador exporta su propia clave Account API con scope antes de lanzar gemini.
Por orden: la clave de transporte (httpUrl para streamable HTTP, o url con "type": "http"), un settings.json de proyecto que sobrescriba el suyo o al revés, la confianza de la carpeta (una carpeta sin confianza desactiva todos los servidores) y, por último, un estado Disconnected mientras las acciones funcionan, que viene de un ping opcional de la especificación. Ejecute gemini mcp list, y después /mcp dentro de una sesión.
Gemini CLI no ha encontrado ninguna entrada mcpServers en la configuración que lee desde la carpeta actual. Compruebe que el archivo está en ~/.gemini/ o en .gemini/ en la raíz del proyecto, que mcpServers está en el nivel superior del JSON y que el JSON es válido: una coma de más basta para que se ignore el archivo.
Esta página cubre Gemini CLI en el terminal, y la configuración descrita aquí es el settings.json que lee la CLI. La extensión tiene sus propios ajustes MCP en VS Code; consulte su documentación antes de dar por hecho que el archivo es compartido.
El servidor responde sin clave cuando el agente solo lee la especificación de la API. Para ejecutar peticiones reales, cree un Scope en su aplicación de Development, asigne las cuentas de prueba y genere una clave Account API con scope para ese Scope. Nunca dé a un cliente MCP una clave Service ni una clave Account global.