Yapay Zeka Asistanlarını Bağlayın (MCP)
DM Champ, Claude Code, Claude Desktop, ChatGPT, Cursor gibi yapay zeka asistanlarının ve kendi uygulamalarınızın DM Champ hesabınızı doğrudan yönetmesini sağlayan bir Model Context Protocol uç noktası olan resmi bir MCP sunucusu sunar. Sade bir dille sorun (“canlı kampanyalarımı listele”, “bu potansiyel müşteriyi ekle”, “yapay zeka bu hafta bana ne kadara mal oldu?”) ve asistan sizin yerinize DM Champ API’sini çağırsın.
API bölümünde belgelenen v1 API ile aynıdır ve kendi API anahtarınızla kimlik doğrulaması yapılır. MCP sunucusu, yayınlanan API spesifikasyonumuzdaki her işlem için bir araç oluşturur; bu nedenle v1 API’sinin tamamını olmasa da çoğunu kapsar: kişiler, mesajlar, kampanyalar, yapay zeka temsilcileri, bilgi tabanı, randevular, analizler, etiketler, listeler ve alt hesaplar. Yayınlar, Otomasyonlar ve Fırsatlar henüz MCP araçları olarak mevcut değildir; bunlar için doğrudan REST API’sini kullanın. Sunduğu özellikler dahilinde araç başına izinler veya varsayılan salt okunur modu yoktur, bu nedenle API anahtarı tüm erişim kontrolünü sağlar.
- Uç nokta:
https://mcp.youraiconnector.com/mcp - Kimlik Doğrulama: DM Champ API anahtarınız (
X-API-Keybaşlığı olarak gönderilir) - Gereksinim: API erişimi olan bir plan. Bir API anahtarı oluşturun →
API anahtarınız, API’nin geri kalanıyla aynı izinlere sahip olarak kendi hesabınız üzerinde işlem yapar ve eğer bir ajans planındaysanız (aşağıya bakın) yönettiğiniz müşteri hesaplarını okuyabilir. Onu bir parola gibi saklayın. Ayarlar → Entegrasyonlar → API Anahtarı kısmından istediğiniz zaman iptal edebilirsiniz; bu, asistanın erişimini anında keser.
Claude Code
claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
--header "X-API-Key: YOUR_API_KEY"
Ardından, dm-champ ✓ connected yazdığını doğrulamak için Claude Code içinde /mcp komutunu çalıştırın.
Varsayılan olarak sunucu yerel kapsamda (sadece siz, bu proje) eklenir. Bunu tüm projelerinizde kullanılabilir hale getirmek için --scope user kullanın veya ekibiniz için --scope project to commit it to a repo’s .mcp.json ifadesini kullanın:
{
"mcpServers": {
"dm-champ": {
"type": "http",
"url": "https://mcp.youraiconnector.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
Claude Desktop
claude_desktop_config.json dosyanızı düzenleyin (Ayarlar → Geliştirici → Yapılandırmayı Düzenle) ve şunu ekleyin:
{
"mcpServers": {
"dm-champ": {
"type": "http",
"url": "https://mcp.youraiconnector.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
Claude Desktop’ı yeniden başlatın. DM Champ araçları, araçlar menüsünde görünecektir.
ChatGPT
Özel MCP bağlayıcıları ChatGPT Business, Enterprise ve Pro sürümlerinde mevcuttur. Bir çalışma alanı sahibi veya yöneticisinin öncelikle çalışma alanı ayarlarından geliştirici modu / özel bağlayıcılar seçeneğini açması gerekir; aksi takdirde bağlayıcı oluşturma seçeneği görünmez.
Ardından bağlayıcıyı şununla oluşturun:
- URL:
https://mcp.youraiconnector.com/mcp - Kimlik Doğrulama: Özel başlıklar
- Başlık adı:
X-API-Key - Başlık değeri: DM Champ API anahtarınız
URL, /mcp ile bitmelidir. Sadece https://mcp.youraiconnector.com yapıştırmak en yaygın hatadır; ChatGPT tam o adresi kontrol eder, orada hiçbir şey bulamaz ve “Bağlayıcı URL’si eklenemedi” (“Unable to add connector URL”) hatasını gösterir.
Cursor ve diğer MCP istemcileri
MCP destekli çoğu düzenleyici, yukarıda gösterilenle aynı .mcp.json yapısını kullanır (url ve X-API-Key başlığına sahip bir HTTP sunucusu). https://mcp.youraiconnector.com/mcp adresini işaret eden bir dm-champ sunucusu ekleyin ve API anahtarınızı başlığa yapıştırın.
Claude API (kendi uygulamanıza entegre edin)
MCP sunucusunu Claude API’sinin MCP bağlayıcısı ile programatik olarak bağlayabilirsiniz, böylece oluşturduğunuz bir aracı ayrı bir istemci olmadan DM Champ araçlarını kullanabilir:
{
"model": "claude-opus-4-8",
"messages": [{ "role": "user", "content": "List my live campaigns" }],
"mcp_servers": [
{
"type": "url",
"name": "dm-champ",
"url": "https://mcp.youraiconnector.com/mcp",
"authorization_token": "YOUR_API_KEY"
}
]
}
Neler yapabilirsiniz
MCP sunucusunun sunduğu v1 API’nin bir parçası dahilinde, asistan doğru aracı otomatik olarak seçer:
- Kampanyalar: listeleme, oluşturma, güncelleme, duraklatma/devam ettirme, bot yapılandırmasını inceleme.
- Kişiler: arama, oluşturma, etiketleme, listelere ekleme, içe aktarma.
- Bilgi tabanı / SSS: ekleme, düzenleme, toplu içe aktarma, yapay zeka önerilerini onaylama.
- Mesajlar: konuşmaları okuma, bir kişiye mesaj gönderme.
- Randevular: listeleme, oluşturma, iptal etme.
- Görevler: oluşturma, tamamlama, listeleme.
- Analitik: mesaj istatistikleri, kredi kullanımı, yapay zeka maliyeti.
- Kanallar: bağlantı durumunu kontrol etme, bağlantı akışını başlatma.
Müşterilerinizin hesapları hakkında soru sorma (ajanslar)
Tek bir bağlantı, yönettiğiniz tüm hesapları kapsar. Müşteri başına ikinci bir bağlantı eklemenize gerek yoktur: bir ajans planında asistan, altınızdaki herhangi bir müşteri hesabını okuyabilir, böylece hepsine tek bir konuşmada soru sorabilirsiniz.
Sadece müşterinin adını belirtin:
- “Bella’s Bistro’nun kaç kişisi var?”
- “Bu hafta yapay zeka her bir müşterime ne kadara mal oldu?”
- “Northside Dental için hangi kampanyalar yayında ve kanallarının durumu nedir?”
Bu; kişileri, mesajları, sohbetleri, kampanyaları, randevuları, görevleri, etiketleri, etkinlikleri, SSS’leri, bilgi tabanı kaynaklarını, telefon numaralarını, kanalları, web kancalarını ve analizleri okumayı kapsar. Herhangi bir işlem çalışmadan önce hesabın gerçekten size ait olduğunu kontrol ederiz; size ait olmayan bir hesap istendiğinde “bulunamadı” yanıtı döner. Müşteriyi belirtmezseniz asistan, tıpkı daha önce olduğu gibi kendi hesabınızı okur.
Bir müşterinin hesabını değiştirmek daha sınırlıdır. Yapay zeka temsilcileri, özel işlevler, WhatsApp şablonları, giriş noktaları, kanal bağlantıları, kampanya durumu ayarlamak ve bir numara satın almak belirli bir müşteri için çalışır; diğer çoğu yazma işlemi hala kendi hesabınızda çalışır, bu nedenle bunları o müşterinin kendi anahtarından veya daha fazlasını kapsayan REST API üzerinden yapın.
Bu aynı zamanda tek bir giriş altında birden fazla işletme yürüten bir müşteri için de cevaptır. Her işletmeye kendi hesabını verin, ardından müşterinin e-postasını hepsine ekip üyesi olarak davet edin: bir kez giriş yaparlar ve kenar çubuğundaki hesap seçici ile markaları arasında geçiş yaparlar.
Asistanınıza yardım dokümanlarını verme
MCP sunucusu asistana hesabınızı verir; bu dokümantasyonu vermez. Ayrıca “nasıl yaparım…” sorularını doğru bir şekilde yanıtlamasını istiyorsanız, onu https://docs.youraiconnector.com/llms.txt (her yardım sayfasının Markdown sürümüne bağlantı içeren bir dizin) veya https://docs.youraiconnector.com/llms-full.txt (tek bir Markdown dosyasındaki tüm dokümantasyon) adresine yönlendirin. Her ikisi de herkese açıktır, anahtar gerektirmez ve her dokümantasyon değişikliğinde yeniden oluşturulur. Bkz. Bu dokümanları Markdown olarak okuma.
API Anahtarınızı Bulma veya Oluşturma
Bu bağlantının kullandığı API anahtarı Ayarlar → Entegrasyonlar → API Anahtarı kısmında, Webhook’lardan ayrı olan kendi bölümünde bulunur. Tam adımlar için API Erişimi bölümüne bakın.
Sorun Giderme
- “Bağlayıcı URL’si eklenemedi” (ChatGPT) / “bağlantı reddedildi” — adresin sonunda
/mcpeksik.https://mcp.youraiconnector.comyerinehttps://mcp.youraiconnector.com/mcpkullanın. Needs authentication/ 401 — API anahtarınız eksik veya yanlış. Sunucuyu geçerli birX-API-Keyile yeniden ekleyin.- Bir araç
403döndürüyor — planınız veya ekip rolünüz bu işleme izin vermiyor; MCP sunucusu fazladan bir kısıtlama getirmez, API ile aynı izin denetimi uygulanır. - Araç bulunamadı — araç listesi API’den canlı olarak oluşturulur, bu nedenle her zaman mevcut sürümle eşleşir; yenilemek için yeniden bağlanın.
- Kendi alan adınızda bir güvenlik veya sertifika uyarısı — bir DNS kaydını bize yönlendirmek tek başına yeterli değildir: alt alan adının güvenli bir bağlantı sunabilmesi için önce kontrol panelinde doğrulanması gerekir. White-label ajansları, MCP adresini kendi alan adlarına (örneğin
mcp.youragency.com) Ayarlar → White Labeling altındaki Özel alan adı kartından ekleyebilirler — önce kayıt kuruluşunuzda CNAME kaydını ekleyin, ardından MCP alan adı (Yapay zeka asistanları) bloğuna ana bilgisayar adını girin ve Doğrula’ya tıklayın; bu, diğer markalı alt alan adlarınızla aynı akıştır. Doğrulanana kadar yukarıdaki standart adresi kullanın — bu adres markasızdır, bu nedenle müşterilerle paylaşmak güvenlidir.
Sonraki Adımlar
- API Erişimi — bu bağlantının kullandığı anahtarı oluşturun veya yenileyin.
- Webhook’lar — bu çekme tabanlı MCP bağlantısının itme tabanlı karşılığı.