Guías de integración
Guía de la API de LinkedIn
Guía de la API de email
Guía de la API de WhatsApp
Contactar con ventas
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
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.
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 conectar
developer.unipile.com/mcpConectar todos los canales10 canales
↑↓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.
gemini mcp add, una líneaescribe settings.json por usted
Ajustes de usuario~/.gemini/settings.json
Ajustes de proyecto.gemini/settings.json (scope por defecto)
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.
# 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
- 1Desde el terminal,
gemini mcp listmuestra unipile como Connected; Disabled significa que la carpeta no es de confianza. - 2Dentro de una sesión,
/mcplista todos los servidores con su estado, y/mcp descdescribe cada acción. - 3En un chat, pida
Con el MCP de Unipile, lista los endpoints de búsqueda de personas en LinkedIn y sus parámetros obligatoriosy 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.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.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
Ver todos los canales del servidor MCP de Unipile
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
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.
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
Construir una bandeja unificada con un agente
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
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.
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
Conecte webhooks con un agente
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
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
Certificado
Controles de seguridad auditados de forma independiente que garantizan la protección de datos y la integridad operativa.
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.