cpanel-mail-mcp: cPanel Posta Kutunuzu Claude’a Bağlayın

Posta Kutunuz cPanel’de, Asistanınız Değil

Küçük ve orta ölçekli işletmelerin önemli bir kısmı e-postasını hâlâ web sitesiyle aynı cPanel hosting hesabında çalıştırıyor. Ucuz, zaten ödenmiş ve sorunsuz işliyor. Sorun, ekip gerçek işini Claude Code’da ya da Claude masaüstü uygulamasında yapmaya başladığı anda ortaya çıkıyor: asistan dosya okuyabiliyor, kod yazabiliyor, belge hazırlayabiliyor; ama müşteri taleplerinin, faturaların ve toplantı davetlerinin düştüğü posta kutusu erişim dışında kalıyor.

Bu boşluğu kapatmak için cpanel-mail-mcp aracını geliştirdik. Tek bir cPanel posta kutusunu (okuma için IMAP, gönderme için SMTP, takvim için CalDAV) doğrudan Claude Code’a ve Claude masaüstü uygulamasına bağlayan küçük, açık kaynaklı bir MCP sunucusu. Kendi makinenizde stdio üzerinden çalışır; OAuth ara katmanı, reverse proxy ya da sürekli açık tutulması gereken bir sunucu gerekmez.

cPanel neden farklı bir yaklaşım gerektiriyor

Çoğu e-posta entegrasyonu, OAuth ya da uygulamaya özel şifre sunan bir sağlayıcı varsayar. “İzin ver”e tıklarsınız, sağlayıcı yetkisi sınırlı bir token üretir ve entegrasyon gerçek şifrenizi hiç görmez. cPanel e-postasında ikisi de yok. Tek kimlik bilgisi düz IMAP şifresidir ve bu şifre her şeydir: posta kutusunu okuma ve o kişi adına e-posta gönderme yetkisinin tamamını verir.

Tasarımın tamamını bu tek gerçek belirledi. Tüm ekip arkadaşlarının posta kutularını tutan merkezî, ortak bir sunucu, herkesin düz şifresini tek bir yerde saklamak zorunda kalırdı. Tek bir ihlal bütün ekibin yazışmasını açığa çıkarırdı. Bu yüzden merkezî kurulum bilinçli olarak tercih edilmedi.

Her process’e tek posta kutusu

Bunun yerine sunucu her process’te tek bir posta kutusu çalıştırır. Herkes kendi örneğini, kendi makinesinde, kendi kimlik bilgisiyle çalıştırır. Şifre o makineden hiç çıkmaz. Beş kişilik bir ekipte tek büyük bir hedef yerine beş küçük yerel process olur.

Tek Komutla Kurulum

Proje bir kurulum sihirbazıyla geliyor; ekipte kimsenin yapılandırma dosyasını elle düzenlemesi gerekmiyor. Node 20 ya da üstü kuruluysa işi tek komut görür:

npx -y https://github.com/Burak-Kumas/cpanel-mail-mcp/archive/refs/heads/main.tar.gz setup

Sihirbaz üç adımda ilerler:

• cPanel posta hesabının kullanıcı adını, şifresini, sunucusunu ve IMAP/SMTP portlarını sorar. Sunucu ve portlar olağan cPanel varsayılanlarıyla dolu gelir.

• Hiçbir şeyi kaydetmeden önce bilgileri gerçek bir IMAP ve SMTP girişiyle doğrular, hesapta takvim olup olmadığını kendisi tespit eder.

• Sunucuyu hem Claude Code’a hem Claude masaüstü uygulamasına kaydeder.

npx önbelleği geçici olduğu için sunucu ~/.cpanel-mail-mcp/ altına kopyalanır; ayarlar ~/.cpanel-mail-mcp/.env dosyasında, yalnızca sizin kullanıcınızın okuyabildiği 600 izniyle tutulur. Depoda, kurulumu ekran ekran takip etmek isteyen ekip arkadaşları için adım adım Türkçe bir rehber de var.

Claude Posta Kutunuzla Neler Yapabilir

Bağlantı kurulduğunda Claude, amaca göre gruplanmış bir dizi araca erişir. Bunları kendiniz çağırmazsınız; ne istediğinizi düz bir dille söylersiniz, asistan doğru aracı seçer.

Okuma, yazma ve düzenleme

• Okuma: list_folders, list_messages, search_messages, get_message, list_attachments ve save_attachment.

• Yazma: ek dosya destekli send_message, zincir başlıklarını ve alıntıyı koruyan reply_message (replyAll desteğiyle), ekleriyle birlikte forward_message ve create_draft.

• Düzenleme: okundu, yıldızlı ve cevaplandı durumları için set_flags; ayrıca move_message, archive_message, mark_spam ve trash_message.

Klasörler ve takvim

• Klasörler: create_folder, rename_folder, delete_folder ve empty_trash.

• Takvim: list_calendars, list_events, create_event, update_event ve delete_event; bir CalDAV adresi tanımlıysa kullanılabilir (sihirbaz bunu sizin için tespit eder).

Hataları Geri Alınabilir Tutan Güvenlik Tercihleri

Bir asistana e-postada yazma yetkisi vermek dikkat ister; bu yüzden varsayılanlar geri dönülebilirlikten yana.

