Yapay zeka asistanınızı MCP ile bağlayın

MCP sayfasını açın ve sunucuyu asistanınıza ekleyin

Her şey geliştirici belgelerimizdeki MCP sayfasında başlıyor. Sunucu adresi, her istemci için kısa bir kurulum yolu ve bağlantının neler yapabildiğine dair tam liste bu sayfada. Sunucu adresi sayfanın en üstünde yazılı ve asistanınıza vereceğiniz tek şey o. Kopyalanacak bir API anahtarı ya da bir yapılandırma dosyasına yapıştırılacak bir değer yok.

Hangi araçta çalışıyorsanız kurulum birkaç tıklamadan ibaret:

• Claude: Mailsoftly, Claude dizininde listeleniyor; kurulumun tamamı tek tık. Dizinde Mailsoftly girişini (ya da Claude entegrasyon sayfasını) açıp Connect’e basın. Claude tarayıcınızda Mailsoftly’yi açar; oturum açın ya da orada ücretsiz bir hesap oluşturun, uygulamanın istediği izinleri okuyun ve onaylayın. Claude’a döndüğünüzde bağlayıcı hazırdır. Sunucu adresiyle elle özel bağlayıcı eklemek de çalışır, ancak izlenecek yol dizin yoludur
• ChatGPT: bağlayıcıların ve uygulamaların yönetildiği ayarlar bölümünü açın, adresle ekleme seçeneğini seçin ve aynı sunucu adresini yapıştırın. ChatGPT de aynı oturum açma ve onay akışını izler
• Diğer istemciler: uzak sunucuları OAuth ile destekleyen her MCP istemcisi aynı şekilde çalışır. Sunucu adresini verin, gerisini o halleder

Bir de süreci kendi makinesinde çalıştırmayı tercih eden geliştiriciler için yerel sunucu seçeneği var. Node.js 20 ya da üstünü ve bir Mailsoftly API anahtarını gerektirir; Claude Masaüstü Bilgisayar, Cursor ya da VS Code’a kendi MCP yapılandırma dosyaları üzerinden bağlanır ve özenle seçilmiş araç seti yerine her canlı API uç noktası için ayrı bir araç sunar. Aynı sayfa bunu da baştan sona anlatıyor.

Kurulumun tamamı tek bir adresten ibaret. Bundan sonra göreceğiniz ekran bize ait.

MCP sayfasını açın

Asistanın gerçekte neler yapabileceğini görün

Onay vermeden önce okunmaya değer kısım burası. Barındırılan sunucu, API’nin her işlemini değil özenle seçilmiş 134 aracı yayınlar; böylece asistan birbirine benzeyen uç noktalar arasında tahmin yürütmek yerine doğru olanı seçer. Araçların çoğu yalnızca okur: kişiler, listeler ve listedekiler, etiketler, özel alanlar, segmentler, bastırma listesi, formlar ve yanıtları, kayıtlı şablonlar, otomasyonlar, açılış sayfaları, SMS kampanyaları, webhook uç noktaları, imzalar, ekip üyeleri, gönderen adresleri, sonuçlarıyla birlikte kampanyalar (bağlantı tıklamaları, kişi bazında etkileşim, bir taslağın ulaşacağı kitle), her kişinin hareket geçmişi, süren içe aktarmalar, dosyalar ve görseller, içerik blokları, marka kiti, alan adı sağlık kontrolleri, bağlı uygulamalar ve denetim kaydı, ayrıca planı, limitleri ve gönderim durumuyla hesabın kendisi.

Bir şeyi değiştiren araçlar beş gruba ayrılır; gerçek kişilere ulaşanlar gönderim ve otomasyon gruplarıdır:

• Kişiler, listeler, etiketler, şablonlar, formlar, açılış sayfaları ve webhook uç noktaları: oluşturma, düzenleme ve kaldırma. Silmeler işaretlidir; asistan önce size sorar. Kampanyalar ve sayfalar ise geri alınabilir çöp kutusuna gider
• Veri ve varlıklar: import_Kişiler bir CSV dosyasını listeye yükler, add_contact_note ve update_contact_subscriptions tek bir kişi üzerinde çalışır, upload_file ve upload_image kampanyalarınızın bağlantı vereceği varlıkları ekler, invite_team_member ve update_team_member_role ise kendi ayrı izninin arkasında ekibi yönetir
• Taslaklar: draft_campaign bir metin özetinden, kayıtlı bir şablondan ya da sizin getirdiğiniz HTML’den kampanyayı hesabınıza taslak olarak yazar; update_campaign aynı taslağı düzenler; create_automation bir otomasyonu taslak olarak kurar. Hiçbiri gönderim yapmaz
• Gönderim: send_campaign taslağı hemen, schedule_campaign ileri bir zamanda gönderir. Gerçek insanlara gerçek mail ulaşır ve geri alınamaz
• Otomasyonlar: update_automation_status bir otomasyonu açar ya da kapatır, enroll_contact_in_automation etkin bir otomasyonu bir kişi için başlatır. Etkinleştirme doğrulanmış bir hesap gerektirir

