FR
Gemini CLI · Serveur MCP

Serveur MCP Gemini CLI : messagerie, email et agenda

Une seule commande gemini mcp add connecte le serveur MCP Unipile. Votre agent intègre ensuite des fonctionnalités LinkedIn, WhatsApp, email et calendrier 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.
Gemini CLI · booking-app
Unipile MCP connecté
Sarah
Ajoute la prise de rendez-vous par agenda à mon app de réservation.
Endpoint de lectureGET /v2/{account_id}/calendarsschéma chargé
Ajout de la route de disponibilités et de la route de réservation. Les événements arrivent dans l'agenda connecté par 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 Gemini CLI

Ajoutez LinkedIn, WhatsApp, l'email ou l'agenda à votre produit. Via le serveur MCP Unipile, Gemini CLI lit la référence API, écrit le code dans votre stack et teste chaque requête.
Connecter le serveur MCP Unipile à Gemini CLIUnipile 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
settings.json, user ou projet

Ajouter le serveur MCP Unipile à Gemini CLI

Le serveur est distant : une URL en HTTP streamable et un en-tête, rien à exécuter en local. Une commande l'écrit dans settings.json, user ou projet, et Gemini CLI se connecte au lancement.
Avant de commencer : Gemini CLI connecté, dans un dossier approuvé, une application Development dans le dashboard Unipile avec une clé Account API scopée, et un compte de test relié via Hosted Auth.
1
gemini mcp add, une ligneécrit settings.json pour vous
U
Paramètres user~/.gemini/settings.json
P
Paramètres de projet.gemini/settings.json (scope par défaut)
E
Clé issue d'une variable d'environnement$UNIPILE_API_KEY dans headers
?
User ou projet ?La commande utilise par défaut le scope project (.gemini/settings.json). Passez --scope user pour tous les projets de la machine.
terminal
# Enregistrer le serveur MCP Unipile hébergé pour tous les projets (scope user) gemini mcp add --transport http --scope user \ --header "X-API-KEY: your-scoped-api-key" \ unipile "https://developer.unipile.com/mcp?branch=v2.0" # MCP server "unipile" added to user settings. (http) # Vérifier, ou taper /mcp dans une session gemini mcp list # ✓ unipile: https://developer.unipile.com/mcp?branch=v2.0 (http) - Connected
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "type": "http", "headers": { "X-API-KEY": "your-scoped-api-key" } } } }
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "type": "http", "headers": { "X-API-KEY": "$UNIPILE_API_KEY" } } } } // Commité avec le dépôt : gardez la clé dans l'environnement, pas dans le fichier.
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "type": "http", "headers": { "X-API-KEY": "${{UNIPILE_API_KEY}}" } } } } // export UNIPILE_API_KEY=your-scoped-api-key avant de lancer gemini
Enregistrez le fichier et lancez gemini dans un dossier approuvé. Vérifié sur gemini-cli 0.60.0.
httpUrl ou url. Écrivez httpUrl, ou url avec "type": "http" : un url seul est lu comme SSE et affiche Disconnected. Gardez la clé dans $UNIPILE_API_KEY et ne définissez pas l'option trust du serveur, pour que Gemini CLI confirme toujours chaque action.

Vérifier la connexion

  1. 1Dans le terminal, gemini mcp list affiche unipile comme Connected ; Disabled signifie que le dossier n'est pas approuvé.
  2. 2Dans une session, /mcp liste chaque serveur avec son état, et /mcp desc décrit chaque action.
  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 Gemini CLI, les endpoints que l'agent exécute sur https://api.unipile.com avec votre X-API-KEY, et ce qui arrive dans votre projet.
Gemini CLI · booking-appApplication Development
Ajoute la prise de rendez-vous à mon app de réservation : lis les disponibilités de chaque utilisateur sur une semaine et crée la réunion dans l'agenda qu'il a connecté, Google ou Outlook.
Endpoint de lectureGET /v2/{account_id}/calendars/{calendar_id}/eventsschéma chargé
Exécuter la requêtePOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Ajout de GET /api/availability (événements sur la fenêtre demandée, créneaux occupés calculés côté serveur) et POST /api/bookings, qui crée l'événement avec ses participants dans l'agenda de l'utilisateur et stocke l'ID d'événement renvoyé. Les fuseaux horaires sont repris de l'agenda. Événement de test créé sur l'application Development.4 fichiers modifiés · testé sur l'application Development

Disponibilités et création d'événements dans l'agenda connecté par votre utilisateur

Google Calendar et Outlook Calendar partagent les mêmes routes d'agenda. Gemini CLI lit les schémas d'agenda, d'événement et de participant, écrit la logique de disponibilité et la route de réservation, puis crée un événement dans un agenda de test.
Endpoints utilisés par l'agent
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Voir tous les canaux du serveur MCP Unipile
Gemini CLI · support-inboxApplication Development
Notre inbox synchronise déjà LinkedIn et WhatsApp avec Unipile. Ajoute Instagram et Telegram avec le même modèle de fil et le même endpoint de réponse.
Rechercher des endpoints"chats messages attendees"3 résultats
Exécuter la requêteGET /v2/{account_id}/chats200 OK
Pas de nouveau modèle : les chats Instagram et Telegram passent par les mêmes routes de chat et de message. Le job de synchro parcourt donc désormais chaque compte connecté, quel que soit le fournisseur, et l'endpoint de réponse envoie depuis le compte propriétaire du chat. Ajout des deux badges fournisseur et synchro exécutée sur l'application Development avec un compte de test Instagram et un Telegram.3 fichiers modifiés · 4 canaux dans une seule liste

