Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Gemini CLI · MCP Server
Gemini CLI MCP Server: Messaging, E-Mail und Kalender
Ein einziger gemini mcp add Befehl verbindet den Unipile MCP-Server. Ihr Agent baut dann LinkedIn-, WhatsApp-, E-Mail- und Kalender-Features in Ihr Projekt ein und testet jeden Aufruf in Ihrer Development-App. Nichts zu installieren oder lokal zu starten.
7 Tage kostenlos testen, ohne Kreditkarte.
Gemini CLI · booking-app
Unipile MCP verbunden
Ergänze meine Buchungs-App um Kalenderplanung.
Endpoint lesenGET /v2/{account_id}/calendarsSchema geladen
Verfügbarkeits-Route und Buchungs-Route ergänzt. Termine landen im Kalender, den der Nutzer verbunden hat.
Nächstes Feature beschreiben…
Anwendungsfall
LinkedIn, WhatsApp und E-Mail aus Gemini CLI in Ihr Produkt bringen
Bringen Sie LinkedIn, WhatsApp, E-Mail oder Kalender in Ihr Produkt. Über den Unipile MCP-Server liest Gemini CLI die API-Referenz, schreibt den Code in Ihrem Stack und testet jede Anfrage.
Den Unipile MCP-Server mit Gemini CLI verbindenUnipile MCP verbunden
Wählen Sie die Kanäle, die Sie verbinden möchten
developer.unipile.com/mcpAlle Kanäle verbinden10 Kanäle
↑↓navigieren Leertasteauswählen ↵verbindeneine URL, ein Header
settings.json, User oder Projekt
Unipile MCP-Server für Gemini CLI
Der Server ist remote: eine URL über streamable HTTP und ein Header, lokal läuft nichts. Ein Befehl schreibt ihn in settings.json, für den User oder das Projekt, und Gemini CLI verbindet sich beim Start.
Vorab: Gemini CLI angemeldet, in einem vertrauenswürdigen Ordner, eine Development-Anwendung im Unipile-Dashboard mit einem Scoped Account API Key und ein Testkonto, das über Hosted Auth verknüpft ist.
gemini mcp add, eine Zeileschreibt settings.json für Sie
User-Einstellungen~/.gemini/settings.json
Projekteinstellungen.gemini/settings.json (Standard-Scope)
Key aus einer Umgebungsvariablen$UNIPILE_API_KEY in headers
?
User oder Projekt?Der Befehl nutzt standardmäßig den Projekt-Scope (.gemini/settings.json). Übergeben Sie --scope user für alle Projekte auf der Maschine.
# Den gehosteten Unipile MCP-Server für jedes Projekt registrieren (User-Scope)
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)
# Prüfen, oder /mcp in einer Session tippen
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" }
}
}
}
// Mit dem Repository eingecheckt: Den Key in der Umgebung halten, nicht in der Datei.
{
"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 vor dem Start von gemini
Speichern Sie die Datei und starten Sie gemini in einem vertrauenswürdigen Ordner. Geprüft mit gemini-cli 0.60.0.
httpUrl oder url. Schreiben Sie
httpUrl, oder url mit "type": "http": Ein bloßes url wird als SSE gelesen und zeigt Disconnected. Halten Sie den Key in $UNIPILE_API_KEY und lassen Sie die Option trust des Servers ungesetzt, damit Gemini CLI weiterhin jede Aktion bestätigen lässt.Die Verbindung prüfen
- 1Im Terminal zeigt
gemini mcp listunipile als Connected an; Disabled bedeutet, dass der Ordner nicht vertrauenswürdig ist. - 2In einer Session listet
/mcpjeden Server mit seinem Zustand auf, und/mcp descbeschreibt jede Aktion. - 3Fragen Sie im Chat
Liste über den Unipile MCP die Endpoints für die LinkedIn-Personensuche und ihre Pflichtparameter auf: Zurück kommen echte Routen.
Prompts statt Glue Code
Geben Sie Ihrem Agenten den Prompt
Drei Integrationsaufgaben, jeweils mit dem Prompt für Gemini CLI, den Endpoints, die der Agent auf
https://api.unipile.com mit Ihrem X-API-KEY aufruft, und dem, was in Ihrem Projekt landet.Ergänze meine Booking-App um Terminplanung: Lies die Verfügbarkeit jedes Nutzers über eine Woche und erstelle den Termin im Kalender, den er verbunden hat, Google oder Outlook.
Endpoint lesenGET /v2/{account_id}/calendars/{calendar_id}/eventsSchema geladen
Anfrage ausführenPOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Ergänzt
GET /api/availability (Termine im angefragten Zeitfenster, belegte Slots serverseitig berechnet) und POST /api/bookings, das den Termin mit Teilnehmern im Kalender des Nutzers erstellt und die zurückgegebene Event-ID speichert. Die Zeitzonen kommen aus dem Kalender. Testtermin in der Development-App erstellt.Verfügbarkeit und Terminerstellung im Kalender, den Ihr Nutzer verbunden hat
Google Calendar und Outlook Calendar teilen sich dieselben Kalender-Routen. Gemini CLI liest die Schemas für Kalender, Events und Teilnehmer, schreibt die Verfügbarkeitslogik und die Buchungsroute und legt ein Event in einem Testkalender an.
Endpoints, die der Agent nutzt
Alle Kanäle des Unipile MCP-Servers ansehen
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Unser Posteingang synchronisiert LinkedIn und WhatsApp bereits mit Unipile. Ergänze Instagram und Telegram mit demselben Thread-Modell und demselben Antwort-Endpoint.
Endpoints suchen"chats messages attendees"3 Treffer
Anfrage ausführenGET /v2/{account_id}/chats200 OK
Kein neues Modell: Instagram- und Telegram-Chats laufen über dieselben Chat- und Nachrichten-Routen, der Sync-Job iteriert jetzt also unabhängig vom Anbieter über jedes verbundene Konto, und der Antwort-Endpoint sendet über das Konto des jeweiligen Chats. Die zwei Anbieter-Badges ergänzt und den Sync in der Development-App mit je einem Instagram- und Telegram-Testkonto ausgeführt.
Dieselben Routen, zwei Kanäle mehr, kein neues Modell
Jeder Messaging-Anbieter nutzt dieselben Chat-Routen, eine Inbox zu erweitern heißt also, Konten über Hosted Auth zu verknüpfen. Der Agent prüft die anbieterspezifischen Felder und lässt Ihr Thread-Modell unverändert.
Endpoints, die der Agent nutzt
Eine Unified Inbox mit einem Agenten bauen
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Prüfe meine aktuelle Unipile-Integration auf falsche IDs, unsichere Retries und Aufrufe, die Webhooks sein sollten, und schlage die Korrekturen vor.
Endpoint lesenPOST /v2/{account_id}/chats/{chat_id}/messages/sendSchema geladen
Endpoint lesenPOST /v2/webhooks/endpoints/Schema geladen
Drei Befunde: Der Send-Aufruf nutzte das erste Konto des Workspace statt das Konto des Chats; der Retry-Wrapper sendete Nachrichten bei einem Timeout erneut; der Posteingang fragte die Chats-Route alle 30 Sekunden ab. Vorgeschlagene Patches: Konto-ID aus dem Chat, Retries nur auf Lesevorgänge, ein Webhook-Endpoint für Message-Events. In der Development-App angewendet und verifiziert.
Ein Audit gegen den echten Vertrag, nicht gegen das Gedächtnis
Der Agent vergleicht Ihren Code mit den echten Request- und Response-Schemas: Kontofelder, idempotente Aufrufe, Polling-Schleifen, die Webhooks ersetzen. Der Review landet als Diff, getestet in Ihrer Development-Anwendung.
Endpoints, die der Agent nutzt
Webhooks mit einem Agenten einrichten
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Zuerst eine Development-Anwendung
Geben Sie Gemini CLI einen Scoped Key aus einer Development-Anwendung, getrennt von Production.
Testkonten, echte Anfragen
Der Agent führt Anfragen auf Testkonten aus, im Namen des authentifizierten Nutzers, der sie verknüpft hat, innerhalb der Limits jedes Anbieters.
Jeden Ablauf prüfen
Prüfen Sie den Verbindungsablauf, je einen Lese- und Schreibvorgang pro Funktion und eine Webhook-Zustellung.
Dann auf Production umstellen
Nichts berührt die Konten Ihrer Nutzer, bevor Sie den Key umstellen. Siehe Sicherheit und Compliance.
Fehlerbehebung
Häufige Fehler und was sie bedeuten
Was gemini mcp list und /mcp zeigen, wenn ein Eintrag nicht stimmt, und die jeweilige Lösung.
No MCP servers configured.
Setzen Sie mcpServers auf die oberste Ebene von ~/.gemini/settings.json oder .gemini/settings.json, ohne überzähliges Komma.
Disconnected
Verwenden Sie httpUrl, oder url mit "type": "http", denn ein bloßes url wird als SSE gelesen.
Disabled, Ordner nicht vertrauenswürdig
Bestätigen Sie den Trust-Dialog beim ersten Start oder führen Sie gemini trust im Projekt aus.
An der falschen Stelle hinzugefügt
Ergänzen Sie --scope user bei gemini mcp add, das standardmäßig in die Projektdatei .gemini/settings.json schreibt.
401 Unauthorized bei Anfragen
Connected prüft den Key nicht: Exportieren Sie die in headers genannte Variable und verwenden Sie einen Scoped Account API Key.
Timed out
Prüfen Sie Netzwerk, Proxy und URL, bevor Sie timeout im Eintrag setzen.
6000+
Unternehmen, die mit Unipile innovieren
Vertrauen bei Branchenführern
1 API
Rationalisierung der Abläufe für alle wichtigen Kommunikationskanäle
2 Tage
Schnelle Live-Integration mit minimaler Einrichtung
30%
Verringerung des Wartungsaufwands und der Ressourcen
Integrierte Sicherheit und Compliance
Unternehmensgerechter Schutz für Ihre Daten und Arbeitsabläufe Erfahren Sie mehr über unsere Sicherheit
SOC 2 Typ II
Zertifiziert
Unabhängig geprüfte Sicherheitskontrollen zur Gewährleistung des Datenschutzes und der betrieblichen Integrität.
GDPR
Konform
Vollständige Einhaltung der europäischen Datenschutzbestimmungen zum Schutz der Privatsphäre der Nutzer.
99.9%
Betriebszeit der Plattform in den letzten 24 Monaten
24/7
Globaler Support mit leistungsstarker API
FAQ zum Gemini CLI MCP-Server
Die Fragen, die wirklich gestellt werden: httpUrl oder url, wo settings.json liegt, ein Befehl statt JSON, den Key aus der Datei halten, Disconnected, No MCP servers configured, die VS-Code-Erweiterung und Keys.
Die Dokumentation definiert
httpUrl als streamable-HTTP-Endpoint und url als SSE-Endpoint. Der Befehl gemini mcp add --transport http schreibt url zusammen mit "type": "http", und beide Formen verbinden sich in aktuellen Versionen. Schreiben Sie die Datei von Hand, nutzen Sie httpUrl: Ein bloßes url ohne type wird als SSE gelesen, die meistgenannte Ursache für einen Disconnected-Server.User-Einstellungen in
~/.gemini/settings.json, Projekteinstellungen in .gemini/settings.json im Wurzelverzeichnis Ihres Projekts, beide unter dem Key mcpServers , und Projekteinstellungen überschreiben User-Einstellungen. Beachten Sie den Standard des Befehls: gemini mcp add schreibt in den Projekt-Scope, es sei denn, Sie übergeben --scope user.Ja, und das ist der empfohlene Weg:
gemini mcp add --transport http --scope user --header "X-API-KEY: your-scoped-api-key" unipile "https://developer.unipile.com/mcp?branch=v2.0". Das Flag --header ist wiederholbar und kann an beliebiger Stelle im Befehl stehen. Geprüft mit gemini-cli 0.60.0.Schreiben Sie den Header-Wert als
"$UNIPILE_API_KEY" oder "${UNIPILE_API_KEY}". Gemini CLI löst Umgebungsvariablen in settings.json auf, Header eingeschlossen, die Projektdatei lässt sich also ohne Secret einchecken, und jeder Entwickler exportiert vor dem Start von gemini seinen eigenen Scoped Account API Key.Der Reihe nach: den Transport-Key (
httpUrl für streamable HTTP, oder url ein, mit "type": "http"), eine Projekt-settings.json, die Ihre überschreibt, oder umgekehrt, das Vertrauen für den Ordner (ein nicht vertrauenswürdiger Ordner deaktiviert jeden Server), und schließlich einen als Disconnected angezeigten Status, während die Actions funktionieren, was von einem optionalen Ping in der Spezifikation kommt. Führen Sie gemini mcp listaus, danach /mcp in einer Session.Gemini CLI hat in der Konfiguration, die es aus dem aktuellen Ordner liest, keinen Eintrag
mcpServers gefunden. Prüfen Sie, dass die Datei in ~/.gemini/ oder in .gemini/ im Projektwurzelverzeichnis liegt, dass mcpServers auf oberster Ebene des JSON steht und dass das JSON gültig ist: Ein überzähliges Komma genügt, damit die Datei ignoriert wird.Diese Seite behandelt Gemini CLI im Terminal, und die hier beschriebene Konfiguration ist die settings.json, die die CLI liest. Die Erweiterung hat ihre eigenen MCP-Einstellungen in VS Code; prüfen Sie deren Dokumentation, bevor Sie davon ausgehen, dass die Datei geteilt wird.
Der Server antwortet ohne Key, solange der Agent nur die API-Spezifikation liest. Für echte Anfragen erstellen Sie in Ihrer Development-Anwendung einen Scope, weisen die Testkonten zu und erzeugen einen Scoped Account API Key für diesen Scope. Geben Sie einem MCP-Client nie einen Service-Key oder einen globalen Account-Key.