Başla
TR
Cursor · MCP Sunucusu

Cursor MCP Sunucusu: IDE'nizde mesajlaşma ve e-posta

Tek bir URL ve tek bir header yeterli: Unipile MCP sunucusu Cursor'a eklenir. Ardından ajanınız projenize LinkedIn, WhatsApp ve e-posta özellikleri ekler.
Unipile'ı Cursor'a ekleyin mcp.json yapılandırmasını kopyalayın
7 gün ücretsiz deneme, kredi kartı gerekmez.
Cursor · crm-app
Unipile MCP bağlı
Sarah
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.
3 dosya değişti · Development uygulamasında test edildi
Sonraki özelliği anlatın…
Görev

Ne yapmak istiyorsunuz

Ürününüze bir LinkedIn, WhatsApp, e-posta veya takvim bağlantısı ekleyin. Bu; bir API referansını okumak, doğru endpoint'leri seçmek, Hosted Auth'u ve callback'lerini bağlamak, ardından aramadan mesaja kadar doğru ID'leri korumak demektir. Unipile MCP sunucusu Cursor'a bağlıyken bu okumayı ajan sizin yerinize yapar ve kodu sizin stack'inizde yazar.
Unipile MCP sunucusunu Cursor'a bağlayınUnipile MCP bağlı
Bağlamak istediğiniz kanalları seçindeveloper.unipile.com/mcp
Tüm kanalları bağla9 kanal
LinkedInLinkedIn/v2/{account_id}/chats
WhatsAppWhatsApp/v2/{account_id}/chats
InstagramInstagram/v2/{account_id}/chats
TelegramTelegram/v2/{account_id}/chats
GmailGmail/v2/{account_id}/emails
OutlookOutlook/v2/{account_id}/emails
IMAPIMAP/v2/{account_id}/emails
Google CalendarGoogle Calendar/v2/{account_id}/calendars
Outlook CalendarOutlook Calendar/v2/{account_id}/calendars
↑↓gezin boşlukseç ↵bağlatek URL, tek header
Unipile olmadan Sekmeler, tahminler, glue code
Cursor endpoint adlarını ve payload'ları eğitim verisinden tahmin eder ve ID'leri yanlış kullanır.
Referanstaki şemaları sohbete her seferinde bir endpoint olmak üzere elle yapıştırırsınız.
İlk gerçek çağrı, code review'dan sonra production'da yapılır.
Unipile MCP sunucusu ile Uygulamanızdaki sonuç
Bir bağlantı route'u ve bir Ayarlar butonu: her kullanıcı kendi hesabını Hosted Auth ile bağlar.
Bir webhook alıcısı ve mesajlarla e-postaları geldikleri anda gösteren bir inbox.
Siz diff'i incelemeden önce her istek Development uygulamanızda bir kez çalıştırılmış olur.
mcp.json, global veya proje

Unipile MCP sunucusunu ekleyin: Cursor

