Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
Cursor · MCP Sunucusu
Cursor MCP Sunucusu: IDE'nizde mesajlaşma ve e-posta
Tek bir URL ve tek bir header, Unipile MCP sunucusunu Cursor'a ekler. Ardından ajanınız projenize LinkedIn, WhatsApp ve e-posta ö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.
Cursor · crm-app
Unipile MCP bağlı
CRM'ime LinkedIn hesap bağlantısı ekle.
Endpoint'i okuPOST /v2/auth/linkşema yüklendi
Bağlantı route'u ve Ayarlar butonu eklendi. Hesap ID'si kullanıcı üzerinde saklanıyor.
Sonraki özelliği anlatın…
Kullanım senaryosu
Cursor'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 Cursor API referansını okur, kodu sizin stack'inizde yazar ve her isteği test eder.
Unipile MCP sunucusunu Cursor'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
mcp.json, global veya proje
Unipile MCP sunucusunu ekleyin: Cursor
Sunucu uzaktadır: streamable HTTP üzerinden tek bir URL ve tek bir header, yerelde çalıştırılacak hiçbir şey yok. Global veya project'i seçin, bloğu yapıştırın, kaydedin; Cursor onu yükler.
Başlamadan önce: Cursor güncel olmalı; 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.
Global yapılandırma~/.cursor/mcp.json
Proje yapılandırması.cursor/mcp.json (depo kökü)
Anahtar bir ortam değişkeninden${env:UNIPILE_API_KEY}
?
Global mi, proje mi?Her depo kendi Scope'a bağlı anahtarına ihtiyaç duyuyorsa project. Cursor önce project'i, sonra global'i okur.
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "your-scoped-api-key"
}
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "your-scoped-api-key"
}
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "${env:UNIPILE_API_KEY}"
}
}
}
}
Dosyayı kaydedin, Cursor sunucuyu yükler. ${env:NAME} url ve headers içinde çalışır; böylece anahtar hiçbir zaman dosyada durmaz.
Bağlantıyı doğrulayın
- 1Kenar çubuğunda Customize'ı açın: unipile sunucusu listelenmiş ve etkin olmalı.
- 2Cursor CLI'da
agent mcp listkomutunu çalıştırın ya da bir oturumda/mcp listkomutunu kullanın. - 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.
İsteğe bağlı: tek tıkla kurulum
Sunucunun önceden doldurulmuş olarak Cursor'da açılacağı bir bağlantı almak için Scope'a bağlı Account API anahtarınızı yapıştırın. Anahtar tarayıcınızdan hiç çıkmaz.
Unipile'ı Cursor'a ekleyin
Glue code değil, prompt'lar
Ajanınıza prompt'u verin
Üç entegrasyon görevi; her biri için Cursor'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.ATS'ime LinkedIn mesajlaşması ekle: her işe alım uzmanının inbox'ını senkronize et ve aday sayfasından yanıt vermelerini sağla.
Endpoint ara"chats messages send"3 eşleşme
İsteği çalıştırGET /v2/{account_id}/chats12 sohbet
Oluşturulanlar:
linkedin/inbox-sync.ts (sohbetler ve mesajlar adaya upsert edilir, cursor ile sayfalama) ve POST /candidates/:id/reply; bu route gönderim route'unu sohbetin kendi hesap ID'siyle çağırır. Senkronizasyon Development uygulamasında çalıştırıldı: 12 sohbet, 87 mesaj.Prompt'u yapıştırın, diff'i inceleyin
Cursor sohbet ve mesaj sözleşmelerini okur, senkronizasyon işini ve yanıt endpoint'ini yazar, ilk istekleri Development uygulamanızda çalıştırır. WhatsApp, Instagram, Facebook ve Telegram aynı chat route'larını kullanır.
Ajanın kullandığı endpoint'ler
LinkedIn entegrasyonu geliştirin
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Bu React ve Fastify uygulamasına Unipile Hosted Auth'u uygula; kullanıcılar kendi LinkedIn hesaplarını Ayarlar'dan bağlasın.
Endpoint'i okuPOST /v2/auth/linkşema yüklendi
İsteği çalıştırPOST /v2/auth/link201 · link
Eklendi:
POST /api/accounts/connect (Fastify içinde): auth link'i sunucu tarafında oluşturur ve hosted URL'yi döndürür. React Ayarlar sayfası bu URL'yi açar ve dönüşte yeni account_id değerini workspace üzerinde saklar. Development uygulamasında bir LinkedIn test hesabıyla doğrulandı.Kullanıcılarınız kendi hesaplarını bağlar, uygulamanız bir hesap ID'si alır
Hosted Auth, kullanıcılarınızın kendi hesaplarını bağlaması için Unipile'ın sunduğu sayfadır. Ajan bağlantıyı backend'inize, yönlendirmeyi frontend'inize yerleştirir ve hesap kimliğinin saklanmasını kurar.
Ajanın kullandığı endpoint'ler
Hosted Auth'u bir ajanla uygulayın
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Yeni mesaj webhook'larına abone ol ve birleşik bir LinkedIn, WhatsApp ve e-posta inbox'ı oluştur: kanalı rozet olarak gösteren tek bir thread listesi.
Endpoint'i okuPOST /v2/webhooks/endpoints/şema yüklendi
İsteği çalıştırGET /v2/{account_id}/emails200 OK
Development uygulamasında mesaj olayları için bir webhook endpoint'i kaydedildi. Eklenenler:
POST /webhooks/unipile (hemen 200 döndürür ve olayı kuyruğa alır), sohbetleri ve e-posta thread'lerini tek yapıya eşleyen bir Thread modeli ve kanal rozetli thread listesi. Test mesajı gönderildi: liste bir saniyenin altında güncellendi.Polling olmadan gerçek zamanlı; mesajlaşma ve e-posta için tek liste
Ajan sohbet ve e-posta sözleşmelerini okur, tek bir thread modeli tasarlar, senkronizasyonu ve webhook alıcısını yazar. Ardından teslimat kaydını webhook conversations route'u üzerinden kontrol eder.
Ajanın kullandığı endpoint'ler
Ajanla birleşik inbox oluşturun
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Önce bir Development uygulaması
Cursor'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 MCP kaydı doğru olmadığında Cursor'un gösterdiği mesajlar ve her birinin çözümü.
No tools or prompts
Düzenlediğiniz dosyayı kontrol edin (~/.cursor/mcp.json veya .cursor/mcp.json), sondaki virgülleri kaldırın, ardından sunucuyu Customize'dan yeniden yükleyin.
No server info found
Uzak bir kayıt kullanın: url değeri tam olarak https://developer.unipile.com/mcp?branch=v2.0 olmalı ve headers bulunmalı; command veya type: "stdio" olmamalı.
Connection failed
Host'u ve ?branch=v2.0 kısmını yazım hatasına karşı kontrol edin, kurumsal bir proxy olup olmadığına da bakın: URL tarayıcıda 404 değil, gerçek bir yanıt döndürmelidir.
İsteklerde 401 Unauthorized
Development uygulamanızdan Scope'a bağlı bir Account API anahtarını headers içinde, tam olarak X-API-KEY adıyla gönderin.
Proje yapılandırması yok sayılıyor
Yapılandırma dosyası .cursor/mcp.json Cursor'da açtığınız klasörün kökünde olmalı, bir alt klasörde değil.
Günlükler nerede okunur
Output panelini açın (macOS'ta Cmd+Shift+U, Windows ve Linux'ta Ctrl+Shift+U) ve açılır menüden MCP Logs'u seçin.
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
Cursor MCP sunucusu SSS
Gerçekten sorulan sorular: mcp.json'ın yeri, global veya proje, uzak sunucular ve header'lar, hiçbir şey görünmediğinde neye bakılacağı, anahtarlar, tek tıkla kurulum ve CLI.
İki yerde.
~/.cursor/mcp.json ana klasörünüzdedir ve her projede kullanılabilen global yapılandırmadır. .cursor/mcp.json Cursor'da açtığınız klasörün kökündedir ve proje yapılandırmasıdır. Cursor önce proje dosyasını, sonra global dosyayı, sonra üst dizinleri okur. İkisi de aynı mcpServers bloğunu alır.Tek makineden ve tek bir Development uygulamasından birkaç Unipile entegrasyonu geliştiriyorsanız global olarak. Her deponun kendi Scope'a bağlı anahtarına ihtiyacı varsa proje bazında; Development ve Production entegrasyonları farklı depolarda duruyorsa doğru seçim budur. Her iki durumda da anahtar, Scope'a bağlı bir Account API anahtarıdır; asla Service veya global anahtar değildir.
Evet. Uzak bir kayıt,
mcp.json içinde bir url alanı ve bir headers nesnesi alır; Cursor ikisinin içinde de ${env:NAME} ifadesini çözümler. Unipile sunucusu tam olarak budur: streamable HTTP adresi https://developer.unipile.com/mcp?branch=v2.0 ve X-API-KEY header'ı. npx yok, yerel süreç yok, yönetilecek Node sürümü yok.Şu sırayla: düzenlediğiniz dosya (global ya da depo kökünde proje), JSON'ın geçerliliği, sunucunun Customize'dan yeniden yüklenmesi ya da Cursor'ın yeniden başlatılması, ardından Output panelindeki MCP Logs (Cmd+Shift+U, MCP Logs'u seçin). Sunucu bağlanıyor ama istekler 401 ile başarısız oluyorsa anahtar header'da yoktur ya da Scope'a bağlı bir Account API anahtarı değildir.
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.
Evet. Bu sayfadaki kurulum bağlantısı sunucu yapılandırmasını kodlar; Cursor'ı unipile kaydı önceden doldurulmuş şekilde açar, siz de yer tutucuyu Scope'a bağlı anahtarınızla değiştirirsiniz. Yukarıdaki isteğe bağlı oluşturucu, aynı bağlantıyı anahtarınızı içerecek şekilde tamamen tarayıcınızda üretir.
Evet. CLI, editörün yapılandırmasını paylaşır: önce proje, sonra global.
agent mcp list yapılandırılmış sunucuları ve durumlarını gösterir, /mcp list ise etkileşimli bir oturumda aynısını yapar. Ajan, bir istek gerektirdiğinde Unipile sunucusunu kullanır.