MCP Sunucuları
AI SmartTalk'a Model Context Protocol (MCP) kullanarak harici araçlar ve hizmetler bağlayın. MCP, AI asistanlarının harici sistemlerle birleşik bir arayüz üzerinden 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ı açığa çıkarın AI'nın konuşmalar sırasında çağırması için
- Harici verilere erişin standartlaştırılmış protokoller aracılığıyla
- Yetenekleri genişletin özel geliştirme olmadan
MCP nedir? Model Context Protocol, AI sistemlerinin harici 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).
Ön Koşullar
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 açığa çıkardığı araçlar hakkında bilgi
MCP Nasıl Çalışır
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Kullanıcı Sorgusu │────▶│ AI SmartTalk │────▶│ MCP Sunucu │
│ │ │ (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ı, harici veri gerektiren bir soru sorar
- AI SmartTalk, bir MCP aracına ihtiyaç duyduğunu tanır
- MCP sunucusu, uygun araçla ç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 butonuna 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 butonuna tıklayın
- AI SmartTalk MCP sunucusuna ping atacak
- Durumun Bağlı olduğunu 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ı arama | query, limit |
create_ticket | Destek bileti oluşturma | title, description |
get_weather | Hava durumu verilerini alma | location |
Adım 5: Araçları AI'nız için Etkinleştirme
- Keşfedilen araçları gözden geçirin
- AI'nızın kullanmasını istediğiniz araçları Etkinleştirin
- Herhangi bir araç özel ayarını 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 sorusuna yanıt ver
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 bileti var?"
İç 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"
Dış 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ı bul: 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 Dikkat Edilmesi Gerekenler
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çların sunucu tarafında etkin olduğunu kontrol edin |
| "Şema uyuşmazlığı" | 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çları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 butonu (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, sonra genişletin
- Araçları belgeleyin: Her aracın ne yaptığını içeren iç belgeleri 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