Gemini CLI · MCP Server
Gemini CLI MCP-server: messaging, e-mail en agenda
Eén gemini mcp add-commando koppelt de Unipile MCP-server. Daarna bouwt uw agent LinkedIn-, WhatsApp-, e-mail- en agendafuncties in uw project en test hij elke call op uw Development-app. Niets te installeren of lokaal te draaien.
7 dagen gratis proberen, geen creditcard nodig.
Gemini CLI · booking-app
Unipile MCP verbonden
Voeg agendaplanning toe aan mijn boekingsapp.
Endpoint lezenGET /v2/{account_id}/calendarsschema geladen
De beschikbaarheidsroute en de boekingsroute toegevoegd. Events komen in de agenda die de gebruiker heeft gekoppeld.
Beschrijf de volgende feature…
Use case
Voeg LinkedIn, WhatsApp en e-mail toe aan uw product vanuit Gemini CLI
Voeg LinkedIn, WhatsApp, e-mail of agenda toe aan uw product. Via de Unipile MCP-server leest Gemini CLI de API-referentie, schrijft de code in uw stack en test elke request.
Koppel de Unipile MCP-server aan Gemini CLIUnipile MCP verbonden
Selecteer de kanalen die u wilt koppelen
developer.unipile.com/mcpAlle kanalen koppelen10 kanalen
↑↓navigeren spatieselecteren ↵koppelenéén URL, één header
settings.json, user of project
Voeg de Unipile MCP-server toe aan Gemini CLI
De server draait remote: één URL via streamable HTTP en één header, niets om lokaal te draaien. Eén commando schrijft hem naar settings.json, user of project, en Gemini CLI maakt bij het opstarten verbinding.
Voordat u begint: Gemini CLI ingelogd, in een vertrouwde map, een Development-applicatie in het Unipile-dashboard met een scoped Account API key, en één testaccount gekoppeld via Hosted Auth.
gemini mcp add, één regelschrijft settings.json voor u
Gebruikersinstellingen~/.gemini/settings.json
Projectinstellingen.gemini/settings.json (standaardscope)
Key uit een omgevingsvariabele$UNIPILE_API_KEY in headers
?
User of project?Het commando gebruikt standaard de projectscope (.gemini/settings.json). Geef --scope user mee voor elk project op de machine.
# Registreer de gehoste Unipile MCP-server voor elk project (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)
# Verifiëren, of typ /mcp binnen een sessie
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" }
}
}
}
// Gecommit met de repository: houd de key in de omgeving, niet in het bestand.
{
"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 voordat u gemini start
Sla het bestand op en start gemini in een vertrouwde map. Geverifieerd op gemini-cli 0.60.0.
httpUrl of url. Schrijf
httpUrl, of url met "type": "http": een kale url wordt gelezen als SSE en toont Disconnected. Bewaar de sleutel in $UNIPILE_API_KEY en laat de optie trust van de server leeg, zodat Gemini CLI elke actie blijft bevestigen.De verbinding controleren
- 1In de terminal toont
gemini mcp listunipile als Connected; Disabled betekent dat de map niet vertrouwd is. - 2In een sessie toont
/mcpelke server met zijn status, en/mcp descbeschrijft elke actie. - 3Vraag in een chat
Using the Unipile MCP, list the endpoints for LinkedIn people search and their required parametersen verwacht echte routes terug.
Prompts, geen lijmcode
Geef uw agent de prompt
Drie integratietaken, elk met de prompt om in Gemini CLI te plakken, de endpoints die de agent aanroept op
https://api.unipile.com met uw X-API-KEY, en wat er in uw project terechtkomt.Voeg agendaplanning toe aan mijn boekingsapp: lees de beschikbaarheid van elke gebruiker over een week en maak de afspraak aan in de agenda die ze hebben gekoppeld, Google of Outlook.
Endpoint lezenGET /v2/{account_id}/calendars/{calendar_id}/eventsschema geladen
Request uitvoerenPOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Toegevoegd
GET /api/availability (events in het gevraagde venster, bezette slots server-side berekend) en POST /api/bookings, dat het event met deelnemers in de agenda van de gebruiker aanmaakt en de teruggegeven event-ID opslaat. Tijdzones komen uit de agenda. Een testevent aangemaakt op de Development-app.Beschikbaarheid en events aanmaken in de agenda die uw gebruiker heeft gekoppeld
Google Calendar en Outlook Calendar delen dezelfde agendaroutes. Gemini CLI leest de schema's voor agenda's, events en deelnemers, schrijft de beschikbaarheidslogica en de boekingsroute, en maakt één event aan in een testagenda.
Endpoints die de agent gebruikt
Bekijk alle kanalen op de Unipile MCP-server
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Onze inbox synchroniseert LinkedIn en WhatsApp al met Unipile. Voeg Instagram en Telegram toe met hetzelfde threadmodel en hetzelfde reply-endpoint.
Endpoints zoeken"chats messages attendees"3 resultaten
Request uitvoerenGET /v2/{account_id}/chats200 OK
Geen nieuw model: chats van Instagram en Telegram lopen via dezelfde chat- en berichtroutes, dus de sync-job loopt nu over elk gekoppeld account, ongeacht de provider, en het reply-endpoint verstuurt via het eigen account van de chat. De twee providerbadges toegevoegd en de sync uitgevoerd op de Development-app met één Instagram- en één Telegram-testaccount.
Dezelfde routes, twee kanalen extra, geen nieuw model
Elke messagingprovider gebruikt dezelfde chatroutes, dus een inbox uitbreiden betekent accounts koppelen via Hosted Auth. De agent controleert de providerspecifieke velden en laat uw threadmodel ongewijzigd.
Endpoints die de agent gebruikt
Bouw een unified inbox met een agent
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Review mijn huidige Unipile-integratie op foute ID's, onveilige retries en calls die webhooks zouden moeten zijn, en stel de oplossingen voor.
Endpoint lezenPOST /v2/{account_id}/chats/{chat_id}/messages/sendschema geladen
Endpoint lezenPOST /v2/webhooks/endpoints/schema geladen
Drie problemen gevonden: de send-call gebruikte het eerste account van de workspace in plaats van het account van de chat; de retry-wrapper verstuurde berichten opnieuw na een time-out; de inbox pollde de chatroute elke 30 seconden. Voorgestelde patches: account-ID uit de chat, retries beperkt tot leesacties, een webhook-endpoint voor berichtevents. Toegepast en gecontroleerd op de Development-app.
Een audit tegen het echte contract, niet tegen het geheugen
De agent vergelijkt uw code met de echte request- en responseschema's: accountvelden, idempotente calls, pollinglussen die webhooks vervangen. De review komt binnen als diff, getest op uw Development-applicatie.
Endpoints die de agent gebruikt
Webhooks koppelen met een agent
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Eerst een Development-applicatie
Geef Gemini CLI een scoped key uit een Development-applicatie, gescheiden van Production.
Testaccounts, echte requests
De agent voert requests uit op testaccounts, namens de geauthenticeerde gebruiker die ze heeft gekoppeld, binnen de limieten van elke provider.
Valideer elke flow
Controleer de koppelingsflow, één lees- en één schrijfactie per feature, en een webhooklevering.
Zet daarna over naar Production
Niets raakt de accounts van uw gebruikers totdat u de sleutel omzet. Zie beveiliging en compliance.
Probleemoplossing
Veelvoorkomende fouten en wat ze betekenen
Wat gemini mcp list en /mcp tonen als een entry niet klopt, en de oplossing voor elk.
No MCP servers configured.
Zet mcpServers op het hoogste niveau van ~/.gemini/settings.json of .gemini/settings.json, zonder komma aan het eind.
Disconnected
Gebruik httpUrl, of url met "type": "http", want een kale url wordt gelezen als SSE.
Disabled, map niet vertrouwd
Accepteer de vertrouwensvraag bij de eerste start, of voer gemini trust uit in het project.
Op de verkeerde plek toegevoegd
Voeg --scope user toe aan gemini mcp add, dat standaard het projectbestand .gemini/settings.json gebruikt.
401 Unauthorized bij requests
Connected controleert de sleutel niet: exporteer de variabele die in headers staat en gebruik een scoped Account API key.
Time-out
Controleer het netwerk, een eventuele proxy en de URL voordat u timeout op de entry instelt.
6000+
Bedrijven innoveren met Unipile
Vertrouwd door marktleiders
1 API
Activiteiten stroomlijnen voor alle belangrijke communicatiekanalen
2 dagen
Snel live integratie bereiken met minimale installatie
30%
Vermindering van onderhoudsinspanningen en -middelen
Ingebouwde beveiliging en compliance
Enterprise-bescherming voor uw gegevens en workflows Meer informatie over onze beveiliging
SOC 2 type II
Gecertificeerd
Onafhankelijk gecontroleerde beveiligingscontroles voor gegevensbescherming en operationele integriteit.
GDPR
Conform
Volledige naleving van de Europese regelgeving voor gegevensbescherming voor de privacy van gebruikers.
99.9%
Platform Uptime over de laatste 24 maanden
24/7
Wereldwijde ondersteuning met krachtige API
FAQ Gemini CLI MCP-server
De vragen die mensen echt intypen: httpUrl of url, waar settings.json staat, één commando in plaats van JSON, de key buiten het bestand houden, Disconnected, No MCP servers configured, de VS Code-extensie en keys.
De documentatie definieert
httpUrl als het streamable HTTP-endpoint en url als een SSE-endpoint. Het commando gemini mcp add --transport http schrijft url samen met "type": "http", en beide vormen maken verbinding in de huidige versies. Schrijft u het bestand met de hand, gebruik dan httpUrl: een kale url zonder type wordt als SSE gelezen, de meest genoemde oorzaak van een Disconnected-server.Gebruikersinstellingen in
~/.gemini/settings.json, projectinstellingen in .gemini/settings.json in de root van uw project, allebei onder de mcpServers key, en projectinstellingen overschrijven gebruikersinstellingen. Let op de standaard van het commando: gemini mcp add schrijft naar de project-scope, behalve met --scope user.Ja, en dat is de aanbevolen 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". De --header flag is herhaalbaar en mag overal in het commando staan. Gecontroleerd op gemini-cli 0.60.0.Schrijf de headerwaarde als
"$UNIPILE_API_KEY" of "${UNIPILE_API_KEY}". Gemini CLI expandeert omgevingsvariabelen in settings.json, headers inbegrepen, dus het projectbestand kan zonder geheim worden gecommit en elke developer exporteert zijn eigen scoped Account API key voordat hij gemini start.Op volgorde: de transport-key (
httpUrl voor streamable HTTP, of url met "type": "http"), een project-settings.json die de uwe overschrijft of andersom, het vertrouwen van de map (een niet-vertrouwde map schakelt elke server uit), en tot slot een status Disconnected terwijl acties werken, wat komt door een optionele ping in de specificatie. Gebruik gemini mcp list, en daarna /mcp binnen een sessie.Gemini CLI vond geen
mcpServers entry in de configuratie die het vanuit de huidige map leest. Controleer of het bestand in ~/.gemini/ of in .gemini/ in de root van het project staat, of mcpServers op het hoogste niveau van de JSON staat, en of de JSON geldig is: een komma aan het eind is genoeg om het bestand te laten negeren.Deze pagina gaat over Gemini CLI in de terminal, en de configuratie die hier wordt beschreven, is de settings.json die de CLI leest. De extensie heeft eigen MCP-instellingen in VS Code; raadpleeg de documentatie ervan voordat u ervan uitgaat dat het bestand gedeeld wordt.
De server antwoordt zonder key zolang de agent alleen de API-specificatie leest. Om echte requests uit te voeren, maakt u een Scope aan in uw Development-applicatie, wijst u de testaccounts toe en genereert u een scoped Account API key voor die Scope. Geef een MCP-client nooit een Service key of een globale Account key.