Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
Cursor · Serveur MCP
Serveur MCP Cursor : messagerie et email dans votre IDE
Une URL et un en-tête ajoutent le serveur MCP Unipile à Cursor. Votre agent intègre ensuite des fonctionnalités LinkedIn, WhatsApp et email dans votre projet et teste chaque appel sur votre application Development. Rien à installer ni à lancer en local.
Essai gratuit de 7 jours, sans carte bancaire.
Cursor · crm-app
Unipile MCP connecté
Ajoute la connexion de compte LinkedIn à mon CRM.
Endpoint de lecturePOST /v2/auth/linkschéma chargé
Ajout de la route de connexion et du bouton dans Settings. L'ID du compte est stocké sur l'utilisateur.
Décrivez la prochaine fonctionnalité…
Cas d'usage
Ajoutez LinkedIn, WhatsApp et l'email à votre produit depuis Cursor
Ajoutez LinkedIn, WhatsApp, l'email ou l'agenda à votre produit. Via le serveur MCP Unipile, Cursor lit la référence API, écrit le code dans votre stack et teste chaque requête.
Connecter le serveur MCP Unipile à CursorUnipile MCP connecté
Sélectionnez les canaux à connecter
developer.unipile.com/mcpConnecter tous les canaux10 canaux
↑↓naviguer espacesélectionner ↵connecterune URL, un en-tête
mcp.json, global ou projet
Ajouter le serveur MCP Unipile à Cursor
Le serveur est distant : une URL en HTTP streamable et un en-tête, rien à exécuter en local. Choisissez global ou projet, collez le bloc, enregistrez, et Cursor le charge.
Avant de commencer : Cursor à jour, une application Development dans le dashboard Unipile avec une clé Account API scopée, et un compte de test relié via Hosted Auth.
Configuration globale~/.cursor/mcp.json
Configuration de projet.cursor/mcp.json (racine du dépôt)
Clé issue d'une variable d'environnement${env:UNIPILE_API_KEY}
?
Global ou projet ?Projet si chaque dépôt a besoin de sa propre clé scopée. Cursor lit d'abord le projet, puis le global.
{
"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}"
}
}
}
}
Enregistrez le fichier et Cursor charge le serveur. ${env:NAME} fonctionne dans url et headers : la clé ne figure jamais dans le fichier.
Vérifier la connexion
- 1Ouvrez Customize dans la barre latérale : le serveur unipile est listé et activé.
- 2Dans la CLI Cursor, lancez
agent mcp list, ou/mcp listdans une session. - 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.
Facultatif : installation en un clic
Collez votre clé Account API scopée pour obtenir un lien qui ouvre Cursor avec le serveur prérempli. La clé ne quitte jamais votre navigateur.
Ajouter Unipile à Cursor
Des prompts, pas du code de liaison
Donnez le prompt à votre agent
Trois tâches d'intégration, chacune avec le prompt à coller dans Cursor, 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 messagerie LinkedIn à mon ATS : synchronise l'inbox de chaque recruteur et permets-leur de répondre depuis la fiche candidat.
Rechercher des endpoints"chats messages send"3 résultats
Exécuter la requêteGET /v2/{account_id}/chats12 chats
Création de
linkedin/inbox-sync.ts (chats et messages upsertés sur le candidat, pagination par curseur) et de POST /candidates/:id/reply, qui appelle la route d'envoi avec l'ID du compte propriétaire du chat. Synchro exécutée sur l'application Development : 12 chats, 87 messages.Collez le prompt, relisez le diff
Cursor lit les contrats des chats et des messages, écrit le job de synchronisation et l'endpoint de réponse, puis exécute les premières requêtes sur votre application Development. WhatsApp, Instagram, Facebook et Telegram utilisent les mêmes routes de chat.
Endpoints utilisés par l'agent
Créer une intégration LinkedIn
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Implémente Hosted Auth d'Unipile dans cette app React et Fastify pour que les utilisateurs connectent leur propre compte LinkedIn depuis Settings.
Endpoint de lecturePOST /v2/auth/linkschéma chargé
Exécuter la requêtePOST /v2/auth/link201 · link
Ajout de
POST /api/accounts/connect dans Fastify : elle crée le lien d'authentification côté serveur et renvoie l'URL hébergée. La page Settings en React l'ouvre et, au retour, stocke le nouvel account_id sur le workspace. Vérifié sur l'application Development avec un compte LinkedIn de test.Vos utilisateurs connectent leurs propres comptes, votre app récupère un ID de compte
Hosted Auth est la page qu'Unipile sert pour que vos utilisateurs relient leurs propres comptes. L'agent branche le lien sur votre backend, la redirection sur votre frontend et le stockage de l'ID du compte.
Endpoints utilisés par l'agent
Implémenter Hosted Auth avec un agent
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Abonne-toi aux webhooks de nouveau message et crée une inbox unifiée LinkedIn, WhatsApp et email : une liste de fils avec le canal en badge.
Endpoint de lecturePOST /v2/webhooks/endpoints/schéma chargé
Exécuter la requêteGET /v2/{account_id}/emails200 OK
Enregistrement d'un endpoint webhook pour les événements de message sur l'application Development, ajout de
POST /webhooks/unipile qui renvoie 200 immédiatement et met l'événement en file d'attente, d'un modèle Thread qui ramène chats et fils d'emails à un même format, et de la liste de fils avec badges de canal. Message de test envoyé : la liste s'est mise à jour en moins d'une seconde.Du temps réel sans polling, une seule liste pour la messagerie et l'email
L'agent lit les contrats des chats et des emails, conçoit un modèle de thread unique, puis écrit la synchronisation et le récepteur de webhooks. Il vérifie ensuite le journal de livraison via la route des conversations de webhook.
Endpoints utilisés par l'agent
Créer une inbox unifiée avec un agent
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Une application Development d'abord
Donnez à Cursor 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
Les messages que Cursor affiche quand une entrée MCP est incorrecte, et la correction de chacun.
No tools or prompts
Vérifiez le fichier modifié (~/.cursor/mcp.json ou .cursor/mcp.json), supprimez toute virgule finale, puis rechargez le serveur depuis Customize.
No server info found
Utilisez une entrée distante avec url égal à exactement https://developer.unipile.com/mcp?branch=v2.0 et headers, sans command ni type: "stdio".
Connection failed
Cherchez une faute de frappe dans l'hôte et dans ?branch=v2.0, ou un proxy d'entreprise : l'URL doit répondre dans un navigateur, pas renvoyer un 404.
401 Unauthorized sur les requêtes
Envoyez une clé Account API scopée de votre application Development dans headers, sous le nom exact X-API-KEY.
La configuration du projet est ignorée
Placez .cursor/mcp.json à la racine du dossier ouvert dans Cursor, pas dans un sous-dossier.
Où lire les logs
Ouvrez le panneau Output (Cmd+Shift+U sur macOS, Ctrl+Shift+U sous Windows et Linux) et sélectionnez MCP Logs dans la liste déroulante.
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 Cursor
Les questions réellement posées : emplacement de mcp.json, global ou projet, serveurs distants et en-têtes, que vérifier quand rien n'apparaît, clés, installation en un clic et CLI.
À deux endroits.
~/.cursor/mcp.json dans votre dossier personnel est la configuration globale, disponible dans tous les projets. .cursor/mcp.json à la racine du dossier ouvert dans Cursor est la configuration de projet. Cursor lit d'abord le fichier du projet, puis le global, puis les répertoires parents. Les deux acceptent le même bloc mcpServers .Globalement si vous développez plusieurs intégrations Unipile depuis une même machine et une même application Development. Par projet si chaque dépôt a besoin de sa propre clé scopée, le bon choix quand les intégrations Development et Production vivent dans des dépôts différents. Dans les deux cas, la clé est une clé Account API scopée, jamais une clé Service ou globale.
Oui. Une entrée distante dans
mcp.json accepte un url et un objet headers , et Cursor résout ${env:NAME} dans les deux. Le serveur Unipile est exactement cela : HTTP streamable à l'adresse https://developer.unipile.com/mcp?branch=v2.0 avec l'en-tête X-API-KEY . Pas de npx, pas de processus local, pas de version de Node à gérer.Dans cet ordre : le fichier modifié (global ou projet, à la racine du dépôt), la validité du JSON, un rechargement du serveur depuis Customize ou un redémarrage de Cursor, puis les MCP Logs dans le panneau Output (Cmd+Shift+U, sélectionnez MCP Logs). Si le serveur se connecte mais que les requêtes échouent en 401, la clé manque dans l'en-tête ou n'est pas une clé Account API scopée.
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.
Oui. Le lien d'installation de cette page encode la configuration du serveur ; il ouvre Cursor avec l'entrée unipile préremplie, et vous remplacez la valeur provisoire par votre clé scopée. Le générateur facultatif ci-dessus construit le même lien avec votre clé déjà intégrée, entièrement dans votre navigateur.
Oui. La CLI partage la configuration de l'éditeur : le projet d'abord, puis le global.
agent mcp list affiche les serveurs configurés et leur état, et /mcp list fait de même dans une session interactive. L'agent utilise ensuite le serveur Unipile quand une demande le nécessite.