Elastic Email MCP

Not: Yukarıdaki video, API anahtarıyla yetkilendirmenin yalnızca bir yöntemini gösterir.

MCP sunucu adresi https://mcp.elasticemail.com, yalnızca AI ajanlarını bağlamak için kullanılır. Elastic Email REST API'sinin adresi değildir ve diğer entegrasyonlarda API ana bilgisayarı olarak kullanılamaz. API adresi için "API Ayarları" makalesine bakın.

MCP'yi uygulayarak Elastic Email, AI ajanlarının güvenliği ve doğru kimlik doğrulamayı korurken e-posta işlemlerinize erişmesine ve kontrol etmesine olanak tanır.

MCP'mizin sizin için yapabileceği mevcut eylemler

• Bir listeye kişi ekleme
• Kişileri yükleme ve ekleme
• Liste oluşturma
• Segment oluşturma
• Kampanya oluşturma
• Kampanyaları getirme
• Kampanya güncelleme
• Kampanyayı duraklatma
• Kampanyaları listeleme
• E-posta gönderme: hem işlemsel hem toplu
• Kişi, kişiler, listeden kişi getirme
• Listeleri getirme
• Şablonları getirme
• Segmentleri getirme
• Hazır mı (sağlık kontrolü, bağlantı ve hazır olma kontrolü)
• Kişiyi listeden silme
• Kişiyi hesaptan silme

Lütfen listelenen uç noktaların tümünün Elastic Email fiyatlandırma planlarının tümü için kullanılamayacağını unutmayın. Örneğin - kampanyalar ve kişiler uç noktaları E-posta API planları için kullanılamaz. Yukarıda listelenen özelliklerle ilgili mevcut makalelerimizin tam listesi aşağıdadır:

https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments

https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign

http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates

Kurulum

MCP sunucumuza bağlanmak için MCP'yi destekleyen herhangi bir AI Ajanını kullanabilirsiniz. Herhangi bir kurulum için temel gereksinim, AI ajanının harici hizmetlerle programlı olarak güvenli bir şekilde etkileşime girmesine olanak tanıyan "ajan modu" desteğidir.

VS Code ve Github Copilot araçlarını kullanarak adım adım örnek bir kurulum hazırladık.

• https://github.com Github'da ücretsiz bir hesap oluşturmanız gerekecek
• https://code.visualstudio.com/ VS Code'u bu web sitesinden indirin

Ardından Github hesabınızı VS Code'a bağlamanız gerekecek

• Github Copilot'ta Visual Studio Code'u yetkilendirin

• Sonraki adımda VS Code'un çalışmasına izin verin

• Sohbet penceresini görüntülemek için VS Code üst menüsünde Görünüm → Sohbet'e gidin. Sohbet sağ tarafta görüntülenmelidir.

• Sohbeti Ajan Moduna geçirin

• Artık mevcut iki yetkilendirme yönteminden birini kullanabilirsiniz:

1. Elastic Email'de bir API anahtarı oluşturun. Görüntüleme ve değiştirme için gereken izinler şunlardır: Hesap, Şablonlar, Kampanyalar, Kişiler, Dosyalar, HTTP Gönder. Buna ek olarak, Erişim Belirteçleri için en az "görüntüleme" erişimi gereklidir. Lütfen API Anahtarınızı yetkisiz üçüncü taraflarla **asla** paylaşmayı unutmayın!

2. OAuth yetkilendirme yöntemini kullanın. Sonraki talimat adımlarını izleyin ve X-Auth-Token içeren başlıklar bölümünü atlayın. Hazır olduğunuzda, MCP sunucusuna bağlantıyı başlatın: yapılandırma dosyasında elasticemail.mcp üzerinde Başlat'a tıklayın ve VS Code'un oidc.elasticemail.com üzerinden kimlik doğrulaması yapmasına izin verin.

Giriş sayfasına yönlendirileceksiniz. Başarılı bir girişten sonra otomatik olarak VS Code'a geri yönlendirileceksiniz. Bu olmazsa, sayfada görüntülenen talimatı izleyin:

• VS Code üst çubuğunda arama işlevini kullanarak şunu bulun: Komutları göster ve çalıştır
• Arama alanına "MCP" yazabilirsiniz mevcut seçenekleri daraltmak için ve "MCP: Kullanıcı yapılandırmasını aç" seçeneğini seçin.
• Aşağıdaki gibi yapılandırma metnini yapıştırın (zaten sunucularınız varsa yalnızca elasticemail.mcp verileri yeterli olacaktır)
• Başlıklar bölümünü yalnızca anahtar yöntemini yetkilendirme için kullanmak istiyorsanız API anahtarınızla kullanın. OAuth yöntemini kullanıyorsanız kaldırın.

{
    "servers": {
        "elasticemail.mcp": {
            "url": "https://mcp.elasticemail.com",
            "headers": {
                "X-Auth-Token": "your_api_key"
            }
        }
    }
}

Buradaki en önemli adımın, yukarıda belirtilen izinlere sahip gerçek API Anahtarınızı girmeniz olduğunu lütfen unutmayın. Ayrıca bu alanı değiştirdikten sonra devam etmeden önce değişiklikleri kaydettiğinizden emin olun. Değişiklikleri kaydetmeden entegrasyonu "başlatma" seçeneği görünmeyecektir.

• Artık MCP sunucusuna bağlantıyı başlatabilirsiniz: yapılandırma dosyasında elasticemail.mcp üzerinde Başlat'a tıklayın.

Artık sohbet penceresi içinde Elastic Email MCP sunucusu tarafından sağlanan eylemleri kullanabilirsiniz. Bu eylemler bu makalenin başında özetlenmiştir.

Entegrasyonun çalıştığından emin olmak için ilk komutunuzu deneyebilirsiniz. Örnek olarak "MCP çalışıyor mu" istemini girebilirsiniz ve her şey çalışıyorsa yanıt olarak bir onay almalısınız.

Bu tür bir entegrasyonun Elastic Email tarafında nasıl çalıştığını daha iyi anlamak için API Dokümantasyonumuzu da incelemekten çekinmeyin:

https://elasticemail.com/developers/api-documentation/rest-api

İpuçları

1. AI ajanları bazı önceki talimatları hatırlayıp bunları yeniden denemeye takılı kalabilir. Bu tür sorunları çözmek için yeni bir sohbet oturumu başlatmak faydalıdır. Ayrıca Ajana araçları yeniden getirmesini talimat verebilir ve sunucuda değişiklikler olduğunu söyleyerek yeni verileri gerçekten yeniden getirdiğinden emin olabilirsiniz.
2. İstem ne kadar kesin olursa, LLM'ye yorumlama için o kadar az alan bırakırsınız ve halüsinasyonla ilgili sorunları azaltırsınız.
3. İstekleri göndermeden önce incelemek faydalıdır, çünkü LLM'nin isteğinizi API çağrılarına nasıl çevirdiği konusunda potansiyel tutarsızlıklar fark edebilirsiniz.

Diğer AI ajanlarında MCP bağlama

Yukarıdaki kurulum VS Code ve GitHub Copilot kullanır, ancak aynı sunucu adresi MCP'yi destekleyen ve ajan modunda çalışabilen herhangi bir AI ajanıyla çalışır. Claude'a dayalı adım adım bir örnek için bkz. Elastic Email MCP sunucusunu Claude'a bağlama.