TR
Claude Code · MCP Sunucusu

Claude Code MCP Sunucusu: uygulamanızda mesajlaşma ve e-posta

Tek bir claude mcp add komutu Unipile MCP sunucusunu bağlar. Ardından Claude Code 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.
Claude Code · 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…
Kullanım senaryosu

Claude Code'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 Claude Code API referansını okur, kodu sizin stack'inizde yazar ve her isteği test eder.
Unipile MCP sunucusunu Claude Code'a bağlayınUnipile MCP bağlı
Bağlamak istediğiniz kanalları seçindeveloper.unipile.com/mcp
Tüm kanalları bağla10 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
claude mcp add, üç kapsam

Unipile MCP sunucusunu ekleyin: Claude Code

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 kaydeder; seçtiğiniz kapsam nerede yükleneceğini belirler.
Başlamadan önce: Claude Code kurulu ve oturum açılmış 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.
U
User kapsamı--scope user · tüm projeler, yalnızca size özel
P
Project kapsamı.mcp.json depo kökünde, paylaşılır
L
Local kapsamı (varsayılan)yalnızca bu proje, özel, ~/.claude.json içinde
?
Hangi kapsam?Tüm projeler için user, .mcp.json'u ekiple paylaşmak için project, tek seferlik bir deneme için local.
terminal
# User kapsamı: bu makinedeki tüm projeler, yalnızca size özel claude mcp add --transport http --scope user \ unipile "https://developer.unipile.com/mcp?branch=v2.0" \ --header "X-API-KEY: your-scoped-api-key" # Claude Code "Added …" yazdırır, ardından: claude mcp list
// Project kapsamı: depo köküne commit edilir, ekiple paylaşılır { "mcpServers": { "unipile": { "type": "http", "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "${UNIPILE_API_KEY}" } } } } // "type": "http" zorunludur; her geliştirici UNIPILE_API_KEY değişkenini export eder
# Local kapsamı (varsayılan): yalnızca bu proje, özel, ~/.claude.json içinde saklanır claude mcp add --transport http \ unipile "https://developer.unipile.com/mcp?branch=v2.0" \ --header "X-API-KEY: your-scoped-api-key"
Claude Code 2.1 ile doğrulandı. URL'yi tırnak içine alın (zsh, ? karakterini bir desen olarak yorumlar) ve --header'ı en sonda tutun.

Bağlantıyı doğrulayın

  1. 1Terminalde claude mcp list ✔ Connected gösterir, claude mcp get unipile ise ayrıntıları gösterir.
  2. 2Bir oturumda /mcp durumu gösterir ve project kapsamlı bir .mcp.json dosyasını ilk seferde onaylar.
  3. 3Bir sohbette şunu sorun: Unipile MCP'yi kullanarak LinkedIn kişi araması endpoint'lerini ve zorunlu parametrelerini listele ve 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 Claude Code'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.
