Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
Codex · Serveur MCP
Serveur MCP Codex : messagerie et email dans votre produit
Trois lignes de config.toml connectent le serveur MCP Unipile. Codex intègre ensuite des fonctionnalités LinkedIn, WhatsApp et email dans votre produit, depuis la CLI, l'extension IDE ou l'application desktop. Rien à installer ni à lancer en local.
Essai gratuit de 7 jours, sans carte bancaire.
Codex · crm-app
Unipile MCP connecté
Ajoute la recherche de personnes LinkedIn à mon CRM.
Endpoint de lecturePOST /v2/{account_id}/linkedin/searchschéma chargé
Ajout de la route de recherche et de la liste de résultats. Chaque ligne conserve l'ID fournisseur du profil.
Décrivez la prochaine fonctionnalité…
Cas d'usage
Ajoutez LinkedIn, WhatsApp et l'email à votre produit depuis Codex
Ajoutez LinkedIn, WhatsApp, l'email ou l'agenda à votre produit. Via le serveur MCP Unipile, Codex lit la référence API, écrit le code dans votre stack et teste chaque requête.
Connecter le serveur MCP Unipile à CodexUnipile MCP connecté
Sélectionnez les canaux à connecter
developer.unipile.com/mcpConnecter tous les canaux10 canaux
↑↓naviguer espacesélectionner ↵connecterune URL, un en-tête
config.toml, CLI et IDE
Ajouter le serveur MCP Unipile à Codex
Le serveur est distant : une URL en HTTP streamable et un en-tête, rien à exécuter en local. Une seule entrée dans config.toml sert Codex CLI, l'extension IDE et l'app desktop ChatGPT.
Avant de commencer : Codex CLI ou l'extension IDE, connecté, une application Development dans le dashboard Unipile avec une clé Account API scopée, et un compte de test relié via Hosted Auth.
codex mcp add, puis l'en-têteenregistre l'URL dans ~/.codex/config.toml
Configuration globale~/.codex/config.toml
Configuration de projet.codex/config.toml (projet de confiance)
Clé issue d'une variable d'environnementenv_http_headers
?
Pourquoi deux étapes en CLI ?codex mcp add n'a pas de flag d'en-tête personnalisé : l'en-tête X-API-KEY va donc dans config.toml, à la main ou avec env_http_headers.
# 1. Enregistrer le serveur MCP Unipile hébergé (config globale)
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0"
# Added global MCP server 'unipile'.
# 2. Ajouter l'en-tête X-API-KEY à l'entrée dans ~/.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. Vérifier
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" }
# Lu uniquement dans un projet de confiance. Gardez la clé hors de git : préférez 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 avant de lancer codex
Enregistrez le fichier et redémarrez Codex. Vérifié sur codex-cli 0.154.0.
Gardez votre clé API hors de config.toml. Dans un fichier partagé, utilisez
env_http_headers pour que chaque développeur exporte son propre UNIPILE_API_KEY, ou http_headers_helper pour la lire depuis un coffre-fort. Laissez default_tools_approval_mode sur prompt pendant le développement si vous voulez confirmer chaque écriture.Vérifier la connexion
- 1En CLI,
codex mcp listaffiche unipile comme activé, etcodex mcp get unipileses en-têtes. - 2Dans une session,
/mcpliste le serveur ; Auth Unsupported est normal, puisqu'il utilise un en-tête et non OAuth. - 3Dans un chat, demandez
Using the Unipile MCP, list the endpoints for LinkedIn people search and their required parameters: vous devez obtenir de vraies routes.
Des prompts, pas du code de liaison
Donnez le prompt à votre agent
Trois tâches d'intégration, chacune avec le prompt à coller dans Codex, les endpoints que l'agent exécute sur
https://api.unipile.com avec votre X-API-KEY, et ce qui arrive dans votre projet.Ajoute la recherche de personnes LinkedIn à mon CRM, puis permets à l'utilisateur d'ouvrir le profil sélectionné et de démarrer une conversation depuis celui-ci.
Rechercher des endpoints"linkedin search people profile"3 résultats
Exécuter la requêtePOST /v2/{account_id}/linkedin/search10 résultats
Ajout de
GET /api/linkedin/search (mots-clés, curseur de pagination) et GET /api/linkedin/profiles/:identifier. La liste de résultats conserve l'ID fournisseur renvoyé par la recherche, la route profil le réutilise, et le bouton « Message » le transmet à la création du chat. Les deux exécutés sur l'application Development.Un seul identifiant, du résultat de recherche à la conversation
La difficulté consiste à garder le même identifiant de la ligne de recherche jusqu'au profil, puis jusqu'au message. Codex lit les trois contrats et voit quel champ le porte : rien n'est deviné.
Endpoints utilisés par l'agent
Créer une intégration LinkedIn
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Génère un client typé Node.js et Python pour les routes chats et emails d'Unipile que nous utilisons, à partir des schémas de l'API, avec des retries sur 429.
Endpoint de lectureGET /v2/{account_id}/emailsschéma chargé
Exécuter la requêteGET /v2/{account_id}/chats200 OK
Écriture de
unipile-client.ts et unipile_client.py à partir des schémas de requête et de réponse : méthodes typées de liste et d'envoi pour les chats et les emails, helper de pagination par curseur, backoff exponentiel sur 429 avec l'en-tête Retry-After. Les deux clients ont exécuté les appels de liste sur l'application Development.Des clients typés à partir des vrais schémas, pas de mémoire
Codex lit le corps de requête et le schéma de réponse de chaque route, génère les types et exécute un appel par méthode sur votre application Development. Les SDK officiels Node.js et Python restent la référence.
Endpoints utilisés par l'agent
Voir les SDK officiels
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Prends en charge plusieurs comptes connectés pour chaque utilisateur de mon SaaS : ils peuvent relier plusieurs comptes LinkedIn et email et choisir celui qui envoie.
Endpoint de lectureGET /v2/accountsschéma chargé
Exécuter la requêteGET /v2/accounts3 comptes
Ajout d'une table
accounts indexée par utilisateur et account_id, d'un sélecteur dans l'éditeur de message, et de POST /api/messages qui envoie depuis le compte sélectionné. Les états de reconnexion renvoyés par la route des comptes s'affichent sous forme de badge. Vérifié avec trois comptes sur l'application Development.Un utilisateur, plusieurs comptes, un Scope par workspace
Chaque compte que vos utilisateurs connectent via Hosted Auth reçoit son propre
account_id. L'agent relie vos utilisateurs à ces ID, affiche les états de reconnexion et de checkpoint, et envoie chaque message depuis le compte choisi par l'utilisateur.Endpoints utilisés par l'agent
Implémenter Hosted Auth avec un agent
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Une application Development d'abord
Donnez à Codex une clé scopée issue d'une application Development, séparée de la Production.
Comptes de test, vraies requêtes
L'agent exécute les requêtes sur des comptes de test, au nom de l'utilisateur authentifié qui les a reliés, dans les limites de chaque fournisseur.
Valider chaque flux
Vérifiez le flux de connexion, une lecture et une écriture par fonctionnalité, et une livraison de webhook.
Puis passer en Production
Rien ne touche les comptes de vos utilisateurs tant que vous ne changez pas de clé. Voir sécurité et conformité.
Dépannage
Erreurs fréquentes et leur signification
Ce que vous voyez quand une entrée MCP Codex est incorrecte, et la correction de chaque cas.
Le serveur n'apparaît pas après modification de config.toml
Redémarrez Codex, puis vérifiez CODEX_HOME et lancez codex mcp list dans le shell depuis lequel vous lancez Codex.
La configuration du projet est ignorée
Marquez le projet comme fiable avec trust_level = "trusted" sous [projects."/path/to/repo"], ou déplacez l'entrée dans ~/.codex/config.toml.
TOML invalide
Nommez la table exactement [mcp_servers.unipile] et faites de http_headers une table, avec "X-API-KEY" entre guillemets.
401 Unauthorized sur les requêtes
Exportez la variable nommée dans env_http_headers dans le shell qui a lancé Codex, et utilisez une clé Account API scopée.
Les paramètres indiquent que le serveur est indisponible
Rien à changer : ce contrôle cherche des ressources, et le serveur Unipile expose des actions, comme le confirme /mcp.
Timed out
Vérifiez l'URL (?branch=v2.0 compris), le réseau et un éventuel proxy avant d'augmenter startup_timeout_sec.
6000+
Les entreprises qui innovent avec Unipile
Des entreprises leaders nous font confiance
1 API
Toutes les plateformes centralisées en une API
2 jours
Intégration très rapide
30%
Réduction des efforts et des ressources de maintenance
Sécurité et conformité
Une protection de niveau entreprise pour vos données et workflows En savoir plus sur notre sécurité
SOC 2 Type II
Certifié
Contrôles de sécurité vérifiés de manière indépendante garantissant la protection des données et l'intégrité opérationnelle.
GDPR
Conforme à la loi
Conformité totale avec les réglementations européennes en matière de protection des données pour le respect de la vie privée des utilisateurs.
99.9%
Temps de disponibilité de la plateforme au cours des 24 derniers mois
24/7
Support mondial avec API performante
FAQ serveur MCP Codex
Les questions réellement posées : config.toml au lieu de mcp.json, son emplacement, codex mcp add, la clé hors du fichier, les trois interfaces, que vérifier quand rien n'apparaît, les timeouts et les clés.
Non. Codex stocke sa configuration MCP dans
~/.codex/config.toml, en TOML, une table par serveur nommée [mcp_servers.<name>]. Il n'y a pas de mcp.json dans Codex, et le fichier n'est pas créé à l'installation : vous le créez, ou codex mcp add le crée pour vous. Un projet de confiance peut aussi avoir un .codex/config.toml à sa racine.~/.codex/config.toml pour la configuration user, .codex/config.toml à la racine du dépôt pour la configuration de projet. La variable d'environnement CODEX_HOME déplace tout le répertoire de configuration : quand un serveur apparaît dans un terminal et pas dans un autre, vérifiez-la en premier. Codex CLI, l'extension IDE et l'app desktop lisent le même fichier.En partie.
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" écrit la table d'un serveur HTTP streamable, et --bearer-token-env-var couvre les serveurs qui acceptent un jeton Bearer. Le serveur Unipile s'authentifie avec un en-tête X-API-KEY , que la commande ne sait pas définir : vous ajoutez donc http_headers ou env_http_headers à l'entrée qu'elle a créée. Vérifié sur codex-cli 0.154.0.Utilisez
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" } : il associe le nom de l'en-tête au nom d'une variable d'environnement plutôt qu'à une valeur. Le fichier peut ainsi être commité sans secret, et chaque développeur exporte sa propre clé Account API scopée. http_headers sert aux valeurs statiques, et http_headers_helper permet à une commande locale de produire les en-têtes en JSON.Oui. Les trois interfaces d'un même hôte Codex lisent la même configuration : un serveur ajouté une fois est disponible partout. Dans l'app desktop et dans l'extension, vous pouvez aussi l'ajouter depuis Settings, MCP servers, Add server, en choisissant Streamable HTTP. Redémarrez le client après avoir enregistré le fichier.
Quatre causes, dans l'ordre : le client n'a pas été redémarré ; le fichier se trouve sous un autre
CODEX_HOME que votre shell actuel ; la table est dans un .codex/config.toml de projet et le projet n'est pas marqué trust_level = "trusted", auquel cas Codex ignore entièrement la couche projet ; ou le TOML est invalide. Lancez codex mcp list, puis /mcp dans une session.startup_timeout_sec remplace le timeout de démarrage par défaut de 10 secondes et tool_timeout_sec le timeout par outil par défaut de 60 secondes, tous deux sous la table du serveur. Le serveur Unipile est distant, en HTTP, sans processus local à démarrer : un timeout de démarrage pointe donc presque toujours vers l'URL, le réseau ou un proxy d'entreprise, pas vers le serveur.Le serveur répond sans clé quand l'agent se contente de lire la spécification de l'API. Pour exécuter de vraies requêtes, créez un Scope dans votre application Development, rattachez-y les comptes de test et générez une clé Account API scopée pour ce Scope. Ne donnez jamais à un client MCP une clé Service ou une clé Account globale.