FR
Claude Code · Serveur MCP

Serveur MCP Claude Code : messagerie et email dans votre app

Une seule commande claude mcp add connecte le serveur MCP Unipile. Claude Code 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.
Claude Code · crm-app
Unipile MCP connecté
Sarah
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.
3 fichiers modifiés · testé sur l'application Development
Décrivez la prochaine fonctionnalité…
Cas d'usage

Ajoutez LinkedIn, WhatsApp et l'email à votre produit depuis Claude Code

Ajoutez LinkedIn, WhatsApp, l'email ou l'agenda à votre produit. Via le serveur MCP Unipile, Claude Code lit la référence API, écrit le code dans votre stack et teste chaque requête.
Connecter le serveur MCP Unipile à Claude CodeUnipile MCP connecté
Sélectionnez les canaux à connecterdeveloper.unipile.com/mcp
Connecter tous les canaux10 canaux
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
↑↓naviguer espacesélectionner ↵connecterune URL, un en-tête
claude mcp add, trois scopes

Ajouter le serveur MCP Unipile à Claude Code

Le serveur est distant : une URL en HTTP streamable et un en-tête, rien à exécuter en local. Une commande l'enregistre ; le scope choisi détermine où il se charge.
Avant de commencer : Claude Code installé et connecté, une application Development dans le dashboard Unipile avec une clé Account API scopée, et un compte de test relié via Hosted Auth.
U
Scope user--scope user · tous les projets, privé
P
Scope project.mcp.json à la racine du dépôt, partagé
L
Scope local (par défaut)ce projet uniquement, privé, dans ~/.claude.json
?
Quel scope choisir ?User pour tous vos projets, project pour partager .mcp.json avec l'équipe, local pour un essai ponctuel.
terminal
# Scope user : tous les projets de cette machine, privé 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 affiche "Added …", puis : claude mcp list
// Scope project : commité à la racine du dépôt, partagé avec l'équipe { "mcpServers": { "unipile": { "type": "http", "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "${UNIPILE_API_KEY}" } } } } // "type": "http" est obligatoire ; chaque développeur exporte UNIPILE_API_KEY
# Scope local (par défaut) : ce projet uniquement, privé, stocké dans ~/.claude.json claude mcp add --transport http \ unipile "https://developer.unipile.com/mcp?branch=v2.0" \ --header "X-API-KEY: your-scoped-api-key"
Vérifié sur Claude Code 2.1. Mettez l'URL entre guillemets (zsh interprète le ? comme un motif) et gardez --header en dernier.

Vérifier la connexion

  1. 1Dans le terminal, claude mcp list affiche ✔ Connected, et claude mcp get unipile donne le détail.
  2. 2Dans une session, /mcp affiche le statut et approuve un .mcp.json de projet la première fois.
  3. 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 Claude Code, les endpoints que l'agent exécute sur https://api.unipile.com avec votre X-API-KEY, et ce qui arrive dans votre projet.
Claude Code · support-consoleApplication Development
Ajoute la messagerie WhatsApp à notre console de support : synchronise les conversations de chaque agent et permets-leur de répondre depuis le ticket.
Rechercher des endpoints"chats messages send"3 résultats
Exécuter la requêteGET /v2/{account_id}/chats9 chats
Création de whatsapp/chat-sync.ts (chats et messages upsertés sur le ticket, pagination par curseur) et de POST /tickets/:id/reply qui appelle la route d'envoi sur le compte propriétaire du chat. Synchro exécutée sur l'application Development : 9 chats, 41 messages.3 fichiers modifiés · testé sur l'application Development

Une inbox WhatsApp dans votre produit, en un seul prompt

Claude Code 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. LinkedIn, Instagram, Facebook et Telegram utilisent les mêmes routes de chat.
Endpoints utilisés par l'agent
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
API WhatsApp
Claude Code · crm-appApplication Development
Permets aux utilisateurs d'envoyer des emails depuis la fiche contact via leur propre boîte mail Gmail ou Outlook, et regroupe les réponses en fil sur le contact.
Endpoint de lecturePOST /v2/{account_id}/emails/sendschéma chargé
Exécuter la requêteGET /v2/{account_id}/emails200 OK
Ajout de POST /contacts/:id/email qui appelle la route d'envoi sur le compte de la boîte mail de l'utilisateur, l'option de réponse dans le fil via l'ID de thread, et la synchro entrante qui rattache les réponses au contact. Email de test envoyé depuis la boîte mail de l'application Development, réponse bien regroupée dans le fil.4 fichiers modifiés · envoi et fil testés de bout en bout

L'email depuis la boîte mail de l'utilisateur, regroupé en fil dans votre CRM

Gmail, Outlook et IMAP partagent un même schéma d'email. L'agent branche l'envoi sur la boîte mail que l'utilisateur a connectée et conserve l'ID de thread, pour que les réponses arrivent sur le bon contact.
Endpoints utilisés par l'agent
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
API Email
Claude Code · saas-backendApplication Development
Chaque workspace de mon SaaS compte plusieurs utilisateurs avec leurs propres comptes LinkedIn et email. Isole-les : un Scope et une clé scopée par workspace.
Rechercher des endpoints"scopes api-keys"4 résultats
Exécuter la requêtePOST /v2/scopes/201 · scope
À la création d'un workspace, le backend crée désormais un Scope et une clé Account API scopée stockée chiffrée sur le workspace, et chaque compte connecté par un membre est rattaché à ce Scope. Tous les appels de compte utilisent la clé du workspace. Testé avec deux workspaces sur l'application Development.5 fichiers modifiés · isolation vérifiée