send_campaign, send_test_email, unsubscribe_contact ve tüm silme araçları asistana "geri alınamaz" olarak bildirilir; düzgün çalışan istemcilerin bunları çalıştırmadan önce size sormasını sağlayan işaret budur. Gönderen ve etkinleştiren her araç ayrı gönderim izninin, hesabın güven kademesinin ve planın arkasındadır: ücretsiz ve doğrulanmamış bir hesap az sayıda otomasyon, form ve sayfa tutabilir; asistana bu, bir hata yerine yükseltme ya da doğrulama yoluyla birlikte söylenir. Ödemelerinize dokunan, API anahtarı oluşturan ya da iptal eden, kişilerinizi dışa aktaran ya da hesap ayarlarını değiştiren bir araç hâlâ yok; bunlar hiç yayınlanmıyor.

Bu tabloyu bir kez okuduğunuzda, bağlı bir asistanın erişebileceği en geniş alanı öğrenmiş olursunuz.

Onay ekranında izinleri verin

Oturum açtıktan sonra Mailsoftly kendi onay ekranını gösterir. Başlıkta izin isteyen uygulamanın adı, alt satırda çalışmak istediği şirketin adı yazar. "Bu uygulama şunları yapabilecek:" başlığının altında ise istenen her izin için sade bir satır görürsünüz. Hiçbir izin kendiliğinden verilmez; uygulama yalnızca istediği ve sizin onayladığınız izinleri alır.

Sekiz izin şu şekilde görünür:

• Kişilerinizi, listelerinizi ve etiketlerinizi okuma
• Kişi, liste ve etiket oluşturma ve güncelleme
• Kampanyalarınızı ve raporlarını okuma
• Kampanya taslağı oluşturma ve düzenleme
• Kişilerinize kampanya gönderme veya planlama
• Engelli adres listenize adres ekleme
• Hesabınızı ve şirket profilinizi okuma
• Ekip arkadaşlarınızı davet etme ve rollerini değiştirme

Gönderim izni bilerek bu listede yer almaz. Bir uygulama gönderim izni istediğinde bu izin, "Bu uygulamanın kampanya göndermesine veya planlamasına izin ver" etiketiyle ayrı ve boş bir onay kutusu olarak gelir; altındaki açıklama da diğer her şeyin bu izin olmadan çalışmayı sürdürdüğünü söyler. Kutuyu kapalı bırakırsanız asistan yine araştırır, yazar ve hazırlar; gönder düğmesine siz basarsınız. Asistanın kişilerinize doğrudan mail ulaştırmasını gerçekten istiyorsanız işaretleyin. Kutu her seferinde, yeniden bağlanmalarda bile, boş başlar; yani eskiden verilmiş bir onay sessizce taşınmaz.

Bitirmek için Erişime izin ver, vazgeçmek için Vazgeç düğmesini kullanın. En altta geri gönderileceğiniz adres yazar; bir bakmakta fayda var, o adresin bağladığınız uygulamaya ait olması gerekir.

Onayladığınızda asistanınıza geri dönersiniz ve bağlantı çalışır durumdadır.

Bağlantıyı istediğiniz an kesin

Bağlantı tek yönlü bir kapı değil. Ayarlar bölümünü açın, Gelişmiş başlığını bulun ve Bağlı uygulamalar sayfasına girin. Şirketinize hâlâ erişimi olan her üçüncü taraf uygulama burada listelenir. Her satırda Yetkilendiren ve Son yetkilendirme bilgileri ile verilmiş izinler yer alır; izinler, onay ekranında okuduğunuz ifadelerin aynısıdır. Bağlı uygulamaları ve API anahtarlarını denetleyin rehberi bu ekranı sütun sütun, kendi sistemlerinizin taşıdığı API anahtarlarıyla birlikte okuyor.

Bir bağlantıyı kesmek için satırın sonundaki Erişimi kaldır düğmesini kullanın ve onaylayın. Erişim anında durur; sadece uygulamayı bağlayan kişi için değil, şirketteki herkes için. Bilmeye değer birkaç nokta:

• Bağlı uygulamalar sayfasını görmek de erişim kaldırmak da yalnızca yöneticilere açıktır, tıpkı onay ekranı gibi
• Erişim token’ları kısa ömürlüdür ve yenileme token’ları her kullanımda değişir, yani bir yerde sızan token kısa sürede işe yaramaz hâle gelir; ama erişimi anında kesen şey buradaki kaldırma işlemidir
• Bir uygulamanın oluşturduğu kişi hareketlerine o uygulamanın adı işlenir, yani sonradan bakıp hangi uygulamanın ne yaptığını görebilirsiniz

Asistan yerine doğrudan API üzerine bir şey geliştirmeyi tercih ediyorsanız Mailsoftly API’sini kullanın rehberiyle başlayın; hazır bağlantılar ve Zapier ise Entegrasyonları ve API’yi bağlayın rehberinde anlatılıyor.