• Şifre yerelde kalır. Kimlik bilgileri, sizin makinenizde, yalnızca sizin kullanıcınızın okuyabildiği bir dosyada durur ve yalnızca sizin çalıştırdığınız bir process tarafından kullanılır.

• Kalıcı silme varsayılan olarak kapalıdır. delete_message yalnızca ALLOW_DELETE=true açıkça ayarlandığında devreye girer.

• Çöp kutusu geri alınabilir. Normal silme trash_message ile yapılır; e-posta Çöp Kutusu’na taşınır ve oradan geri yüklenebilir.

• Gelen kutusu korunur. INBOX klasörü silinemez.

Bunların hiçbiri bir asistandan ne istediğinize dair sağduyunun yerini tutmaz; ama yanlış anlaşılan bir talimatın bedeli çoğu zaman kaybolan bir e-posta değil, Çöp Kutusu’na kısa bir uğramak olur.

cPanel Hosting Kullanan Ekipler İçin Günlük İş Akışları

Asıl fayda, eskiden pencere değiştirmeyi ve metni ileri geri kopyalamayı gerektiren küçük, tekrar eden işlerde ortaya çıkıyor.

• Sabah taraması: Claude’dan son bir günün okunmamış e-postalarını listelemesini, hangilerinin yanıt beklediğini özetlemesini ve önemli olanları işaretlemesini isteyin.

• Gönderilmeden taslak: yanıtları asistana taslak olarak hazırlatın, ardından her zamanki e-posta istemcinizden gözden geçirip kendiniz gönderin.

• Ekler doğrudan projeye: müşterinin gönderdiği brifi ya da faturayı bulup eki üzerinde çalıştığınız klasöre kaydettirin.

• E-postadan takvime: bir e-postadaki toplantı talebini tarih, saat ve ayrıntıları yeniden yazmadan takvim etkinliğine dönüştürün.

• Düzenli klasörler: bir müşterinin yazışmalarını proje klasörüne taşımayı, eski bültenleri arşivlemeyi ve bariz spam’i işaretlemeyi tek bir talepte yaptırın.

E-postasını web sitesinin yanında barındıran ajanslar ve işletmeler için bu, mevcut yapının doğal bir parçası hâline geliyor. Sitenizi yayınlayan ve web tasarım ve geliştirme ekibimizin lansmanda sıklıkla yapılandırdığı aynı hosting hesabı, artık günlük asistan işlerinizi de besleyebiliyor. Bu, hosting’i zaman içinde sağlıklı tutmak için de bir neden daha; konuyu lansman sonrası web sitesi bakımı rehberimizde ele alıyoruz.

Çözdüğümüz Teknik Pürüzler

cPanel’in e-posta altyapısı, kütüphanelerin çoğunun test edildiği sağlayıcılardan biraz farklı davranıyor. Bu farklardan birkaçı basit bir entegrasyonu bozardı; sunucu bunları doğrudan ele alıyor.

cpdavd üzerinde takvim keşfi

cPanel’in cpdavd servisi multistatus yanıtlarında yanlış href döndürüyor. Standart otomatik CalDAV keşfi bu sunucularda “cannot find homeUrl” hatasıyla başarısız oluyor; bu yüzden sunucu keşfi elle yapıyor.

Taslaklar, Gönderilenler ve masaüstü uygulaması

• Taslak klasörünün adı: cPanel’de taslak klasörü Drafts değil, INBOX.Drafts. Sunucu adı tahmin etmek yerine klasörü IMAP SPECIAL-USE bayrağından buluyor.

• Gönderilen kopyalar: SMTP ile gönderim, Gönderilenler klasörüne hiçbir şey koymuyor. Sunucu mesajı bir kez derliyor, gönderiyor ve aynı mesajı IMAP APPEND ile Gönderilenler’e yazıyor; böylece iki kopyanın Message-ID değeri aynı oluyor.

• Masaüstü uygulaması ve Node: Claude masaüstü uygulaması kabuğunuzu yüklemediği için nvm gibi araçlar orada çözülmüyor. Kayıt sırasında çıplak komut yerine node için mutlak yol kullanılıyor; sunucunun Claude Code’da olduğu kadar masaüstü uygulamasında da sorunsuz başlamasının nedeni bu.

Mesaj gövdeleri de gerçek bir e-posta ayrıştırıcısıyla çözülüyor; çünkü ham kaynaktan başlık kesmek çok parçalı ve base64 kodlu mesajlarda okunaksız çıktı veriyordu.

Nasıl Başlanır

Ekibinizin e-postası cPanel’de çalışıyorsa ve zaten Claude ile çalışıyorsanız, işinize yarayıp yaramadığını anlamanın en hızlı yolu aracı tek bir posta kutusuna kurup bir hafta kullanmak. Kaynak kod, araçların tam listesi ve Türkçe kurulum rehberi GitHub’da.

Asistanları iş sistemlerine bağlamak, modellerin sizin adınıza neyi görüp neyi yapabildiğine dair daha geniş bir sorunun parçası; konuyu öbür taraftan yapay zekâ tarayıcıları ve llms.txt yazımızda da ele alıyoruz. Bu tür araçları sitenize ve hosting yapınıza yerleştirmek için desteğe ihtiyacınız olursa web geliştirme ekibimiz bunu sizinle birlikte planlayabilir.