Beaucoup d'utilisateurs, beaucoup de comptes, une frontière par tenant

Une clé scopée ne voit que les comptes affectés à son Scope. L'agent fait de cette frontière votre modèle de tenant : la logique multi-comptes vit dans l'API, pas dans votre code.
Endpoints utilisés par l'agent
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Comptes, Scopes et clés
Une application Development d'abord Donnez à Claude Code 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 statuts qu'affichent claude mcp list et /mcp quand une entrée est incorrecte, et la correction de chacun.
✘ Failed to connect
Utilisez exactement https://developer.unipile.com/mcp?branch=v2.0 avec --transport http, puis vérifiez avec claude mcp get unipile.
⏸ Pending approval
Lancez claude dans le dossier, acceptez la boîte de dialogue de confiance du workspace, puis approuvez le serveur depuis /mcp.
401 sur les requêtes
Envoyez une clé Account API scopée de votre application Development, sous le nom d'en-tête exact X-API-KEY.
Avertissement de variable manquante
Exportez UNIPILE_API_KEY dans le shell qui lance Claude Code, ou définissez une valeur par défaut avec ${UNIPILE_API_KEY:-}.
Espace caché dans headers.X-API-KEY
Ajoutez à nouveau le serveur avec la clé nettoyée : Claude Code utilise les valeurs exactement telles qu'écrites.
Même nom dans plusieurs scopes
Gardez une seule définition, par exemple avec claude mcp remove unipile --scope user : local l'emporte sur project, puis sur user.
MCP endpoint not found at <origin>
Utilisez l'URL complète https://developer.unipile.com/mcp?branch=v2.0, vérifiez-la avec curl -I, puis lancez claude mcp get unipile.
/mcp affiche No MCP servers configured
Utilisez ~/.claude.json ou .mcp.json à la racine du projet, jamais ~/.claude/mcp.json, puis redémarrez la session.
Le shell rejette l'URL, ou branch manque
Mettez toujours l'URL entre guillemets dans claude mcp add, sinon zsh répond "no matches found" et bash peut supprimer le paramètre.
Démarrage lent ou timeout
Augmentez la limite pour la session avec MCP_TIMEOUT=60000 claude.
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
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
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 Claude Code

Les questions réellement posées : scopes, emplacement de la configuration, clés hors du dépôt, en-têtes personnalisés, Failed to connect, guillemets autour de l'URL, modifications de .mcp.json et clés API.
Local est le scope par défaut : stocké dans ~/.claude.json sous le projet courant, privé et limité à ce projet. Project écrit .mcp.json à la racine du dépôt et se partage via le contrôle de version. User écrit ~/.claude.json sous la clé racine mcpServers et s'applique à tous vos projets. L'ordre de priorité est local, puis project, puis user. Pour Unipile : --scope user pour votre clé de développement personnelle, --scope project quand toute l'équipe travaille sur la même intégration.
Dans ~/.claude.json (sous Windows %USERPROFILE%\.claude.json) pour les scopes local et user, et dans .mcp.json à la racine du projet pour le scope project. Claude Code ne lit pas ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json ou %APPDATA%\Claude\mcp.json. claude mcp get unipile vous indique dans quel scope se trouve une entrée.
Claude Code développe ${VAR} et ${VAR:-default} dans command, args, env, url et headers. Écrivez "X-API-KEY": "${UNIPILE_API_KEY}" dans .mcp.json, commitez le fichier, et chaque développeur fournit sa propre clé scopée via son environnement. Si la variable n'est pas définie et n'a pas de valeur par défaut, la configuration se charge quand même et claude mcp list affiche un avertissement.
Oui : --header "X-API-KEY: your-scoped-api-key", répétable pour plusieurs en-têtes, forme courte -H. Placez-le après l'URL, car le flag accepte plusieurs valeurs. Le serveur Unipile est un serveur HTTP distant : rien à installer en local, pas de npx, pas de Node à gérer.
Lancez claude mcp get unipile pour le détail (statut HTTP et message d'erreur), vérifiez les avertissements d'espaces en début ou en fin de valeur que claude mcp list affiche après une clé collée, et confirmez que l'URL répond depuis votre machine avec curl -I. Un 404 affiche MCP endpoint not found at <origin> : le chemin est incorrect, l'URL complète est https://developer.unipile.com/mcp?branch=v2.0, paramètre branch compris.
L'URL contient un ?, que zsh lit comme un caractère de motif. Mettez toujours l'URL entre guillemets dans claude mcp add. Sans guillemets, zsh répond "no matches found" et bash peut supprimer le paramètre branch , ce qui vous connecte à la mauvaise version du serveur.
Claude Code lit .mcp.json au démarrage de la session : quittez et relancez. Une entrée mal formée est ignorée sans message, et claude mcp list affiche l'avertissement d'analyse avec le champ fautif. Si vous avez refusé le serveur à l'invite d'approbation du projet, lancez claude mcp reset-project-choices.
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 uniquement les comptes concernés 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.