ES
Codex · Servidor MCP

Servidor MCP para Codex: mensajería y email en su producto

Tres líneas de config.toml conectan el servidor MCP de Unipile. Después, Codex construye funciones de LinkedIn, WhatsApp y email en su producto, desde la CLI, la extensión del IDE o la app de escritorio. Nada que instalar ni ejecutar en local.
Prueba gratis de 7 días, sin tarjeta.
Codex · crm-app
Unipile MCP conectado
Sarah
Añade la búsqueda de personas de LinkedIn a mi CRM.
Leer endpointPOST /v2/{account_id}/linkedin/searchesquema cargado
Se han añadido la ruta de búsqueda y la lista de resultados. Cada fila conserva el ID de proveedor del perfil.
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 Codex

Añada LinkedIn, WhatsApp, email o calendario a su producto. A través del servidor MCP de Unipile, Codex 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 CodexUnipile 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
config.toml, CLI e IDE

Añada el servidor MCP de Unipile a Codex

El servidor es remoto: una URL sobre streamable HTTP y una cabecera, nada que ejecutar en local. Una sola entrada en config.toml sirve para la CLI de Codex, la extensión para IDE y la app de escritorio de ChatGPT.
Antes de empezar: la CLI de Codex o la extensión para IDE, 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.
1
codex mcp add y después la cabeceraregistra la URL en ~/.codex/config.toml
G
Configuración global~/.codex/config.toml
P
Configuración de proyecto.codex/config.toml (proyecto de confianza)
E
Clave desde una variable de entornoenv_http_headers
?
¿Por qué dos pasos en la CLI?codex mcp add no tiene opción para cabeceras personalizadas, así que la cabecera X-API-KEY va en config.toml, a mano o con env_http_headers.
terminal
# 1. Registre el servidor MCP alojado de Unipile (config global) codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" # Added global MCP server 'unipile'. # 2. Añada la cabecera X-API-KEY a la entrada de ~/.codex/config.toml [mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" http_headers = { "X-API-KEY" = "your-scoped-api-key" } # 3. Verifique codex mcp get unipile
[mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" http_headers = { "X-API-KEY" = "your-scoped-api-key" }
[mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" http_headers = { "X-API-KEY" = "your-scoped-api-key" } # Solo se lee dentro de un proyecto de confianza. Mantenga la clave fuera de git: prefiera env_http_headers.
[mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" } # export UNIPILE_API_KEY=your-scoped-api-key antes de lanzar codex
Guarde el archivo y reinicie Codex. Verificado en codex-cli 0.154.0.
Mantenga su clave de API fuera de config.toml. En un archivo compartido, use env_http_headers para que cada desarrollador exporte su propia UNIPILE_API_KEY, o http_headers_helper para leerla desde un almacén de secretos. Deje default_tools_approval_mode en prompt mientras construye si quiere confirmar cada escritura.

Verifique la conexión

  1. 1En la CLI, codex mcp list muestra unipile como enabled, y codex mcp get unipile muestra sus cabeceras.
  2. 2Dentro de una sesión, /mcp lista el servidor; Auth Unsupported es lo esperado, ya que usa una cabecera, no OAuth.
  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 Codex, los endpoints que ejecuta el agente en https://api.unipile.com con su X-API-KEY, y lo que llega a su proyecto.
Codex · crm-appApp de Development
Añade la búsqueda de personas de LinkedIn a mi CRM y permite al usuario abrir el perfil seleccionado e iniciar una conversación desde él.
Buscar endpoints"linkedin search people profile"3 resultados
Ejecutar peticiónPOST /v2/{account_id}/linkedin/search10 resultados
Se han añadido GET /api/linkedin/search (palabras clave, cursor de paginación) y GET /api/linkedin/profiles/:identifier. La lista de resultados conserva el ID de proveedor devuelto por la búsqueda, la ruta del perfil lo reutiliza y el botón "Mensaje" lo pasa a la creación del chat. Ambas ejecutadas en la app de Development.4 archivos modificados · probado en la app de Development

Un mismo identificador desde el resultado de búsqueda hasta la conversación

Lo difícil es conservar el mismo identificador desde la fila de búsqueda hasta el perfil y luego hasta el mensaje. Codex lee los tres contratos y ve qué campo lo lleva, así que no se adivina nada.
Endpoints que usa el agente
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Construya una integración de LinkedIn
Codex · messaging-sdkApp de Development
Genera un cliente tipado en Node.js y Python para las rutas de chats y emails de Unipile que usamos, a partir de los esquemas de la API, con reintentos en caso de 429.
Leer endpointGET /v2/{account_id}/emailsesquema cargado
Ejecutar peticiónGET /v2/{account_id}/chats200 OK
Se han escrito unipile-client.ts y unipile_client.py a partir de los esquemas de petición y respuesta: métodos tipados de listado y envío para chats y emails, helper de paginación por cursor y backoff exponencial en caso de 429 con la cabecera Retry-After. Ambos clientes ejecutaron las llamadas de listado en la app de Development.2 clientes generados · esquemas leídos a través del servidor

Clientes tipados a partir de los esquemas reales, no de memoria

Codex lee el cuerpo de la petición y el esquema de respuesta de cada ruta, genera los tipos y ejecuta una llamada por método en su aplicación de Development. Los SDK oficiales de Node.js y Python siguen siendo la referencia.
Endpoints que usa el agente
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Ver los SDK oficiales
Codex · saas-backendApp de Development
Admite varias cuentas conectadas por usuario de mi SaaS: pueden vincular varias cuentas de LinkedIn y email y elegir cuál envía.
Leer endpointGET /v2/accountsesquema cargado
Ejecutar peticiónGET /v2/accounts3 cuentas
Se ha añadido una tabla accounts indexada por usuario y account_id, un selector en el editor de mensajes y POST /api/messages que envía desde la cuenta seleccionada. Los estados de reconexión de la ruta de cuentas se muestran como etiqueta. Verificado con tres cuentas en la app de Development.5 archivos modificados · 3 cuentas, un solo editor

Un usuario, varias cuentas, un Scope por workspace

Cada cuenta que sus usuarios conectan mediante Hosted Auth recibe su propio account_id. El agente asocia sus usuarios a esos IDs, muestra los estados de reconexión y de checkpoint, y dirige cada envío a la cuenta que eligió el usuario.
Endpoints que usa el agente
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Implemente Hosted Auth con un agente
Primero, una aplicación de Development Dé a Codex 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 ve cuando una entrada MCP de Codex no es correcta, y la solución de cada caso.
El servidor no aparece tras editar config.toml
Reinicie Codex, compruebe CODEX_HOME y ejecute codex mcp list en el shell desde el que lanza Codex.
La configuración de proyecto se ignora
Marque el proyecto como de confianza con trust_level = "trusted" bajo [projects."/path/to/repo"], o mueva la entrada a ~/.codex/config.toml.
TOML inválido
Nombre la tabla [mcp_servers.unipile] exactamente así y haga que http_headers sea una tabla, con "X-API-KEY" entre comillas.
401 Unauthorized en las peticiones
Exporte la variable indicada en env_http_headers en el shell que lanzó Codex, y use una clave Account API con scope.
Los ajustes dicen que el servidor no está disponible
No hay nada que cambiar: esa comprobación busca recursos, y el servidor de Unipile expone acciones, como /mcp confirma.
Timed out
Compruebe la URL (?branch=v2.0 incluido), la red y cualquier proxy antes de aumentar startup_timeout_sec.
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 Codex

Las preguntas que la gente escribe de verdad: config.toml en lugar de mcp.json, dónde vive, codex mcp add, cómo mantener la clave fuera del archivo, las tres superficies, qué comprobar cuando no aparece nada, timeouts y claves.
No. Codex guarda su configuración MCP en ~/.codex/config.toml, en TOML, con una tabla por servidor llamada [mcp_servers.<name>]. En Codex no hay ningún mcp.json, y el archivo no se crea al instalar: lo crea usted, o lo crea codex mcp add por usted. Un proyecto de confianza también puede llevar un .codex/config.toml en su raíz.
~/.codex/config.toml para la configuración de usuario, .codex/config.toml en la raíz del repositorio para la configuración de proyecto. La variable de entorno CODEX_HOME cambia todo el directorio de configuración: cuando un servidor aparece en un terminal y no en otro, compruébela primero. La CLI de Codex, la extensión del IDE y la app de escritorio leen el mismo archivo.
En parte. codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" escribe la tabla para un servidor streamable HTTP, y --bearer-token-env-var cubre los servidores que aceptan un token Bearer. El servidor de Unipile se autentica con una cabecera X-API-KEY , que el comando no puede definir, así que añada http_headers o env_http_headers a la entrada que ha creado. Verificado en codex-cli 0.154.0.
Use env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }: asocia el nombre de la cabecera al nombre de una variable de entorno en lugar de a un valor, de modo que el archivo se puede versionar sin ningún secreto y cada desarrollador exporta su propia clave Account API con scope. http_headers sirve para valores estáticos, y http_headers_helper permite que un comando local produzca las cabeceras en JSON.
Sí. Las tres superficies de un mismo host de Codex leen la misma configuración, así que un servidor añadido una vez está disponible en todas partes. En la app de escritorio y en la extensión también puede añadirlo desde Settings, MCP servers, Add server, eligiendo Streamable HTTP. Reinicie el cliente después de guardar el archivo.
Cuatro causas, por orden: no se ha reiniciado el cliente; el archivo está bajo un CODEX_HOME distinto del de su shell actual; la tabla está en un .codex/config.toml de proyecto y el proyecto no está marcado como trust_level = "trusted", en cuyo caso Codex omite por completo la capa de proyecto; o el TOML no es válido. Ejecute codex mcp list, y después /mcp dentro de una sesión.
startup_timeout_sec sustituye el timeout de arranque de 10 segundos por defecto y tool_timeout_sec el de 60 segundos por herramienta, ambos dentro de la tabla del servidor. El servidor de Unipile es remoto por HTTP y no hay ningún proceso local que arrancar, así que un timeout de arranque casi siempre apunta a la URL, a la red o a un proxy corporativo, no al servidor.
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.