Sunucu uzaktadır: streamable HTTP üzerinden tek bir URL ve tek bir header. npx yok, yerel süreç yok, yönetilecek Node sürümü yok. Kaydın nerede duracağını seçin, resmi dokümantasyondaki bloğu yapıştırın ve kaydedin; Cursor sunucuyu yükler.
Cursor güncel; MCP, Customize (kenar çubuğu) ya da Cursor CLI üzerinden kullanılabilir.
Bir Development uygulaması: Unipile dashboard'unuzda, bir Scope ve Scope'a bağlı bir Account API anahtarıyla.
Hosted Auth ile bu Scope'a bağlanmış en az bir test hesabı; böylece ajan gerçek istekler çalıştırabilir.
G
Global yapılandırma~/.cursor/mcp.json
P
Proje yapılandırması.cursor/mcp.json (depo kökü)
E
Anahtar bir ortam değişkeninden${env:UNIPILE_API_KEY}
?
Global mi, proje mi?Tek makineden birkaç Unipile entegrasyonu geliştiriyorsanız global. Her deponun kendi Scope'a bağlı anahtarına ihtiyacı varsa proje; Development ve Production farklı depolarda duruyorsa doğru seçim budur. Cursor önce projeyi, sonra global yapılandırmayı okur.
~/.cursor/mcp.json
{ "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 ve Customize içinde listeler. Cursor, url ve headers içindeki ${env:NAME} ifadesini çözümler; böylece anahtarın dosyada durması gerekmez.
İsteğe bağlı: tek tıkla kurulum Scope'a bağlı Account API anahtarınızı yapıştırın, Cursor'ı sunucu önceden doldurulmuş şekilde açan bir kurulum bağlantısı alın. Her şey tarayıcınızda çalışır; anahtar asla unipile.com'a gönderilmez. Boş bırakırsanız bağlantı sunucuyu, Cursor'da değiştireceğiniz bir yer tutucuyla kurar.
Unipile'ı Cursor'a ekleyin
Doğrulama

Bağlantıyı doğrulayın

Üç kontrol: editörde, CLI'da, ardından bir sohbette. Hiçbiri bağlı bir hesaba dokunmaz.
1Customize içindeKenar çubuğunda Customize'ı açın: unipile sunucusu listelenir, etkindir ve durumunu gösterir. Açma/kapama düğmesi, kaydı kaldırmadan sunucuyu devre dışı bırakır.
2Cursor CLI'daCLI, editörün yapılandırmasını paylaşır: önce proje, sonra global.agent mcp list # ya da etkileşimli bir oturumda /mcp list
3Bir sohbette, hesaba dokunmadanYalnızca API spesifikasyonunu okuyan bir soru sorun. Ajan gerçek route'lar ve parametrelerle yanıt veriyorsa sunucu bağlanmıştır.Unipile MCP'yi kullanarak LinkedIn kişi araması endpoint'lerini ve zorunlu parametrelerini listele.
Glue code değil, prompt'lar

Ajanınıza prompt'u verin

Üç entegrasyon görevi; her birinde Cursor'a yapıştırılacak birebir prompt, ajanın okuyup çalıştırdığı Unipile endpoint'leri ve projenize eklenenler yer alır. Yollar eksiksizdir; API taban URL'si: https://api.unipile.com, Scope'a bağlı anahtarınız ise X-API-KEY header'ında.
Cursor · ats-appDevelopment uygulaması
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.3 dosya değişti · Development uygulamasında test edildi

Prompt'u yapıştırın, diff'i inceleyin

Cursor sohbet ve mesaj sözleşmelerini sunucu üzerinden okur, senkronizasyon işini ve yanıt endpoint'ini sizin stack'inizde yazar ve ilk istekleri Development uygulamanızda çalıştırır. WhatsApp, Instagram ve Telegram aynı chat route'larını kullanır; bu yüzden ikinci kanalın prompt'u birincisinden kısadır.
Ajanın kullandığı endpoint'ler
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Sık yapılan hata: ID'leri karıştırmak. Mesaj her zaman sohbetin sahibi olan hesaptan gönderilir; liste çağrısından gönderim çağrısına kadar account_id ve chat_id değerlerini birlikte taşıyın.
LinkedIn entegrasyonu geliştirin
Cursor · crm-appDevelopment uygulaması
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ı.4 dosya değişti · bağlantı akışı uçtan uca test edildi

Kullanıcılarınız kendi hesaplarını bağlar, uygulamanız bir hesap ID'si alır

Hosted Auth, Unipile'ın kullanıcılarınıza sunduğu sayfadır; LinkedIn, WhatsApp, Gmail, Outlook ya da bir takvimi kendileri bağlarlar. Ajan; backend'inizde link oluşturmayı, frontend'inizde yönlendirmeyi ve sonraki her isteğin ihtiyaç duyduğu hesap ID'sinin saklanmasını bağlar.
Ajanın kullandığı endpoint'ler
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Sık yapılan hata: Auth link'i tarayıcıdan oluşturmak. Link sizin anahtarınızla sunucunuzda oluşturulur; frontend yalnızca hosted URL'yi alır.
Hosted Auth'u bir ajanla uygulayın
Cursor · support-consoleDevelopment uygulaması
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.6 dosya değişti · 3 kanal tek listede

Polling olmadan gerçek zamanlı; mesajlaşma ve e-posta için tek liste

Sohbetler ve e-postalar, her birinin kendi şeması olan iki route ailesinden gelir. Ajan iki sözleşmeyi de okur, ortak modeli tasarlar, senkronizasyonu ve webhook alıcısını yazar, ardından teslimat günlüğünü webhook konuşmaları route'u üzerinden kontrol eder.
Ajanın kullandığı endpoint'ler
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Sık yapılan hata: İşi webhook handler'ının içinde yapmak. Hemen bir 2xx ile onaylayın ve olayı asenkron işleyin; aksi hâlde teslimatlar zaman aşımına uğrar ve yeniden denenir.
Ajanla birleşik inbox oluşturun
Development'tan Production'a

Önce bir Development uygulamasında test edin

Unipile dashboard'u bir Development uygulaması ile bir Production uygulamasını birbirinden ayırır. Cursor'a Development uygulamasından Scope'a bağlı bir anahtar ve Hosted Auth ile bağlanmış bir veya iki test hesabı verin. Ajan bu hesaplarda, onları bağlayan kimliği doğrulanmış kullanıcı adına ve her sağlayıcının sınırları içinde gerçek istekler çalıştırır; siz yayına alana kadar kullanıcılarınızın hesaplarına hiçbir şey dokunmaz.
Bağlantı akışını uçtan uca doğrulayın: auth link sunucu tarafında oluşturulur, hesap ID'si kullanıcı üzerinde saklanır.
Özellik başına bir okuma ve bir yazma doğrulayın: sohbetleri listeleyin, test hesabından bir mesaj gönderin.
Anahtarı Production'a geçirmeden önce bir webhook teslimatını ve bir yeniden bağlanma ya da checkpoint durumunu doğrulayın.
crm-app · DevelopmentCursor kullanıyor
Scopedev-tests · 2 hesap
AnahtarScope'a bağlı Account API anahtarı
HesaplarLinkedIn test hesabı, Gmail test posta kutusu
Webhook'lar1 endpoint · mesaj olayları
crm-app · ProductionDokunulmadı
Scopeworkspace başına bir tane
AnahtarScope'a bağlı anahtarlar, yalnızca backend'inizde
Hesaplarkullanıcılarınızın kendi hesapları, Hosted Auth ile
Sorun giderme

Sık karşılaşılan hatalar ve anlamları

Bir MCP kaydı doğru olmadığında Cursor'ın gösterdiği mesajlar ve her birinin çözümü. Çoğu dosyaya, JSON'a ya da anahtara dayanır.
No tools or prompts
Cursor kaydı yükledi ama sunucudan hiçbir şey dönmedi. ÇözümDüzenlediğiniz dosyayı kontrol edin (global ~/.cursor/mcp.json veya proje .cursor/mcp.json depo kökünde), JSON'ı doğrulayın (genellikle suçlu sondaki bir virgüldür), ardından sunucuyu Customize'dan yeniden yükleyin ya da Cursor'ı yeniden başlatın.
No server info found
Kayıt orada ama Cursor sunucuyu tanımlayamıyor. ÇözümSunucu kaydındaki url değeri tam olarak şu olmalı: https://developer.unipile.com/mcp?branch=v2.0; kayıt, şu alanları içeren uzak bir kayıt olmalı: url ve headers, şunu değil: command. Başka bir sunucudan kalan type: "stdio" satırlarını kaldırın.
Connection failed
URL yanıt veriyor ama bir MCP sunucusu olarak değil. ÇözümHost adında ya da şu kısımda bir yazım hatası: ?branch=v2.0, ya da isteği engelleyen bir kurumsal proxy. URL'yi bir tarayıcıda açın: 404 değil, bir yanıt dönmeli.
İsteklerde 401 Unauthorized
Sunucu bağlı ama bir isteği çalıştırmak başarısız oluyor. ÇözümAnahtar şu alanda yok: headers, header adı şu değil: X-API-KEY, ya da Development uygulamanızdan Scope'a bağlı bir Account API anahtarı yerine bir Service veya global Account anahtarı kullandınız.
Proje yapılandırması yok sayılıyor
Cursor global kaydı kullanmaya devam ediyor ya da hiçbirini kullanmıyor. Çözüm.cursor/mcp.json Cursor'da açtığınız klasörün kökünde durmalı, bir alt klasörde değil. Cursor önce projeyi, sonra global yapılandırmayı, sonra üst dizinleri okur.
Günlükler nerede okunur
Yukarıdaki her durum bir iz bırakır. ÇözümOutput 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: başlatma, istekler ve hatalar orada listelenir.
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
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
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.