Mêmes routes, deux canaux de plus, aucun nouveau modèle

Tous les fournisseurs de messagerie utilisent les mêmes routes de chat : étendre une inbox revient à relier des comptes via Hosted Auth. L'agent vérifie les champs propres à chaque fournisseur et laisse votre modèle de thread inchangé.
Endpoints utilisés par l'agent
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Créer une inbox unifiée avec un agent
Gemini CLI · crm-appApplication Development
Relis mon intégration Unipile actuelle pour repérer les ID incorrects, les retries risqués et les appels qui devraient être des webhooks, et propose les corrections.
Endpoint de lecturePOST /v2/{account_id}/chats/{chat_id}/messages/sendschéma chargé
Endpoint de lecturePOST /v2/webhooks/endpoints/schéma chargé
Trois problèmes trouvés : l'envoi utilisait le premier compte du workspace au lieu du compte du chat ; le wrapper de retry renvoyait les messages après un timeout ; l'inbox interrogeait la route des chats toutes les 30 secondes. Correctifs proposés : ID du compte repris du chat, retries limités aux lectures, endpoint webhook pour les événements de message. Appliqués et vérifiés sur l'application Development.3 constats · 3 correctifs · vérifiés sur l'application Development

Un audit face au vrai contrat, pas de mémoire

L'agent compare votre code aux vrais schémas de requête et de réponse : champs de compte, appels idempotents, boucles de polling que les webhooks remplacent. La revue arrive sous forme de diff, testé sur votre application Development.
Endpoints utilisés par l'agent
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Brancher les webhooks avec un agent
Une application Development d'abord Donnez à Gemini CLI 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 qu'affichent gemini mcp list et /mcp quand une entrée est incorrecte, et la correction de chaque cas.
No MCP servers configured.
Placez mcpServers au premier niveau de ~/.gemini/settings.json ou de .gemini/settings.json, sans virgule finale.
Disconnected
Utilisez httpUrl, ou url avec "type": "http", car un url seul est lu comme SSE.
Disabled, dossier non approuvé
Acceptez l'invite d'approbation au premier lancement, ou lancez gemini trust dans le projet.
Ajouté au mauvais endroit
Ajoutez --scope user à gemini mcp add, qui écrit par défaut dans le fichier de projet .gemini/settings.json.
401 Unauthorized sur les requêtes
Connected ne vérifie pas la clé : exportez la variable nommée dans headers et utilisez une clé Account API scopée.
Timed out
Vérifiez le réseau, un éventuel proxy et l'URL avant de définir timeout sur l'entrée.
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 Gemini CLI

Les questions réellement posées : httpUrl ou url, emplacement de settings.json, une commande au lieu du JSON, la clé hors du fichier, Disconnected, No MCP servers configured, l'extension VS Code et les clés.
La documentation définit httpUrl comme l'endpoint HTTP streamable et url comme un endpoint SSE. La commande gemini mcp add --transport http écrit url accompagné de "type": "http", et les deux formes se connectent sur les versions actuelles. Si vous écrivez le fichier à la main, utilisez httpUrl : un url sans type est lu comme SSE, la cause la plus citée d'un serveur Disconnected.
Les paramètres user dans ~/.gemini/settings.json, les paramètres de projet dans .gemini/settings.json à la racine de votre projet, tous deux sous la clé mcpServers , et les paramètres de projet priment sur les paramètres user. Attention au comportement par défaut de la commande : gemini mcp add écrit dans le scope project sauf si vous passez --scope user.
Oui, et c'est la voie recommandée : gemini mcp add --transport http --scope user --header "X-API-KEY: your-scoped-api-key" unipile "https://developer.unipile.com/mcp?branch=v2.0". Le flag --header est répétable et peut se placer n'importe où dans la commande. Vérifié sur gemini-cli 0.60.0.
Écrivez la valeur de l'en-tête sous la forme "$UNIPILE_API_KEY" ou "${UNIPILE_API_KEY}". Gemini CLI développe les variables d'environnement dans settings.json, headers compris : le fichier de projet peut donc être commité sans secret, et chaque développeur exporte sa propre clé Account API scopée avant de lancer gemini.
Dans l'ordre : la clé de transport (httpUrl pour le HTTP streamable, ou url avec "type": "http"), un settings.json de projet qui écrase le vôtre ou l'inverse, l'approbation du dossier (un dossier non approuvé désactive tous les serveurs), et enfin un état Disconnected alors que les actions fonctionnent, qui vient d'un ping facultatif de la spécification. Lancez gemini mcp list, puis /mcp dans une session.
Gemini CLI n'a trouvé aucune entrée mcpServers dans la configuration qu'il lit depuis le dossier courant. Vérifiez que le fichier se trouve dans ~/.gemini/ ou dans .gemini/ à la racine du projet, que mcpServers est au premier niveau du JSON, et que le JSON est valide : une virgule finale suffit à faire ignorer le fichier.
Cette page couvre Gemini CLI dans le terminal, et la configuration décrite ici est le settings.json lu par la CLI. L'extension a ses propres paramètres MCP dans VS Code ; consultez sa documentation avant de supposer que le fichier est partagé.
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.