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
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
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.
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 conectar
developer.unipile.com/mcpConectar todos los canales10 canales
↑↓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.
Scope user--scope user · todos los proyectos, privado para usted
Scope project.mcp.json en la raíz del repositorio, compartido
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.
# 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
- 1Desde el terminal,
claude mcp listmuestra ✔ Connected, yclaude mcp get unipilemuestra los detalles. - 2Dentro de una sesión,
/mcpmuestra el estado y aprueba la primera vez un .mcp.json de scope project. - 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 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.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.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
API de WhatsApp
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
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.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
API de email
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
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.
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
Cuentas, Scopes y claves
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
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
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 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.