Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
Gemini CLI · MCP Sunucusu
Gemini CLI MCP Sunucusu: mesajlaşma, e-posta ve takvim
Tek bir gemini mcp add komutu Unipile MCP sunucusunu bağlar. Ardından ajanınız projenize LinkedIn, WhatsApp, e-posta ve takvim özellikleri ekler ve her çağrıyı Development uygulamanızda test eder. Yerel olarak kurulacak veya çalıştırılacak bir şey yok.
7 gün ücretsiz deneme, kredi kartı gerekmez.
Gemini CLI · booking-app
Unipile MCP bağlı
Rezervasyon uygulamama takvim planlaması ekle.
Endpoint'i okuGET /v2/{account_id}/calendarsşema yüklendi
Uygunluk route'u ve rezervasyon route'u eklendi. Etkinlikler kullanıcının bağladığı takvime düşüyor.
Sonraki özelliği anlatın…
Kullanım senaryosu
Gemini CLI'dan ürününüze LinkedIn, WhatsApp ve e-posta ekleyin
Ürününüze LinkedIn, WhatsApp, e-posta veya takvim ekleyin. Unipile MCP sunucusu sayesinde Gemini CLI API referansını okur, kodu sizin stack'inizde yazar ve her isteği test eder.
Unipile MCP sunucusunu Gemini CLI'a bağlayınUnipile MCP bağlı
Bağlamak istediğiniz kanalları seçin
developer.unipile.com/mcpTüm kanalları bağla10 kanal
↑↓gezin boşlukseç ↵bağlatek URL, tek header
settings.json, user veya project
Unipile MCP sunucusunu ekleyin: Gemini CLI
Sunucu uzaktadır: streamable HTTP üzerinden tek bir URL ve tek bir header, yerelde çalıştırılacak hiçbir şey yok. Tek bir komut onu settings.json'a (user veya project) yazar; Gemini CLI açılışta bağlanır.
Başlamadan önce: Gemini CLI'da oturum açılmış ve güvenilir bir klasörde olmalısınız; Unipile dashboard içinde Scope'a bağlı bir Account API anahtarına sahip bir Development uygulaması ve Hosted Auth ile bağlanmış bir test hesabı gerekir.
gemini mcp add, tek satırsettings.json dosyasını sizin için yazar
User ayarları~/.gemini/settings.json
Project ayarları.gemini/settings.json (varsayılan kapsam)
Anahtar bir ortam değişkenindenheaders içinde $UNIPILE_API_KEY
?
User mı, project mi?Komut varsayılan olarak project kapsamını (.gemini/settings.json) kullanır. Makinedeki tüm projeler için --scope user ekleyin.
# Barındırılan Unipile MCP sunucusunu tüm projeler için kaydedin (user kapsamı)
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)
# Doğrulayın ya da oturum içinde /mcp yazın
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" }
}
}
}
// Depoyla birlikte commit edilir: anahtarı dosyada değil, ortamda tutun.
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"type": "http",
"headers": { "X-API-KEY": "${{UNIPILE_API_KEY}}" }
}
}
}
// gemini'yi başlatmadan önce: export UNIPILE_API_KEY=your-scoped-api-key
Dosyayı kaydedin ve gemini'yi güvenilir bir klasörde başlatın. gemini-cli 0.60.0 ile doğrulandı.
httpUrl mi, url mi? Ya
httpUrl ya da url ile birlikte "type": "http" yazın: tek başına bir url SSE olarak okunur ve Disconnected gösterir. Anahtarı $UNIPILE_API_KEY içinde tutun ve sunucunun trust seçeneğini ayarlamadan bırakın; böylece Gemini CLI her action'ı onaylamaya devam eder.Bağlantıyı doğrulayın
- 1Terminalde
gemini mcp listunipile'ı Connected olarak gösterir; Disabled, klasörün güvenilir olmadığı anlamına gelir. - 2Bir oturumda
/mcptüm sunucuları durumlarıyla listeler,/mcp descise her action'ı açıklar. - 3Bir sohbette şunu sorun:
Unipile MCP'yi kullanarak LinkedIn kişi araması endpoint'lerini ve zorunlu parametrelerini listeleve yanıt olarak gerçek route'lar bekleyin.
Glue code değil, prompt'lar
Ajanınıza prompt'u verin
Üç entegrasyon görevi; her biri için Gemini CLI'a yapıştırılacak prompt, ajanın
https://api.unipile.com üzerinde X-API-KEY anahtarınızla çalıştırdığı endpoint'ler ve projenize eklenenler.Rezervasyon uygulamama takvim planlaması ekle: her kullanıcının bir haftalık uygunluğunu oku ve toplantıyı bağladıkları takvimde (Google veya Outlook) oluştur.
Endpoint'i okuGET /v2/{account_id}/calendars/{calendar_id}/eventsşema yüklendi
İsteği çalıştırPOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Eklenen route'lar:
GET /api/availability (istenen aralıktaki etkinlikler, dolu dilimler sunucu tarafında hesaplanır) ve POST /api/bookings; ikincisi etkinliği katılımcılarla birlikte kullanıcının takviminde oluşturur ve dönen etkinlik ID'sini saklar. Saat dilimleri takvimden alınır. Development uygulamasında bir test etkinliği oluşturuldu.Kullanıcınızın bağladığı takvimde uygunluk ve etkinlik oluşturma
Google Calendar ve Outlook Calendar aynı takvim route'larını paylaşır. Gemini CLI takvim, etkinlik ve katılımcı şemalarını okur, uygunluk mantığını ve rezervasyon route'unu yazar ve bir test takviminde bir etkinlik oluşturur.
Ajanın kullandığı endpoint'ler
Unipile MCP sunucusundaki tüm kanalları görün
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Inbox'ımız LinkedIn ve WhatsApp'ı zaten Unipile ile senkronize ediyor. Aynı thread modeli ve aynı yanıt endpoint'iyle Instagram ve Telegram ekle.
Endpoint ara"chats messages attendees"3 eşleşme
İsteği çalıştırGET /v2/{account_id}/chats200 OK
Yeni model yok: Instagram ve Telegram sohbetleri aynı chat ve message route'larından gelir; bu yüzden senkronizasyon işi artık sağlayıcıdan bağımsız olarak bağlı her hesabı dolaşıyor, yanıt endpoint'i de sohbetin kendi hesabı üzerinden gönderiyor. İki sağlayıcı rozeti eklendi ve senkronizasyon Development uygulamasında bir Instagram ve bir Telegram test hesabıyla çalıştırıldı.
Aynı route'lar, iki kanal daha, yeni model yok
Her mesajlaşma sağlayıcısı aynı chat route'larını kullanır; bu yüzden bir inbox'ı genişletmek, hesapları Hosted Auth ile bağlamak demektir. Ajan sağlayıcıya özgü alanları kontrol eder ve thread modelinizi değiştirmeden korur.
Ajanın kullandığı endpoint'ler
Ajanla birleşik inbox oluşturun
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Mevcut Unipile entegrasyonumu hatalı ID'ler, güvensiz yeniden denemeler ve webhook olması gereken çağrılar açısından incele ve düzeltmeleri öner.
Endpoint'i okuPOST /v2/{account_id}/chats/{chat_id}/messages/sendşema yüklendi
Endpoint'i okuPOST /v2/webhooks/endpoints/şema yüklendi
Üç sorun bulundu: gönderim çağrısı sohbetin hesabı yerine workspace'in ilk hesabını kullanıyordu; yeniden deneme sarmalayıcısı zaman aşımında mesajları yeniden gönderiyordu; inbox chats route'unu 30 saniyede bir yokluyordu. Önerilen yamalar: hesap ID'si sohbetten alınır, yeniden denemeler okumalarla sınırlanır, mesaj olayları için bir webhook endpoint'i. Uygulandı ve Development uygulamasında doğrulandı.
Belleğe göre değil, gerçek sözleşmeye göre bir denetim
Ajan kodunuzu gerçek istek ve yanıt şemalarıyla karşılaştırır: hesap alanları, idempotent çağrılar, webhook'ların yerini alacağı polling döngüleri. İnceleme, Development uygulamanızda test edilmiş bir diff olarak gelir.
Ajanın kullandığı endpoint'ler
Webhook'ları bir ajanla bağlayın
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Önce bir Development uygulaması
Gemini CLI'a, Production'dan ayrı tutulan bir Development uygulamasından Scope'a bağlı bir anahtar verin.
Test hesapları, gerçek istekler
Ajan, istekleri test hesapları üzerinde, onları bağlayan kimliği doğrulanmış kullanıcı adına ve her sağlayıcının sınırları içinde çalıştırır.
Her akışı doğrulayın
Bağlantı akışını, özellik başına bir okuma ve bir yazmayı ve bir webhook teslimatını kontrol edin.
Sonra Production'a geçin
Anahtarı değiştirene kadar kullanıcılarınızın hesaplarına hiçbir şey dokunmaz. Ayrıntılar: güvenlik ve uyumluluk.
Sorun giderme
Sık karşılaşılan hatalar ve anlamları
Bir kayıt doğru olmadığında gemini mcp list ve /mcp komutlarının gösterdikleri ve her birinin çözümü.
No MCP servers configured.
Kök anahtar mcpServers şu dosyanın en üst düzeyinde olmalı: ~/.gemini/settings.json veya .gemini/settings.json; sonda virgül olmadan.
Disconnected
Ya httpUrl ya da url ile birlikte "type": "http" kullanın; çünkü tek başına bir url SSE olarak okunur.
Disabled, klasör güvenilir değil
İlk açılışta güven istemini kabul edin ya da projede gemini trust komutunu çalıştırın.
Yanlış yere eklendi
Kullanıcı kapsamı için --scope user bayrağını gemini mcp add komutuna ekleyin; komut varsayılan olarak şu proje dosyasına yazar: .gemini/settings.json.
İsteklerde 401 Unauthorized
Connected durumu anahtarı kontrol etmez: headers içinde adı geçen değişkeni export edin ve Scope'a bağlı bir Account API anahtarı kullanın.
Zaman aşımı
Ağı, varsa proxy'yi ve URL'yi kontrol edin; ancak ondan sonra kayıtta timeout değerini ayarlayın.
6000+
Unipile ile inovasyon yapan şirketler
Sektör liderlerinin güvendiği çözüm
1 API
Tüm büyük iletişim kanallarında operasyonları sadeleştirin
2 gün
Minimum kurulumla hızla canlı entegrasyon
30%
Bakım eforu ve kaynaklarında azalma
Yerleşik güvenlik ve uyumluluk
Verileriniz ve iş akışlarınız için kurumsal düzeyde koruma Güvenliğimiz hakkında daha fazla bilgi
SOC 2 Type II
Sertifikalı
Veri korumasını ve operasyonel bütünlüğü güvence altına alan, bağımsız olarak denetlenmiş güvenlik kontrolleri.
GDPR
Uyumlu
Kullanıcı gizliliği için Avrupa veri koruma düzenlemelerine tam uyum.
99.9%
Son 24 ayda platform çalışma süresi
24/7
Yüksek performanslı API ile küresel destek
Gemini CLI MCP sunucusu SSS
Gerçekten sorulan sorular: httpUrl mi url mi, settings.json'ın yeri, JSON yerine tek komut, anahtarı dosya dışında tutmak, Disconnected, No MCP servers configured, VS Code eklentisi ve anahtarlar.
Dokümantasyon
httpUrl alanını streamable HTTP endpoint'i, url alanını ise SSE endpoint'i olarak tanımlar. gemini mcp add --transport http komutu url alanını şununla birlikte yazar: "type": "http"; iki biçim de güncel sürümlerde bağlanır. Dosyayı elle yazıyorsanız şunu kullanın: httpUrl; tipi olmayan çıplak bir url SSE olarak okunur, bu da Disconnected bir sunucunun en sık gösterilen nedenidir.User ayarları şurada:
~/.gemini/settings.json, project ayarları ise projenizin kökündeki .gemini/settings.json içinde; ikisi de mcpServers anahtarı altındadır ve project ayarları user ayarlarını geçersiz kılar. Komutun varsayılanına dikkat edin: gemini mcp add siz şunu vermedikçe project kapsamına yazar: --scope user.Evet, önerilen yol da budur:
gemini mcp add --transport http --scope user --header "X-API-KEY: your-scoped-api-key" unipile "https://developer.unipile.com/mcp?branch=v2.0". Bu --header bayrağı tekrarlanabilir ve komutun herhangi bir yerinde olabilir. gemini-cli 0.60.0 üzerinde doğrulandı.Header değerini şöyle yazın:
"$UNIPILE_API_KEY" veya "${UNIPILE_API_KEY}". Gemini CLI, headers dahil settings.json içindeki ortam değişkenlerini genişletir; böylece proje dosyası gizli bilgi olmadan commit edilebilir ve her geliştirici gemini'yi başlatmadan önce kendi Scope'a bağlı Account API anahtarını export eder.Sırasıyla: taşıma anahtarı (
httpUrl streamable HTTP için, ya da url ile birlikte "type": "http"), sizinkini geçersiz kılan bir project settings.json ya da tersi, klasör güveni (güvenilmeyen bir klasör tüm sunucuları devre dışı bırakır) ve son olarak action'lar çalışırken Disconnected görünen bir durum; bu, spesifikasyondaki isteğe bağlı bir ping'den kaynaklanır. Önce gemini mcp list, ardından /mcp komutunu oturum içinde çalıştırın.Gemini CLI, geçerli klasörden okuduğu yapılandırmada hiçbir
mcpServers kaydı bulamadı. Dosyanın şurada olduğunu kontrol edin: ~/.gemini/ ya da .gemini/ (proje kökünde); ayrıca mcpServers alanının JSON'ın en üst düzeyinde durduğunu ve JSON'ın geçerli olduğunu doğrulayın: sondaki tek bir virgül dosyanın yok sayılmasına yeter.Bu sayfa terminaldeki Gemini CLI'ı kapsar; burada anlatılan yapılandırma, CLI'ın okuduğu settings.json dosyasıdır. Eklentinin VS Code'da kendi MCP ayarları vardır; dosyanın paylaşıldığını varsaymadan önce eklentinin dokümantasyonuna bakın.
Ajan yalnızca API spesifikasyonunu okuduğunda sunucu anahtarsız yanıt verir. Gerçek istekler çalıştırmak için Development uygulamanızda bir Scope oluşturun, test hesaplarını atayın ve bu Scope'a bağlı bir Account API anahtarı üretin. Bir MCP istemcisine asla Service anahtarı veya global Account anahtarı vermeyin.