Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
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é
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 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 à connecter
developer.unipile.com/mcpConnecter tous les canaux10 canaux
↑↓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.
Scope user--scope user · tous les projets, privé
Scope project.mcp.json à la racine du dépôt, partagé
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.
# 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
- 1Dans le terminal,
claude mcp listaffiche ✔ Connected, etclaude mcp get unipiledonne le détail. - 2Dans une session,
/mcpaffiche le statut et approuve un .mcp.json de projet la première fois. - 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.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.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
API WhatsApp
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
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.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
API Email
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
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.
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
Comptes, Scopes et clés
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
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
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 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.