# Yapay Zeka Asistanlarını Bağlayın (MCP)

<span data-t="appName">DM Champ</span>, **Claude Code**, **Claude Desktop**, **ChatGPT**, **Cursor** gibi yapay zeka asistanlarının ve kendi uygulamalarınızın <span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span> API'sini çağırsın.

[API bölümünde](../api/getting-started.md) 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:** <span data-t="appName">DM Champ</span> API anahtarınız (`X-API-Key` başlığı olarak gönderilir)
- **Gereksinim:** API erişimi olan bir plan. [Bir API anahtarı oluşturun →](api-access.md#generating-your-api-key)

> 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

```bash
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:

```json
{
  "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:

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

Claude Desktop'ı yeniden başlatın. <span data-t="appName">DM Champ</span> 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:** <span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span> araçlarını kullanabilir:

```json
{
  "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](../agency/api-for-agencies.md) ü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.dmchamp.com/llms.txt` (her yardım sayfasının Markdown sürümüne bağlantı içeren bir dizin) veya `https://docs.dmchamp.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/getting-started.md#reading-these-docs-as-markdown).

## 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](api-access.md#generating-your-api-key) bölümüne bakın.

## Sorun Giderme

- **"Bağlayıcı URL'si eklenemedi" (ChatGPT) / "bağlantı reddedildi"** — adresin sonunda `/mcp` eksik. `https://mcp.youraiconnector.com` yerine `https://mcp.youraiconnector.com/mcp` kullanın.
- **`Needs authentication` / 401** — API anahtarınız eksik veya yanlış. Sunucuyu geçerli bir `X-API-Key` ile yeniden ekleyin.
- **Bir araç `403` dö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](api-access.md) — bu bağlantının kullandığı anahtarı oluşturun veya yenileyin.
- [Webhook'lar](webhooks.md) — bu çekme tabanlı MCP bağlantısının itme tabanlı karşılığı.