ES
Cursor · Servidor MCP

Servidor MCP para Cursor: mensajería y email en su IDE

Una URL y una cabecera añaden el servidor MCP de Unipile a Cursor. Después, su agente construye funciones de LinkedIn, WhatsApp y email 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.
Cursor · crm-app
Unipile MCP conectado
Sarah
Añade la conexión de cuentas de LinkedIn a mi CRM.
Leer endpointPOST /v2/auth/linkesquema cargado
Se han añadido la ruta de conexión y el botón en Ajustes. El ID de la cuenta se guarda en 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 Cursor

Añada LinkedIn, WhatsApp, email o calendario a su producto. A través del servidor MCP de Unipile, Cursor 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 CursorUnipile 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
mcp.json, global o de proyecto

Añada el servidor MCP de Unipile a Cursor

El servidor es remoto: una URL sobre streamable HTTP y una cabecera, nada que ejecutar en local. Elija global o de proyecto, pegue el bloque, guarde, y Cursor lo carga.
Antes de empezar: Cursor actualizado, 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.
G
Configuración global~/.cursor/mcp.json
P
Configuración de proyecto.cursor/mcp.json (raíz del repositorio)
E
Clave desde una variable de entorno${env:UNIPILE_API_KEY}
?
¿Global o de proyecto?De proyecto cuando cada repositorio necesita su propia clave con scope. Cursor lee primero la de proyecto y después la global.
~/.cursor/mcp.json
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "your-scoped-api-key" } } } }
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "your-scoped-api-key" } } } }
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "${env:UNIPILE_API_KEY}" } } } }
Guarde el archivo y Cursor carga el servidor. ${env:NAME} funciona en url y headers, así que la clave nunca queda en el archivo.

Verifique la conexión

  1. 1Abra Customize en la barra lateral: el servidor unipile aparece en la lista, activado.
  2. 2En la CLI de Cursor, ejecute agent mcp list, o /mcp list dentro de una sesió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.
Opcional: instalación en un clic Pegue su clave Account API con scope para obtener un enlace que abre Cursor con el servidor ya configurado. La clave nunca sale de su navegador.
Añadir Unipile a Cursor
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 Cursor, los endpoints que ejecuta el agente en https://api.unipile.com con su X-API-KEY, y lo que llega a su proyecto.
Cursor · ats-appApp de Development
Añade la mensajería de LinkedIn a mi ATS: sincroniza la bandeja de entrada de cada reclutador y permite responder desde la ficha del candidato.
Buscar endpoints"chats messages send"3 resultados
Ejecutar peticiónGET /v2/{account_id}/chats12 chats
Se ha creado linkedin/inbox-sync.ts (chats y mensajes guardados en el candidato, paginación por cursor) y POST /candidates/:id/reply, que llama a la ruta de envío con el ID de cuenta del propio chat. Sincronización ejecutada en la app de Development: 12 chats, 87 mensajes.3 archivos modificados · probado en la app de Development

Pegue el prompt, revise el diff

Cursor lee los contratos de chats y mensajes, escribe el job de sincronización y el endpoint de respuesta, y lanza las primeras peticiones en su aplicación de Development. WhatsApp, Instagram, Facebook y Telegram usan las mismas rutas de chat.
Endpoints que usa el agente
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Construya una integración de LinkedIn
Cursor · crm-appApp de Development
Implementa Unipile Hosted Auth en esta app React y Fastify para que los usuarios conecten su propia cuenta de LinkedIn desde Ajustes.
Leer endpointPOST /v2/auth/linkesquema cargado
Ejecutar peticiónPOST /v2/auth/link201 · link
Se ha añadido POST /api/accounts/connect en Fastify: crea el enlace de autenticación en el servidor y devuelve la URL alojada. La página de Ajustes en React la abre y, al volver, guarda el nuevo account_id en el workspace. Verificado en la app de Development con una cuenta de LinkedIn de prueba.4 archivos modificados · flujo de conexión probado

Sus usuarios conectan sus propias cuentas y su app obtiene un ID de cuenta

