ES
Claude Code · Servidor MCP

Servidor MCP para Claude Code: mensajería y email en su app

Un solo comando claude mcp add conecta el servidor MCP de Unipile. Después, Claude Code 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.
Claude Code · 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 Claude Code

Añada LinkedIn, WhatsApp, email o calendario a su producto. A través del servidor MCP de Unipile, Claude Code 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 Claude CodeUnipile 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
claude mcp add, tres scopes

Añada el servidor MCP de Unipile a Claude Code

El servidor es remoto: una URL sobre streamable HTTP y una cabecera, nada que ejecutar en local. Un solo comando lo registra; el scope que elija decide dónde se carga.
Antes de empezar: Claude Code instalado y con sesión iniciada, 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.
U
Scope user--scope user · todos los proyectos, privado para usted
P
Scope project.mcp.json en la raíz del repositorio, compartido
L
Scope local (por defecto)solo este proyecto, privado, en ~/.claude.json
?
¿Qué scope elegir?User para todos los proyectos, project para compartir .mcp.json con el equipo, local para una prueba puntual.
terminal
# Scope user: todos los proyectos de esta máquina, privado para usted claude mcp add --transport http --scope user \ unipile "https://developer.unipile.com/mcp?branch=v2.0" \ --header "X-API-KEY: your-scoped-api-key" # Claude Code muestra "Added …" y después: claude mcp list
// Scope project: versionado en la raíz del repositorio, compartido con el equipo { "mcpServers": { "unipile": { "type": "http", "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "${UNIPILE_API_KEY}" } } } } // "type": "http" es obligatorio; cada desarrollador exporta UNIPILE_API_KEY
# Scope local (por defecto): solo este proyecto, privado, en ~/.claude.json claude mcp add --transport http \ unipile "https://developer.unipile.com/mcp?branch=v2.0" \ --header "X-API-KEY: your-scoped-api-key"
Verificado en Claude Code 2.1. Ponga la URL entre comillas (zsh interpreta el ? como un patrón) y deje --header al final.

Verifique la conexión

  1. 1Desde el terminal, claude mcp list muestra ✔ Connected, y claude mcp get unipile muestra los detalles.
  2. 2Dentro de una sesión, /mcp muestra el estado y aprueba la primera vez un .mcp.json de scope project.
  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 Claude Code, los endpoints que ejecuta el agente en https://api.unipile.com con su X-API-KEY, y lo que llega a su proyecto.
Claude Code · support-consoleApp de Development
Añade la mensajería de WhatsApp a nuestra consola de soporte: sincroniza las conversaciones de cada agente y permite responder desde el ticket.
Buscar endpoints"chats messages send"3 resultados
Ejecutar peticiónGET /v2/{account_id}/chats9 chats
Se ha creado whatsapp/chat-sync.ts (chats y mensajes guardados en el ticket, paginación por cursor) y POST /tickets/:id/reply que llama a la ruta de envío con la cuenta propia del chat. Sincronización ejecutada en la app de Development: 9 chats, 41 mensajes.3 archivos modificados · probado en la app de Development

Una bandeja de entrada de WhatsApp en su producto, con un solo prompt

Claude Code 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. LinkedIn, 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
API de WhatsApp
Claude Code · crm-appApp de Development
Permite a los usuarios enviar emails desde la ficha del contacto con su propio buzón de Gmail u Outlook, y agrupa las respuestas en hilos en el contacto.
Leer endpointPOST /v2/{account_id}/emails/sendesquema cargado
Ejecutar peticiónGET /v2/{account_id}/emails200 OK
Se ha añadido POST /contacts/:id/email que llama a la ruta de envío en la cuenta de buzón del usuario, la opción de responder en el hilo con el ID del hilo y la sincronización entrante que asocia las respuestas al contacto. Email de prueba enviado desde el buzón de la app de Development: la respuesta aparece en el hilo.4 archivos modificados · envío e hilos probados de principio a fin

Email desde el propio buzón del usuario, en hilos dentro de su CRM

Gmail, Outlook e IMAP comparten un mismo esquema de email. El agente conecta la acción de envío al buzón que conectó el usuario y conserva el ID del hilo, para que las respuestas lleguen al contacto correcto.
Endpoints que usa el agente
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
API de email
Claude Code · saas-backendApp de Development
Cada workspace de mi SaaS tiene varios usuarios con sus propias cuentas de LinkedIn y email. Aíslalos: un Scope y una clave con scope por workspace.
Buscar endpoints"scopes api-keys"4 resultados
Ejecutar peticiónPOST /v2/scopes/201 · scope
Al crear un workspace, el backend crea ahora un Scope y una clave Account API con scope, guardada cifrada en el workspace, y cada cuenta que conecta un miembro se asigna a ese Scope. Todas las llamadas de cuenta usan la clave del workspace. Probado con dos workspaces en la app de Development.5 archivos modificados · aislamiento verificado

