MCP Sunucuları
Dış araçları ve hizmetleri AI SmartTalk ile Model Context Protocol (MCP) kullanarak bağlayın. MCP, AI asistanlarını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:
- Bağlanın herhangi bir MCP uyumlu sunucuya
- Araçları AI'nın konuşmalar sırasında çağırması için açığa çıkarın
- Dış verilere standartlaştırılmış protokoller aracılığıyla erişin
- Yetenekleri özel geliştirme olmadan genişletin
MCP nedir? Model Context Protocol, AI sistemlerinin güvenli bir şekilde dış veri kaynaklarına ve araçlara bağlanmasına olanak tanıyan açık bir standarttır (Anthropic tarafından geliştirilmiştir).
Gereksinimler
Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:
- Aktif bir AI SmartTalk hesabı
- Bir MCP sunucusuna erişim (kendi barındırdığınız veya üçüncü taraf)
- MCP sunucu URL'si ve kimlik doğrulama bilgileri
- MCP sunucusunun hangi araçları sunduğunu anlama
MCP Nasıl Çalışır
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Kullanıcı Sorgusu │────▶│ AI SmartTalk │────▶│ MCP Sunucusu │
│ │ │ (AI Ajanı) │ │ │
│ "CRM'imi kontrol et" │ │ │ │ - CRM araçları │
│ │◀────│ Sorguyu işler │◀────│ - DB sorguları │
│ Yanıt │ │ MCP araçlarını çağırır │ - Dosya erişimi │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- Kullanıcı, dış verileri gerektiren bir soru sorar
- AI SmartTalk, bir MCP aracına ihtiyaç duyduğunu tanır
- MCP sunucusu, uygun araç ile çağrılır
- Yanıt döner ve AI cevap oluşturur
Adım Adım Kurulum
Adım 1: MCP Entegrasyonuna Erişim
- AI SmartTalk hesabınıza giriş yapın
- Ayarlar → Entegrasyonlar bölümüne gidin
- MCP Sunucuları'nı bulun ve Sunucu Ekle'ye tıklayın
Adım 2: MCP Sunucusunu Yapılandırma
MCP sunucu bilgilerinizi girin:
| Alan | Açıklama |
|---|---|
| Sunucu Adı | Bu bağlantı için dostça bir ad |
| Sunucu URL'si | MCP sunucu uç noktası (örneğin, https://mcp.example.com) |
| Taşıma | SSE (Sunucu Tarafından Gönderilen Olaylar) veya WebSocket |
| Kimlik Doğrulama | API anahtarı, OAuth veya yok |
Adım 3: Bağlantıyı Test Etme
- Bağlantıyı Test Et'e tıklayın
- AI SmartTalk MCP sunucusunu ping atacak
- Durumun Bağlı olarak gösterildiğini doğrulayın
Adım 4: Mevcut Araçları Keşfetme
Bağlandıktan sonra, AI SmartTalk mevcut araçların listesini alır:
| Araç | Açıklama | Parametreler |
|---|---|---|
search_crm | Müşteri kayıtlarını arayın | query, limit |
create_ticket | Destek talebi oluşturun | title, description |
get_weather | Hava durumu verilerini alın | location |
Adım 5: Araçları AI'niz için Etkinleştirin
- Keşfedilen araçları gözden geçirin
- AI'nizin kullanmasını istediğiniz araçları Etkinleştir'in
- Herhangi bir araç-spesifik ayarları Yapılandırın
- Yapılandırmanızı Kaydedin
SmartFlow Entegrasyonu
MCP araçları, SmartFlow iş akışlarında da kullanılabilir:
Akışlarda MCP Araçlarını Kullanma
- SmartFlow'da, eylem kütüphanesinde MCP'yi bulun
- MCP eylemini akışınıza sürükleyin
- MCP Sunucusu ve Araç'ı seçin
- Akış bağlamınızdan giriş parametrelerini eşleyin
- Araç yanıtını sonraki eylemlerde kullanın
Örnek: Müşteri Arama Akışı
Trigger: Chat Service (kullanıcı hesap hakkında sorduğunda)
Actions:
1. MCP Araç Çağrısı:
Sunucu: Şirket CRM
Araç: search_crm
Parametreler:
query: {{user_email}}
2. AI Yanıtı:
Bağlam: CRM arama sonucu
İstem: Kullanıcının hesap sorusunu yanıtlayın
Kullanım Senaryoları
Müşteri İlişkileri Yönetimi
CRM'inizi MCP üzerinden bağlayın:
- "Müşteri John Smith'i ara"
- "Hesap #12345'in durumu nedir?"
- "Kaç tane açık destek talebimiz var?"
Dahili Araçlar
Şirket sistemlerine erişim:
- "Ürün SKU-123 için envanteri kontrol et"
- "Yarın için programda ne var?"
- "İç wiki'mizde oryantasyon belgelerini ara"
Harici Veri Kaynakları
Canlı verileri alın:
- "Paris'teki güncel 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 |
Daha fazlasını bulun: Topluluk sunucuları için MCP Sunucu Kaydı sayfasını ziyaret edin.
Kendinize Ait MCP Sunucuları
Aşağıdakiler için özel MCP sunucuları oluşturabilirsiniz:
- Özel dahili sistemler
- Özel iş mantığı
- Güvenli/özel veri erişimi
Güvenlik Hususları
Kimlik Doğrulama
| Yöntem | Kullan ım Durumu |
|---|---|
| API Anahtarı | Basit sunucu-arası kimlik doğrulama |
| OAuth 2.0 | Kullanıcı-delege erişimi |
| mTLS | Yüksek güvenlikli ortamlar |
Veri Gizliliği
- MCP istekleri kullanıcı verileri içerebilir
- MCP sunucunuzun verileri uygun şekilde işlediğinden emin olun
- Veri ikamet gereksinimlerini göz önünde bulundurun
- MCP araç çağrılarını kaydedin ve denetleyin
Ağ Güvenliği
- Tüm MCP bağlantıları için HTTPS kullanın
- MCP sunucu erişimini AI SmartTalk IP'leri ile sınırlayın
- MCP sunucunuzda oran sınırlaması uygulayın
Sorun Giderme
Bağlantı Sorunları
| Sorun | Çözüm |
|---|---|
| "Bağlantı reddedildi" | Sunucu URL'sini ve portunu kontrol edin |
| "Kimlik doğrulama başarısız" | Kimlik bilgilerini/API anahtarını doğrulayın |
| "Zaman aşımı" | Ağ bağlantısını, güvenlik duvarı kurallarını kontrol edin |
| "SSL hatası" | Geçerli bir SSL sertifikası olduğundan emin olun |
Araç Keşif Sorunları
| Sorun | Çözüm |
|---|---|
| "Hiçbir araç bulunamadı" | MCP sunucusunun araçları doğru şekilde sunduğunu doğrulayın |
| "Araç mevcut değil" | Araçın sunucu tarafında etkin olduğunu kontrol edin |
| "Şema uyumsuzluğu" | Araç şemalarını yenilemek için AI SmartTalk'ı güncelleyin |
Çalışma Zamanı Sorunları
| Sorun | Çözüm |
|---|---|
| "Araç çağrısı başarısız" | Hatalar için sunucu günlüklerini kontrol edin |
| "Beklenmedik yanıt" | Araçın beklenen formatı döndürdüğünü doğrulayın |
| "Oran sınırlı" | Geri çekilme uygulayın veya limitleri artırın |
MCP Sunucularını Yönetme
| Eylem | Nasıl |
|---|---|
| Sunucu ekle | Ayarlar → Entegrasyonlar → MCP → Sunucu Ekle |
| Sunucuyu düzenle | Değiştirmek için sunucu adına tıklayın |
| Sunucuyu devre dışı bırak | Silmeden kapatın |
| Sunucuyu kaldır | Silme düğmesi (araçlar kullanılamaz hale gelir) |
| Araçları yenile | Araçları yeniden keşfetmek için Yenile'ye tıklayın |
En İyi Uygulamalar
- Basit başlayın: Bir sunucu bağlayın, kapsamlı test edin, ardından genişletin
- Araçları belgeleyin: Her aracın ne yaptığını içeren iç belgeler tutun
- Kullanımı izleyin: Hangi araçların çağrıldığını ve performansı takip edin
- Hataları nazikçe yönetin: AI, araç hatalarını zarif bir şekilde ele almalıdır
- Kimlik bilgilerini güvence altına alın: Sabit anahtarlar yerine ortam değişkenleri kullanın
- Sunucularınızı sürümlendirin: MCP sunucuları, istikrar için sürümlendirilmelidir