Hosted Auth es la página que sirve Unipile para que sus usuarios vinculen sus propias cuentas. El agente conecta el enlace en su backend, la redirección en su frontend y el almacenamiento del ID de cuenta.
Endpoints que usa el agente
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Implemente Hosted Auth con un agente
Cursor · support-consoleApp de Development
Suscríbete a los webhooks de mensajes nuevos y crea una bandeja unificada de LinkedIn, WhatsApp y email, con una sola lista de hilos y el canal como etiqueta.
Leer endpointPOST /v2/webhooks/endpoints/esquema cargado
Ejecutar peticiónGET /v2/{account_id}/emails200 OK
Se ha registrado un endpoint de webhook para los eventos de mensajes en la app de Development y se ha añadido POST /webhooks/unipile que devuelve 200 de inmediato y pone el evento en cola, un modelo Thread que lleva chats e hilos de email a una misma forma, y la lista de hilos con etiquetas de canal. Mensaje de prueba enviado: la lista se actualizó en menos de un segundo.6 archivos modificados · 3 canales en una lista

Tiempo real sin polling, una sola lista para mensajería y email

El agente lee los contratos de chats y emails, diseña un único modelo de hilo y escribe la sincronización y el receptor de webhooks. Después comprueba el registro de entregas con la ruta de conversaciones de webhooks.
Endpoints que usa el agente
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Construir una bandeja unificada con un agente
Primero, una aplicación de Development Dé a Cursor 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

Los mensajes que muestra Cursor cuando una entrada MCP no es correcta, y la solución de cada uno.
No tools or prompts
Revise el archivo que editó (~/.cursor/mcp.json o .cursor/mcp.json), elimine cualquier coma final y recargue el servidor desde Customize.
No server info found
Use una entrada remota con url fijado exactamente en https://developer.unipile.com/mcp?branch=v2.0 y headers, sin command ni type: "stdio".
Connection failed
Revise el host y ?branch=v2.0 por si hay una errata, o un proxy corporativo: la URL debe responder en un navegador, no con un 404.
401 Unauthorized en las peticiones
Envíe una clave Account API con scope de su aplicación de Development en headers, con el nombre exacto X-API-KEY.
La configuración de proyecto se ignora
Coloque .cursor/mcp.json en la raíz de la carpeta que abrió en Cursor, no en una subcarpeta.
Dónde leer los logs
Abra el panel Output (Cmd+Shift+U en macOS, Ctrl+Shift+U en Windows y Linux) y seleccione MCP Logs en el desplegable.
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 para Cursor

Las preguntas que la gente escribe de verdad: dónde está mcp.json, global o por proyecto, servidores remotos y cabeceras, qué revisar cuando no aparece nada, claves, instalación en un clic y la CLI.
En dos lugares. ~/.cursor/mcp.json en su carpeta personal es la configuración global, disponible en todos los proyectos. .cursor/mcp.json en la raíz de la carpeta que abrió en Cursor es la configuración del proyecto. Cursor lee primero el archivo del proyecto, luego el global y después los directorios superiores. Ambos admiten el mismo bloque mcpServers .
De forma global si construye varias integraciones de Unipile desde una misma máquina y una misma aplicación de Development. Por proyecto si cada repositorio necesita su propia clave con scope, que es la opción correcta cuando las integraciones de Development y Production viven en repositorios distintos. En ambos casos, la clave es una clave Account API con scope, nunca una clave de Service ni global.
Sí. Una entrada remota en mcp.json admite un campo url y un headers de tipo objeto, y Cursor resuelve ${env:NAME} en ambos. El servidor de Unipile es exactamente eso: HTTP streamable en https://developer.unipile.com/mcp?branch=v2.0 con la cabecera X-API-KEY . Sin npx, sin proceso local, sin versión de Node que gestionar.
En este orden: el archivo que editó (global o de proyecto, en la raíz del repositorio), la validez del JSON, una recarga del servidor desde Customize o un reinicio de Cursor, y luego los MCP Logs en el panel Output (Cmd+Shift+U, seleccione MCP Logs). Si el servidor se conecta pero las peticiones fallan con 401, falta la clave en la cabecera o no es una clave Account API con scope.
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.
Sí. El enlace de instalación de esta página codifica la configuración del servidor; abre Cursor con la entrada unipile ya rellenada y usted sustituye el marcador de posición por su clave con scope. El generador opcional de arriba crea el mismo enlace con su clave ya incluida, íntegramente en su navegador.
Sí. La CLI comparte la configuración del editor: primero la del proyecto, luego la global. agent mcp list muestra los servidores configurados y su estado, y /mcp list hace lo mismo dentro de una sesión interactiva. Después, el agente usa el servidor de Unipile cuando una petición lo requiere.