Muchos usuarios, muchas cuentas, un límite por tenant

Una clave con scope solo ve las cuentas asignadas a su Scope. El agente convierte ese límite en su modelo de tenants: la lógica multicuenta vive en la API, no en su código.
Endpoints que usa el agente
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Cuentas, Scopes y claves
Primero, una aplicación de Development Dé a Claude Code 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 estados que muestran claude mcp list y /mcp cuando una entrada no es correcta, y la solución de cada uno.
✘ Failed to connect
Use exactamente https://developer.unipile.com/mcp?branch=v2.0 con --transport http, y compruébelo con claude mcp get unipile.
⏸ Pending approval
Ejecute claude en la carpeta, acepte el diálogo de confianza del workspace y apruebe después el servidor desde /mcp.
401 en las peticiones
Envíe una clave Account API con scope de su aplicación de Development, con el nombre de cabecera exacto X-API-KEY.
Aviso de variable ausente
Exporte UNIPILE_API_KEY en el shell que inicia Claude Code, o defina un valor por defecto con ${UNIPILE_API_KEY:-}.
Espacios ocultos en headers.X-API-KEY
Vuelva a añadir el servidor con la clave sin espacios: Claude Code usa los valores tal cual están escritos.
El mismo nombre en varios scopes
Conserve una sola definición, por ejemplo con claude mcp remove unipile --scope user: local prevalece sobre project, y project sobre user.
MCP endpoint not found at <origin>
Use la URL completa https://developer.unipile.com/mcp?branch=v2.0, compruébela con curl -I, y ejecute después claude mcp get unipile.
/mcp muestra No MCP servers configured
Use ~/.claude.json o .mcp.json en la raíz del proyecto, nunca ~/.claude/mcp.json, y reinicie la sesión.
El shell rechaza la URL, o falta branch
Entrecomille siempre la URL en claude mcp add, o zsh responde «no matches found» y bash puede perder el parámetro.
Arranque lento o timeout
Aumente el límite para la sesión con MCP_TIMEOUT=60000 claude.
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 Claude Code

Las preguntas que la gente escribe de verdad: scopes, dónde vive la configuración, claves fuera del repositorio, cabeceras personalizadas, Failed to connect, comillas en la URL, cambios en .mcp.json y claves de API.
Local es el valor por defecto: se guarda en ~/.claude.json bajo el proyecto actual, es privado y se limita a ese proyecto. Project escribe .mcp.json en la raíz del repositorio y se comparte por control de versiones. User escribe ~/.claude.json bajo la clave raíz mcpServers y se aplica a todos sus proyectos. La precedencia es local, luego project, luego user. Para Unipile: --scope user para su clave de desarrollo personal, --scope project cuando todo el equipo trabaja en la misma integración.
En ~/.claude.json (en Windows %USERPROFILE%\.claude.json) para los scopes local y user, y en .mcp.json en la raíz del proyecto para el scope project. Claude Code no lee ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json o %APPDATA%\Claude\mcp.json. claude mcp get unipile le dice en qué scope vive cada entrada.
Claude Code expande ${VAR} y ${VAR:-default} en command, args, env, url y headers. Escriba "X-API-KEY": "${UNIPILE_API_KEY}" en .mcp.json, versione el archivo, y cada desarrollador aporta su propia clave con scope desde su entorno. Si la variable no está definida y no hay valor por defecto, la configuración se carga igualmente y claude mcp list muestra un aviso.
Sí: --header "X-API-KEY: your-scoped-api-key", repetible para varias cabeceras, en forma corta -H. Póngala después de la URL, porque el flag acepta varios valores. El servidor de Unipile es un servidor HTTP remoto: nada que instalar en local, sin npx, sin Node que gestionar.
Ejecute claude mcp get unipile para ver el detalle (estado HTTP y texto del error), revise los avisos de espacios al principio o al final que imprime claude mcp list tras pegar una clave, y confirme que la URL responde desde su máquina con curl -I. Un 404 imprime MCP endpoint not found at <origin>: la ruta es incorrecta, la URL completa es https://developer.unipile.com/mcp?branch=v2.0, con el parámetro branch incluido.
La URL contiene un ?, que zsh interpreta como carácter de patrón. Entrecomille siempre la URL en claude mcp add. Sin comillas, zsh responde "no matches found" y bash puede descartar el parámetro branch , lo que le conecta a la versión equivocada del servidor.
Claude Code lee .mcp.json al iniciar la sesión: salga y vuelva a lanzarlo. Una entrada mal formada se ignora en silencio, y claude mcp list imprime el aviso de análisis con el campo defectuoso. Si rechazó el servidor en el aviso de aprobación del proyecto, ejecute claude mcp reset-project-choices.
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 solo las cuentas implicadas 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.