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

Yapay zeka asistanınızı Mailsoftly'nin MCP sunucusuna bağlayın, yalnızca istediğiniz izinleri verin ve bağlantıyı dilediğiniz an kesin.

Mailsoftly kendi MCP sunucusunu barındırıyor. Yani kişilerinizi, listelerinizi ve kampanyalarınızı ekran ekran gezmek yerine bir yapay zeka asistanına gündelik dille anlatarak yönetebilirsiniz. "Northwind’de çalışan herkesi bul ve Müşteriler listesine ekle" cümlesi, on dakikalık tıklamanın yerini alır.

Asistanınıza tek bir adres verirsiniz, Mailsoftly’de oturum açarsınız ve yalnızca uygun gördüğünüz izinleri işaretlersiniz. Hiçbir izin kendiliğinden verilmez, gönderim izni ayrı bir onay kutusudur ve bağlantıyı istediğiniz an kesebilirsiniz. Bu rehber, temkinli birinin onay vermeden önce görmek isteyeceği ayrıntılar dahil, sürecin tamamını anlatır.

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 Desktop, 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.

Not

MCP sayfası uygulamanın içinde değil, geliştirici belgeleri sitemizde duruyor ve bugün tamamen İngilizce yayınlanıyor. Sayfadaki başlıklar da (Hosted server, Permissions, Tools) İngilizce görünür. Ayarlar menüsünde aramayın; yukarıdaki bağlantıdan ya da API Documentation sayfasından açın.

Mailsoftly MCP sunucusu belgeleri sayfasında sunucu adresi ve iki bağlanma yöntemi

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ş 141 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ı, 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_contacts 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, update_automation_step bir otomasyondaki tek bir e-postayı ya da bekleme süresini, update_automation ise otomasyonun adını, tetikleyicisini ya da giriş filtresini değiştirir. Etkin bir otomasyonda bu iki düzenleme kişilerin alacağı e-postaları etkilediği için gönderim izni de ister. Etkinleştirme doğrulanmış bir hesap gerektirir

Gönderim yapan, abonelik durumunu değiştiren ya da bir şeyi silen her araç ve kayıtlı bir çalışmanın (kampanya, şablon, otomasyon, form ya da sayfa) üzerine yazan her düzenleme asistana "geri alınamaz" olarak bildirilir. Bugün bu gruba 45 araç giriyor. Her araç bu işareti kendi tanımında taşır ve sunucu açılırken bunu kontrol eder; işareti olmayan bir araç yayına çıkmaz. Düzgün çalışan istemcilerin bu araçları ç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.

Bazı şeyler bilinçli olarak hiç yayınlanmıyor ve bu listeyi bilmekte fayda var: hiçbir araç ödemelerinize dokunmaz, hiçbiri API anahtarı oluşturmaz ya da iptal etmez, hiçbiri bağlı bir uygulamanın erişimini kaldırmaz ve kişi dışa aktarma diye bir araç yoktur. Asistan hesabınızdaki anahtarların listesini okuyabilir ama yalnızca adlarını, ön eklerini ve tarihlerini görür; anahtarın değerini asla göremez. Ekip ve gönderim ayarlarına erişilebilir, ancak kendi izinlerinin arkasından: bir ekip arkadaşını davet etmek ya da rolünü değiştirmek aşağıdaki sekizinci izni gerektirir ve uygulamanın bunu ayrıca istemesi şarttır. Asistan araç listesini okuyun rehberi tabloyu sütun sütun geziyor.

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

Dikkat

send_campaign ve unsubscribe_contact, karşınıza en çok çıkacak ikisi ve ikisi de geri alınamaz. Kontrolü tamamen elinizde tutmak istiyorsanız bir sonraki adımda gönderim iznini kapalı bırakın ve listeden çıkarma işlemlerini kendiniz yapın.

Mailsoftly MCP sayfasındaki araç tablosunda barındırılan sunucunun kaç araç yayınladığını söyleyen cümle ve tablonun ilk satırları

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.

Sistemin tamamında sekiz izin vardır; onay ekranı bunlardan yalnızca uygulamanın istediklerini, her biri için sade bir satırla gösterir:

  • 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

Sonuncusu, yani ekip arkadaşlarını davet etme ve rollerini değiştirme izni yeni ve bağlayıcıların çoğu bunu istemiyor. Bir onay ekranında görürseniz, o uygulama ekibinizi yönetmek istiyor demektir.

Gönderim izni ise hiçbir zaman öylece listelenmez. 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.

Not

Bir uygulamayı yalnızca yönetici bağlayabilir, çünkü verilen erişim şirketin tamamı adına çalışır. Yönetici değilseniz ekran bunu size söyler ve uygulamayı bir yöneticinin bağlamasını ister.

Mailsoftly onay ekranında bir uygulamanın istediği izinler ve işaretlenmemiş kampanya gönderme onay kutusu

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.

Mailsoftly ayarlarındaki bağlı uygulamalar sayfasında bir uygulama, verilen izinleri ve erişim kaldırma düğmesi

Sık sorulan sorular

Mailsoftly asistanına bağladığımda hangi bilgilere erişilebiliyor?

Mailsoftly asistanına bağlandığınızda, kişilerinizi, listelerinizi, kampanyalarınızı ve daha birçok öğeyi görüntüleyebilir, ayrıca izin verdiğiniz ölçüde oluşturma, düzenleme ve gönderim işlemleri yapabilirsiniz. Hiçbir araç ödeme bilgilerinize ya da API anahtarınızın değerine erişemez. Hangi alanlara erişilebileceğini onay ekranında görebilirsiniz.

Mailsoftly ile asistan bağlantısını nasıl ve nereden kaldırabilirim?

Mailsoftly ile asistan bağlantısını kaldırmak için Ayarlar bölümünde Gelişmiş başlığı altındaki Bağlı uygulamalar sayfasını açmalısınız. Burada erişimi olan tüm uygulamaları görebilir ve istediğiniz uygulamanın satırındaki Erişimi kaldır düğmesini kullanarak bağlantıyı anında kesebilirsiniz. Bu işlem sadece yöneticilere açıktır.

Bir uygulamaya Mailsoftly üzerinden kampanya gönderme izni vermek zorunda mıyım?

Hayır, kampanya gönderme izni vermek zorunda değilsiniz. Onay ekranında bu izin ayrı bir kutu olarak gelir ve işaretlemediğiniz sürece asistan yalnızca kampanya hazırlayabilir, gönderim işlemini sizin başlatmanızı bekler. Gönderim izni her bağlantıda yeniden sorulur ve varsayılan olarak kapalıdır.

Kendi hesabınızda denemeye hazır mısınız?

Google Workspace veya Microsoft 365 hesabınızla ücretsiz başlayın. Kredi kartı gerekmez.

Sırada ne var