Guide all'integrazione
Guida all'API di LinkedIn
Guida all'API email
Guida all'API di WhatsApp
Contatta le vendite
Gemini CLI · Server MCP
Server MCP per Gemini CLI: messaggistica, email e calendario
Un solo comando gemini mcp add collega il Server MCP Unipile. Il suo agente costruisce poi funzionalità LinkedIn, WhatsApp, email e calendario nel suo progetto e testa ogni chiamata sulla sua applicazione Development. Niente da installare o avviare in locale.
Prova gratuita di 7 giorni, senza carta di credito.
Gemini CLI · booking-app
Unipile MCP connesso
Aggiungi la pianificazione tramite calendario alla mia app di prenotazione.
Lettura endpointGET /v2/{account_id}/calendarsschema caricato
Aggiunte la route di disponibilità e quella di prenotazione. Gli eventi finiscono nel calendario collegato dall'utente.
Descriva la prossima funzionalità…
Caso d'uso
Aggiunga LinkedIn, WhatsApp ed email al suo prodotto da Gemini CLI
Aggiunga LinkedIn, WhatsApp, email o calendario al suo prodotto. Tramite il Server MCP Unipile, Gemini CLI legge il riferimento API, scrive il codice nel suo stack e testa ogni richiesta.
Connettere il server MCP Unipile a Gemini CLIUnipile MCP connesso
Selezioni i canali da connettere
developer.unipile.com/mcpConnetti tutti i canali10 canali
↑↓naviga spazioseleziona ↵connettiun URL, un header
settings.json, utente o progetto
Aggiungere il server MCP Unipile a Gemini CLI
Il server è remoto: un URL in streamable HTTP e un header, nulla da eseguire in locale. Un solo comando lo scrive in settings.json, utente o progetto, e Gemini CLI si connette all'avvio.
Prima di iniziare: Gemini CLI con accesso effettuato, in una cartella attendibile, un'applicazione Development nella dashboard Unipile con una scoped Account API key e un account di test collegato tramite Hosted Auth.
gemini mcp add, una rigascrive settings.json al posto suo
Impostazioni utente~/.gemini/settings.json
Impostazioni di progetto.gemini/settings.json (scope predefinito)
Chiave da una variabile d'ambiente$UNIPILE_API_KEY negli headers
?
Utente o progetto?Per impostazione predefinita il comando usa lo scope di progetto (.gemini/settings.json). Passi --scope user per tutti i progetti della macchina.
# Registri il server MCP Unipile ospitato per tutti i progetti (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)
# Verifichi, oppure digiti /mcp in una sessione
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" }
}
}
}
// Committato con il repository: tenga la chiave nell'ambiente, non nel file.
{
"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 prima di avviare gemini
Salvi il file e avvii gemini in una cartella attendibile. Verificato su gemini-cli 0.60.0.
httpUrl o url. Scriva
httpUrl, oppure url con "type": "http": un url da solo viene letto come SSE e mostra Disconnected. Tenga la chiave in $UNIPILE_API_KEY e lasci non impostata l'opzione trust del server, così Gemini CLI chiede ancora conferma per ogni azione.Verificare la connessione
- 1Dal terminale,
gemini mcp listmostra unipile come Connected; Disabled significa che la cartella non è attendibile. - 2Dentro una sessione,
/mcpelenca ogni server con il suo stato e/mcp descdescrive ogni azione. - 3In una chat, chieda
Usando l'MCP di Unipile, elenca gli endpoint per la ricerca di persone su LinkedIn e i loro parametri obbligatorie si aspetti route reali in risposta.
Prompt, non codice di collegamento
Dia il prompt al suo agente
Tre integrazioni, ciascuna con il prompt da incollare in Gemini CLI, gli endpoint che l'agente esegue su
https://api.unipile.com con la sua X-API-KEY e ciò che arriva nel suo progetto.Aggiungi la pianificazione tramite calendario alla mia app di prenotazione: leggi la disponibilità di ogni utente su una settimana e crea la riunione nel calendario che ha collegato, Google o Outlook.
Lettura endpointGET /v2/{account_id}/calendars/{calendar_id}/eventsschema caricato
Esecuzione richiestaPOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Aggiunte
GET /api/availability (eventi nella finestra richiesta, slot occupati calcolati lato server) e POST /api/bookings, che crea l'evento con i partecipanti nel calendario dell'utente e salva l'ID evento restituito. I fusi orari sono presi dal calendario. Creato un evento di test sull'app Development.Disponibilità e creazione di eventi sul calendario collegato dal suo utente
Google Calendar e Outlook Calendar condividono le stesse route di calendario. Gemini CLI legge gli schemi di calendario, evento e partecipante, scrive la logica di disponibilità e la route di prenotazione e crea un evento su un calendario di test.
Endpoint usati dall'agente
Vedere tutti i canali del server MCP Unipile
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
La nostra inbox sincronizza già LinkedIn e WhatsApp con Unipile. Aggiungi Instagram e Telegram con lo stesso modello di thread e lo stesso endpoint di risposta.
Ricerca endpoint"chats messages attendees"3 risultati
Esecuzione richiestaGET /v2/{account_id}/chats200 OK
Nessun nuovo modello: le chat Instagram e Telegram passano dalle stesse route di chat e messaggi, quindi il job di sincronizzazione ora scorre tutti gli account collegati qualunque sia il provider, e l'endpoint di risposta invia dall'account della chat stessa. Aggiunti i due badge di provider ed eseguita la sync sull'app Development con un account di test Instagram e uno Telegram.
Stesse route, due canali in più, nessun nuovo modello
Ogni provider di messaggistica usa le stesse route di chat, quindi estendere una inbox significa collegare account tramite Hosted Auth. L'agente controlla i campi specifici di ogni provider e lascia invariato il suo modello di thread.
Endpoint usati dall'agente
Costruire una inbox unificata con un agente
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Revisiona la mia integrazione Unipile attuale alla ricerca di ID errati, retry non sicuri e chiamate che dovrebbero essere webhook, e proponi le correzioni.
Lettura endpointPOST /v2/{account_id}/chats/{chat_id}/messages/sendschema caricato
Lettura endpointPOST /v2/webhooks/endpoints/schema caricato
Trovati tre problemi: la chiamata di invio usava il primo account del workspace invece dell'account della chat; il wrapper di retry rinviava i messaggi dopo un timeout; la inbox interrogava la route delle chat ogni 30 secondi. Patch proposte: account ID preso dalla chat, retry limitati alle letture, un endpoint webhook per gli eventi dei messaggi. Applicate e verificate sull'app Development.
Una revisione basata sul contratto reale, non sulla memoria
L'agente confronta il suo codice con gli schemi reali di richiesta e risposta: campi dell'account, chiamate idempotenti, cicli di polling che i webhook sostituiscono. La revisione arriva come diff, testata sulla sua applicazione Development.
Endpoint usati dall'agente
Collegare i webhook con un agente
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Prima un'applicazione Development Dia a Gemini CLI una chiave scoped di un'applicazione Development, separata da quella di Produzione.
Account di test, richieste reali L'agente esegue richieste su account di test, per conto dell'utente autenticato che li ha collegati, nei limiti di ogni provider.
Validare ogni flusso Controlli il flusso di connessione, una lettura e una scrittura per funzionalità e una consegna webhook.
Poi passare alla Produzione Nulla tocca gli account dei suoi utenti finché non cambia la chiave. Veda sicurezza e conformità.
Troubleshooting
Errori frequenti e cosa significano
Che cosa mostrano gemini mcp list e /mcp quando una voce non è corretta, e come risolverla.
No MCP servers configured.
Metta mcpServers al primo livello di ~/.gemini/settings.json o .gemini/settings.json, senza virgola finale.
Disconnected
Usi httpUrl, oppure url con "type": "http", perché un url da solo viene letto come SSE.
Disabled, cartella non attendibile
Accetti la richiesta di attendibilità al primo avvio, oppure esegua gemini trust nel progetto.
Aggiunto nel posto sbagliato
Aggiunga --scope user a gemini mcp add, che per impostazione predefinita scrive nel file di progetto .gemini/settings.json.
401 Unauthorized sulle richieste
Connected non verifica la chiave: esporti la variabile indicata in headers e usi una scoped Account API key.
Timed out
Controlli la rete, eventuali proxy e l'URL prima di impostare timeout sulla voce.
6000+
Aziende che innovano con Unipile
Fiducia da parte dei leader del settore
1 API
Semplificare le operazioni per tutti i principali canali di comunicazione
2 giorni
Integrazione rapida con una configurazione minima
30%
Riduzione dell'impegno e delle risorse per la manutenzione
Sicurezza e conformità integrate
Protezione di livello aziendale per i vostri dati e flussi di lavoro Per saperne di più sulla nostra sicurezza
SOC 2 Tipo II
Certificato
Controlli di sicurezza verificati in modo indipendente che garantiscono la protezione dei dati e l'integrità operativa.
GDPR
Conforme
Piena conformità alle normative europee sulla protezione dei dati per la privacy degli utenti.
99.9%
Uptime della piattaforma negli ultimi 24 mesi
24/7
Supporto globale con API ad alte prestazioni
FAQ server MCP Gemini CLI
Le domande che si pongono davvero: httpUrl o url, dove si trova settings.json, un comando invece del JSON, come tenere la chiave fuori dal file, Disconnected, No MCP servers configured, l'estensione VS Code e le chiavi.
La documentazione definisce
httpUrl come endpoint streamable HTTP e url come endpoint SSE. Il comando gemini mcp add --transport http scrive url insieme a "type": "http", ed entrambe le forme si connettono nelle versioni attuali. Se scrive il file a mano, usi httpUrl: un url senza type viene letto come SSE, la causa più citata di un server Disconnected.Impostazioni utente in
~/.gemini/settings.json, impostazioni di progetto in .gemini/settings.json nella radice del progetto, entrambe sotto la chiave mcpServers , e le impostazioni di progetto prevalgono su quelle utente. Attenzione al valore predefinito del comando: gemini mcp add scrive nello scope di progetto, a meno che non passi --scope user.Sì, ed è il percorso consigliato:
gemini mcp add --transport http --scope user --header "X-API-KEY: your-scoped-api-key" unipile "https://developer.unipile.com/mcp?branch=v2.0". Il flag --header è ripetibile e può stare in qualsiasi punto del comando. Verificato su gemini-cli 0.60.0.Scriva il valore dell'header come
"$UNIPILE_API_KEY" o "${UNIPILE_API_KEY}". Gemini CLI espande le variabili d'ambiente in settings.json, headers inclusi, così il file di progetto può essere committato senza segreti e ogni sviluppatore esporta la propria chiave API Account scoped prima di avviare gemini.In ordine: la chiave di trasporto (
httpUrl per lo streamable HTTP, oppure url con "type": "http"), un settings.json di progetto che prevale sul suo o viceversa, l'attendibilità della cartella (una cartella non attendibile disabilita ogni server) e infine uno stato Disconnected mentre le azioni funzionano, che deriva da un ping opzionale della specifica. Esegua gemini mcp list, poi /mcp all'interno di una sessione.Gemini CLI non ha trovato alcuna voce
mcpServers nella configurazione che legge dalla cartella corrente. Verifichi che il file sia in ~/.gemini/ o in .gemini/ nella radice del progetto, che mcpServers si trovi al primo livello del JSON e che il JSON sia valido: basta una virgola di troppo perché il file venga ignorato.Questa pagina riguarda Gemini CLI nel terminale, e la configurazione descritta qui è il settings.json letto dalla CLI. L'estensione ha le proprie impostazioni MCP in VS Code; consulti la sua documentazione prima di dare per scontato che il file sia condiviso.
Il server risponde senza chiave quando l'agente si limita a leggere la specifica dell'API. Per eseguire richieste reali, crei uno Scope nella sua applicazione Development, vi assegni gli account di test e generi una chiave API Account scoped per quello Scope. Non dia mai a un client MCP una chiave Service o una chiave Account globale.