MCP Sunucuları
AI SmartTalk'a dış araçlar ve hizmetler bağlamak için Model Context Protocol (MCP)'yi kullanın. MCP, AI asistanınızın birleşik bir arayüz aracılığıyla dış sistemlerle etkileşimde bulunmasına olanak tanıyan açık bir standarttır.
Genel Bakış
MCP Sunucu entegrasyonu ile şunları yapabilirsiniz:
- Birden fazla MCP sunucusunu aynı anda bağlayın
- Dış araçları AI'nın konuşmalar sırasında çağırması için açığa çıkarın
- Özel HTTP başlıkları ile kimlik doğrulaması yapın (API anahtarları, tokenlar, vb.)
- Canlıya geçmeden önce bağlantıları test edin
- Özel geliştirme olmadan yetenekleri genişletin
MCP nedir? Model Context Protocol, AI sistemlerinin dış veri kaynakları ve araçlarla güvenli bir şekilde bağlantı kurmasına olanak tanıyan açık bir standarttır (Anthropic tarafından geliştirilmiştir). Daha fazla bilgi için modelcontextprotocol.io adresini ziyaret edin.
Ön Gereksinimler
Başlamadan önce şunlara sahip olduğunuzdan emin olun:
- Aktif bir AI SmartTalk hesabı
- Bir veya daha fazla MCP uyumlu sunucuya erişim
- Her MCP sunucusu için sunucu URL'si
- Gerekli kimlik doğrulama bilgileri (API anahtarları, tokenlar)
MCP Nasıl Çalışır
- Kullanıcı, dış verilere ihtiyaç duyan bir soru sorar
- AI SmartTalk, bir MCP aracına ihtiyaç duyduğunu tanır
- Uygun MCP sunucusu, doğru araç ile çağrılır
- Yanıt döner ve AI doğal dilde bir cevap oluşturur
AI SmartTalk, birden fazla MCP sunucusunu aynı anda destekler. Farklı sunuculardan gelen araçlar, çakışmaları önlemek için otomatik olarak isim alanına alınır.
Adım Adım Kurulum
Adım 1: MCP Entegrasyonuna Erişim
- AI SmartTalk hesabınıza giriş yapın
- Yönetim → Asistanlarım → [Asistan Adınız] bölümüne gidin
- Sol kenar çubuğunda Bağlayıcılar üzerine tıklayın
- MCP Sunucuları'nı bulun ve üzerine tıklayın
Adım 2: Bir MCP Sunucusu Ekleyin
Sunucu yapılandırma formunu açmak için Sunucu Ekle'ye tıklayın. Aşağıdaki alanları doldurun:
| Alan | Gerekli | Açıklama |
|---|---|---|
| Sunucu Adı | Evet | Bu sunucuyu tanımlamak için dostça bir ad (örn. "Şirket CRM", "İç Wiki") |
| Sunucu URL'si | Evet | MCP sunucu uç noktası URL'si (örn. https://mcp.example.com) |
| HTTP Başlıkları | Hayır | Kimlik doğrulama veya diğer gereksinimler için özel başlıklar |
AI SmartTalk, URL'nizin sonunda /mcp yoksa otomatik olarak ekler. Örneğin, https://example.com https://example.com/mcp olur. Sunucunuz farklı bir uç nokta yolu kullanıyorsa, bunu URL'ye dahil edin (örn. https://example.com/api/mcp).
Adım 3: Kimlik Doğrulama Başlıkları Ekleyin (İsteğe Bağlı)
Eğer MCP sunucunuz kimlik doğrulama gerektiriyorsa, özel HTTP başlıklarını yapılandırmak için Başlık Ekle'ye tıklayın:
| Yaygın Başlık | Kullanım Durumu |
|---|---|
Authorization | Bearer tokenlar (örn. Bearer sk-xxx...) |
X-API-Key | API anahtarı kimlik doğrulaması |
X-Auth-Token | Özel token kimlik doğrulaması |
Her başlık için, aşağıdakileri sağlayın:
- Anahtar: Başlık adı (yaygın başlıklardan seçin veya özel bir tane yazın)
- Değer: Başlık değeri (hassas değerler UI'da otomatik olarak gizlenir)
Her sunucu için birden fazla başlık ekleyebilirsiniz. Anahtar adında "secret", "password", "token" veya "auth" içeren başlıklar güvenlik nedeniyle otomatik olarak gizlenir.
Adım 4: Bağlantıyı Test Edin
Kaydetmeden önce, sunucunuzun erişilebilir olduğunu doğrulamak için Bağlantıyı Test Et'e tıklayın:
- AI SmartTalk, sunucunuza bir JSON-RPC başlatma isteği gönderir
- Test, sırayla birden fazla uç noktayı kontrol eder:
/mcp,/health, ardından temel URL - Sonuçlar bağlantı durumu, yanıt süresi ve sunucu bilgilerini gösterir
| Test Sonucu | Anlamı |
|---|---|
| Bağlandı | Sunucu, MCP protokolü ile başar ılı bir şekilde yanıt verdi |
| Kimlik doğrulama başarısız | Başlıklardaki API anahtarınızı veya tokenınızı kontrol edin |
| Sunucu bulunamadı | URL'nin doğru olduğunu doğrulayın |
| Bağlantı reddedildi | Sunucu kapalı olabilir veya güvenlik duvarı erişimi engelliyor olabilir |
| Zaman aşımı | Sunucu yanıt vermek için çok uzun sürdü (10s sınırı) |
| SSL hatası | Sunucunun geçerli bir SSL sertifikasına sahip olduğunu kontrol edin |
Adım 5: Yapılandırmayı Kaydedin
- Sunucuyu listenize eklemek için Ekle'ye tıklayın
- Gerekirse daha fazla MCP sunucusu eklemek için Adım 2-4'ü tekrarlayın
- Tüm yapılandırılmış sunucuları etkinleştirmek için Entegrasyonu Kaydet'e tıklayın
Çoklu Sunucu Desteği
AI SmartTalk, birden fazla MCP sunucusunu aynı anda bağlamayı destekler. Bu, farklı kaynaklardan gelen araçları birleştirmenizi sağlar:
Araç İsim Alanı
Her sunucudan gelen araçlar, isim çakışmalarını önlemek için otomatik olarak sunucu adı ile ön eklenir. Örneğin:
company_crm__musteri_arainternal_wiki__belge_araweather_api__tahmin_al
Bu, aynı isimde araçlar sunan sunucuları güvenle bağlayabileceğiniz anlamına gelir.
Birden Fazla Sunucuyu Yönetme
Entegrasyon kontrol paneli, tüm yapılandırılmış sunucuları gösterir:
- Sunucu adı ve URL'si kolay tanımlama için
- Başlık sayısı rozeti, özel başlıklar yapılandırıldığında
- Durum göstergesi (Yapılandırıldı / Tamamlanmadı)
- Eylem düğmeleri: Bağlantıyı test et, Düzenle veya bireysel sunucuları Sil
Araç Keşfi
MCP sunucularınız bağlandığında, AI SmartTalk otomatik olarak her sunucu tarafından açığa çıkarılan tüm mevcut araçları keşfeder. Bu araçlar, AI asistanınıza hemen sunulur.
AI asistanı:
- Tüm bağlı sunuculardan mevcut araçların listesini görecektir
- Kullanıcı sorgularına göre doğru aracı otomatik olarak seçecektir
- Aracı uygun parametrelerle çağıracaktır
- Yanıtı işleyip doğal dilde bir cevap verecektir
Bireysel araçları manuel olarak yapılandırmanıza veya etkinleştirmenize gerek yoktur. Bağlı bir MCP sunucusu tarafından açığa çıkarılan tüm araçlar, AI asistanınıza otomatik olarak sunulur.
Kullanım Senaryoları
Müşteri İlişkileri Yönetimi
CRM'inizi MCP aracılığıyla bağlayın:
- "Müşteri John Smith'i ara"
- "Hesap #12345'in durumu nedir?"
- "Kaç tane açık destek talebimiz var?"
İç Araçlar
Şirket sistemlerine erişim:
- "Ürün SKU-123 için envanteri kontrol et"
- "Yarın için programda ne var?"
- "İç wiki'mizdeki onboarding belgelerini ara"
Dış Veri Kaynakları
Canlı verileri alın:
- "Paris'teki hava durumu nedir?"
- "AAPL için en son hisse fiyatını al"
- "UA123 uçuşunun durumunu kontrol et"
Geliştirme Araçları
Teknik ekipler için:
- "Son derlemenin durumu nedir?"
- "Kimlik doğrulama hataları için GitHub sorunlarımızı ara"
- "Üretim sunucularının sağlığını kontrol et"
MCP Sunucu Örnekleri
Popüler MCP Sunucuları
| Sunucu | Amaç | Bağlantı |
|---|---|---|
| Filesystem | Yerel dosyaları okuma/yazma | Yerleşik referans sunucusu |
| PostgreSQL | Veritabanlarını sorgulama | Topluluk sunucusu |
| GitHub | Repo yönetimi | Topluluk sunucusu |
| Slack | Mesajlaşma entegrasyonu | Topluluk sunucusu |
| Google Drive | Dosya yönetimi | Topluluk sunucusu |
| Brave Search | Web araması | Topluluk sunucusu |
Daha fazlasını bul: Büyüyen topluluk MCP sunucuları listesi için MCP Sunucu Kayıt Defteri sayfasını ziyaret edin.
Kendinize Ait MCP Sunucuları
Aşağıdaki amaçlar için özel MCP sunucuları oluşturabilirsiniz:
- Sahipli dahili sistemler
- Özel iş mantığı
- Güvenli veya özel veri erişimi
Kendi sunucunuzu oluşturmak için herhangi bir MCP SDK'sını (TypeScript, Python) kullanın.
Güvenlik Değerlendirmeleri
Kimlik Doğrulama
Sunucu yapılandırmasında HTTP Başlıkları aracılığıyla kimlik doğrulamayı yapılandırın:
| Yöntem | Başlık Örneği |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Anahtarı | X-API-Key: your-api-key |
| Özel Token | X-Auth-Token: your-token |
Veri Gizliliği
- MCP istekleri kullanıcı konuşma verilerini içerebilir
- MCP sunucunuzun verileri gizlilik politikalarınıza göre işlediğinden emin olun
- Veri ikamet gereksinimlerini dikkate alın
- AI SmartTalk, UI'de hassas başlık değerlerini maskeleyerek gizler
Ağ Güvenliği
- Tüm MCP bağlantıları için HTTPS kullanın
- MCP sunucu erişimini güvenilir IP'lerle sınırlayın
- MCP sunucunuzda hız sınırlaması uygulayın
- Geçerli SSL sertifikalarının mevcut olduğundan emin olun
Sorun Giderme
Bağlantı Sorunları
| Sorun | Çözüm |
|---|---|
| "Bağlantı reddedildi" | Sunucu URL'sini ve portunu kontrol edin. Sunucunun çalıştığından emin olun |
| "Kimlik doğrulama başarısız" (401) | Başlık yapılandırmasında API anahtarınızı veya token'ınızı doğrulayın |
| "Yasak" (403) | Kimlik bilgilerinizin gerekli izinlere sahip olduğundan emin olun |
| "Sunucu bulunamadı" (404) | URL'yi doğrulayın. AI SmartTalk otomatik olarak /mcp ekler |
| "Zaman aşımı" | Ağ bağlantısını ve güvenlik duvarı kurallarını kontrol edin. Testin 10 saniyelik bir zaman aşımı vardır |
| "SSL hatası" | MCP sunucunuzun geçerli bir SSL sertifikasına sahip olduğundan emin olun |
| "Hız sınırlı" (429) | Çok fazla istek. Bekleyin ve tekrar deneyin veya sunucu limitlerini artırın |
Araç Sorunları
| Sorun | Çözüm |
|---|---|
| Araçlar görünmüyor | MCP sunucusunun araçları doğru bir şekilde sunduğunu doğrulayın. Yenileme yapmayı deneyin |
| Yanlış araçlar çağrılıyor | Sunucu adlarının AI'nın doğru seçmesine yardımcı olacak şekilde açıklayıcı olduğundan emin olun |
| Araç çağrısı başarısız | Hatalar için sunucu günlüklerini kontrol edin. Araçların beklenen formatı döndürdüğünden emin olun |
Yaygın Hatalar
/mcp'yi unutmamak: AI SmartTalk bunu otomatik olarak ekler, ancak uç noktanız farklıysa tam yolu ekleyin- Yanlış başlık formatı: Kimlik doğrulama başlıklarının sunucunuzun beklediği ile eşleştiğinden emin olun
- Tekrar eden sunucu adları: Her sunucunun benzersiz bir adı olmalıdır
MCP Sunucularını Yönetme
| Eylem | Nasıl |
|---|---|
| Sunucu ekle | "Sunucu Ekle"ye tıklayın, bilgileri doldurun, test edin ve kaydedin |
| Sunucuyu düzenle | Sunucu kartındaki düzenleme simgesine tıklayın |
| Bağlantıyı test et | Sunucu kartındaki test simgesine tıklayın |
| Sunucuyu sil | Sunucu kartındaki silme simgesine tıklayın |
| Değişiklikleri kaydet | Tüm değişiklikleri kalıcı hale getirmek için "Entegrasyonu Kaydet"e tıklayın |
En İyi Uygulamalar
- Açıklayıcı sunucu adları kullanın: AI'nın hangi sunucuyu sorgulayacağını anlamasına yardımcı olur (örneğin, "Şirket CRM" yerine "Sunucu 1")
- Kaydetmeden önce test edin: Yapılandırma sorunlarını erken yakalamak için her zaman bağlantıları test edin
- Bir sunucu ile başlayın: Daha fazla eklemeden önce bir entegrasyonla rahatlayın
- Kimlik bilgilerinizi güvence altına alın: AI SmartTalk için özel API anahtarları kullanın, kişisel token'lar değil
- Sunucularınızı izleyin: Hangi araçların çağrıldığını ve performanslarını takip edin
- Sunucuları güncel tutun: MCP sunucularınızın en son protokol spesifikasyonunu takip ettiğinden emin olun