Claude Code · support-consoleDevelopment uygulaması
Destek konsolumuza WhatsApp mesajlaşması ekle: her temsilcinin konuşmalarını senkronize et ve ticket üzerinden yanıt vermelerini sağla.
Endpoint ara"chats messages send"3 eşleşme
İsteği çalıştırGET /v2/{account_id}/chats9 sohbet
Oluşturulanlar: whatsapp/chat-sync.ts (sohbetler ve mesajlar ticket'a upsert edilir, cursor ile sayfalama) ve POST /tickets/:id/reply route'u; bu route gönderimi sohbetin kendi hesabı üzerinden yapar. Senkronizasyon Development uygulamasında çalıştırıldı: 9 sohbet, 41 mesaj.3 dosya değişti · Development uygulamasında test edildi

Tek prompt'la ürününüzün içinde bir WhatsApp inbox'ı

Claude Code 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. LinkedIn, Instagram, Facebook ve Telegram aynı chat route'larını kullanı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
WhatsApp API'si
Claude Code · crm-appDevelopment uygulaması
Kullanıcıların kişi sayfasından kendi Gmail veya Outlook posta kutuları üzerinden e-posta göndermesini sağla ve yanıtları kişiye thread olarak bağla.
Endpoint'i okuPOST /v2/{account_id}/emails/sendşema yüklendi
İsteği çalıştırGET /v2/{account_id}/emails200 OK
Eklendi: POST /contacts/:id/email route'u, gönderim route'unu kullanıcının posta kutusu hesabı üzerinden çağırır. Ayrıca thread ID'sini kullanan thread içinde yanıt seçeneği ve yanıtları kişiye bağlayan gelen senkronizasyonu eklendi. Development uygulamasının posta kutusundan bir test e-postası gönderildi ve yanıt thread içinde görüldü.4 dosya değişti · gönderim ve thread uçtan uca test edildi

Kullanıcının kendi posta kutusundan e-posta, CRM'inizde thread olarak

Gmail, Outlook ve IMAP tek bir e-posta şemasını paylaşır. Ajan gönderme işlemini kullanıcının bağladığı posta kutusuna bağlar ve thread ID'yi korur; böylece yanıtlar doğru kişiye düşer.
Ajanın kullandığı endpoint'ler
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
E-posta API'si
Claude Code · saas-backendDevelopment uygulaması
SaaS'ımdaki her workspace'te kendi LinkedIn ve e-posta hesapları olan birkaç kullanıcı var. Onları izole et: workspace başına bir Scope ve Scope'a bağlı bir anahtar.
Endpoint ara"scopes api-keys"4 eşleşme
İsteği çalıştırPOST /v2/scopes/201 · scope
Artık workspace oluşturulurken backend bir Scope ve workspace üzerinde şifreli saklanan, Scope'a bağlı bir Account API anahtarı oluşturuyor; bir üyenin bağladığı her hesap da bu Scope'a atanıyor. Tüm hesap çağrıları workspace anahtarını kullanıyor. Development uygulamasında iki workspace ile test edildi.5 dosya değişti · izolasyon doğrulandı

Çok kullanıcı, çok hesap, tenant başına bir sınır

Scope'a bağlı bir anahtar yalnızca kendi Scope'una atanmış hesapları görür. Ajan bu sınırı tenant modelinize dönüştürür; böylece çoklu hesap mantığı kodunuzda değil, API'de yaşar.
Ajanın kullandığı endpoint'ler
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Hesaplar, Scope'lar ve anahtarlar
Önce bir Development uygulaması Claude Code'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 claude mcp list ve /mcp komutlarının gösterdiği durumlar ve her birinin çözümü.
✘ Failed to connect
Tam olarak https://developer.unipile.com/mcp?branch=v2.0 adresini --transport http ile kullanın, ardından claude mcp get unipile ile kontrol edin.
⏸ Pending approval
Önce claude komutunu klasörde çalıştırın, workspace güven iletişim kutusunu kabul edin, ardından sunucuyu şuradan onaylayın: /mcp.
İsteklerde 401
Development uygulamanızdan Scope'a bağlı bir Account API anahtarını tam olarak şu header adıyla gönderin: X-API-KEY.
Eksik değişken uyarısı
Ortam değişkeni UNIPILE_API_KEY değerini Claude Code'u başlatan kabukta export edin ya da şununla bir varsayılan belirleyin: ${UNIPILE_API_KEY:-}.
headers.X-API-KEY içinde gizli boşluk
Sunucuyu, anahtarın başındaki ve sonundaki boşlukları temizleyerek yeniden ekleyin: Claude Code değerleri tam yazıldığı gibi kullanır.
Aynı ad birden fazla kapsamda
Tek bir tanım bırakın, örneğin claude mcp remove unipile --scope user ile: local, project'ten önce gelir; en son user.
MCP endpoint not found at <origin>
Tam URL'yi kullanın: https://developer.unipile.com/mcp?branch=v2.0. curl -I ile kontrol edin, ardından claude mcp get unipile komutunu çalıştırın.
/mcp, "No MCP servers configured" gösteriyor
Şunu kullanın: ~/.claude.json veya .mcp.json (proje kökünde); asla ~/.claude/mcp.json değil. Ardından oturumu yeniden başlatın.
Shell URL'yi reddediyor ya da branch eksik
URL'yi her zaman claude mcp add içinde tırnak içine alın; aksi halde zsh "no matches found" yanıtını verir ve bash parametreyi düşürebilir.
Yavaş başlangıç veya zaman aşımı
Oturumun süre sınırını şununla artırın: MCP_TIMEOUT=60000 claude.
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

Claude Code MCP sunucusu SSS

Gerçekten sorulan sorular: kapsamlar, yapılandırmanın yeri, anahtarı depodan uzak tutmak, özel header'lar, Failed to connect, URL'yi tırnaklamak, .mcp.json değişiklikleri ve API anahtarları.
Varsayılan local'dir: ~/.claude.json içinde geçerli projenin altında saklanır, özeldir ve o projeyle sınırlıdır. Project, .mcp.json dosyasını depo köküne yazar ve sürüm kontrolüyle paylaşılır. User, ~/.claude.json içinde kökteki mcpServers anahtarının altına yazar ve tüm projelerinize uygulanır. Öncelik sırası local, sonra project, sonra user'dır. Unipile için: --scope user kişisel geliştirme anahtarınız için, --scope project ise tüm ekip aynı entegrasyon üzerinde çalışırken.
Local ve user kapsamları için ~/.claude.json (Windows'ta %USERPROFILE%\.claude.json) içinde, project kapsamı için ise proje kökündeki .mcp.json içinde. Claude Code şunları okumaz: ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json veya %APPDATA%\Claude\mcp.json. claude mcp get unipile bir kaydın hangi kapsamda olduğunu söyler.
Claude Code şu değişken biçimlerini genişletir: ${VAR} ve ${VAR:-default} → command, args, env, url ve headers. Şu satırı ekleyin: "X-API-KEY": "${UNIPILE_API_KEY}" → .mcp.json, dosyayı commit edin; her geliştirici kendi Scope'a bağlı anahtarını kendi ortamından sağlar. Değişken tanımsızsa ve varsayılanı yoksa yapılandırma yine yüklenir ve claude mcp list bir uyarı gösterir.
Evet: --header "X-API-KEY: your-scoped-api-key", birden fazla header için tekrarlanabilir, kısa biçimi -H. URL'den sonra koyun, çünkü bayrak birden fazla değer alır. Unipile sunucusu uzak bir HTTP sunucusudur: yerelde kurulacak bir şey yok, npx yok, yönetilecek Node yok.
Önce claude mcp get unipile ile ayrıntıya bakın (HTTP durumu ve hata metni), yapıştırılan bir anahtardan sonra claude mcp list komutunun gösterdiği baştaki veya sondaki boşluk uyarılarını kontrol edin ve URL'nin makinenizden yanıt verdiğini şununla doğrulayın: curl -I. 404 durumunda şu çıktı görünür: MCP endpoint not found at <origin>: yol yanlıştır; tam URL şudur: https://developer.unipile.com/mcp?branch=v2.0, branch parametresi dahil.
URL şu karakteri içerir: ?, zsh bunu desen karakteri olarak okur. Şu komutta URL'yi her zaman tırnak içine alın: claude mcp add. Tırnak olmadan zsh "no matches found" yanıtını verir, bash ise branch parametresini düşürebilir; bu da sizi sunucunun yanlış sürümüne bağlar.
Claude Code, .mcp.json dosyasını oturum başlangıcında okur: çıkıp yeniden başlatın. Hatalı bir kayıt sessizce yok sayılır ve claude mcp list ayrıştırma uyarısını hatalı alanla birlikte gösterir. Sunucuyu project onay isteminde reddettiyseniz şunu çalıştırın: claude mcp reset-project-choices.
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, yalnızca ilgili hesapları atayın ve bu Scope'a bağlı bir Account API anahtarı üretin. Bir MCP istemcisine asla Service anahtarı veya global Account anahtarı vermeyin.