MCP Entegrasyonları Nedir?
MCP (Model Context Protocol), asistanlarınıza harici araçlar ve yetenekler eklemenizi sağlayan bir standarttır. Örneğin, asistanınız Google Drive'dan dosya okuyabilir, veritabanı sorguları yapabilir veya başka sistemlerle etkileşime girebilir.
Sayfaya Erişim
- Sol menüden "Entegrasyonlar" seçeneğine tıklayın
MCP Sunucuları
Sunucu Kartları
Her MCP sunucusu için bir kart gösterilir:
- Sunucu Adı: Entegrasyonun adı
- Açıklama: Ne işe yaradığı
- Durum: Aktif veya Pasif
- Araç Sayısı: Kaç araç sağladığı
Sunucu Durumu
- Yeşil işaret: Sunucu aktif ve çalışıyor
- Kırmızı işaret: Sunucu pasif veya hata var
- Sarı işaret: Sunucu yapılandırma bekliyor
MCP Sunucusu Ekleme
Adım 1: Yeni Sunucu Ekle
- Sağ üst köşede "+ Yeni MCP Sunucusu" butonuna tıklayın
- Sunucu ekleme formu açılır
Adım 2: Sunucu Bilgilerini Doldurun
Sunucu Adı
- Entegrasyon için bir isim girin
- Örnek: "Google Drive Entegrasyonu"
Sunucu URL
- MCP sunucusunun adresini girin
- Örnek:
https://mcp-server.example.com
Kimlik Doğrulama
- API Key: Sunucu için API anahtarı girin
- Token: Erişim token'ı (gerekirse)
Açıklama
- Sunucunun ne işe yaradığını yazın
- Hangi araçları sağladığını belirtin
Adım 3: Sunucuyu Test Edin
- "Test Et" butonuna tıklayın
- Sunucuya bağlantı test edilir
- Başarılıysa yeşil onay işareti görünür
Adım 4: Kaydedin
- "Kaydet" butonuna tıklayın
- Sunucu listeye eklenir
MCP Sunucusunu Asistana Bağlama
Adım 1: Asistan Düzenleme
- Sol menüden "Asistanlar" sayfasına gidin
- Asistanınızı seçin
- "MCP Araçları" sekmesine tıklayın
Adım 2: MCP Sunucusu Seçin
- "MCP Sunucusu Ekle" butonuna tıklayın
- Açılır menüden sunucu seçin
- Sunucunun sağladığı araçlar listelenir
Adım 3: Araçları Seçin
- Asistanın kullanacağı araçları işaretleyin
- Her araç için:
- Araç Adı: Ne işe yaradığı
- Açıklama: Nasıl kullanıldığı
- Parametreler: Hangi bilgilere ihtiyaç duyduğu
Adım 4: Kaydedin
- Sayfanın üst kısmındaki "Kaydet" butonuna tıklayın
- Asistan artık seçilen araçları kullanabilir
Örnek MCP Entegrasyonları
1. Google Drive Entegrasyonu
Araçlar:
- Dosya Okuma: Drive'dan dosya içeriğini okur
- Dosya Arama: Drive'da dosya arar
- Dosya Listele: Klasör içeriğini listeler
Kullanım:
- Kullanıcı: "X belgesini oku"
- Asistan Google Drive'dan belgeyi okur ve özetler
2. Veritabanı Entegrasyonu
Araçlar:
- Sorgu Çalıştır: SQL sorgusu çalıştırır
- Veri Getir: Belirli verileri getirir
- Veri Güncelle: Veritabanını günceller
Kullanım:
- Kullanıcı: "Bugünkü siparişleri göster"
- Asistan veritabanından siparişleri çeker ve listeler
3. E-posta Entegrasyonu
Araçlar:
- E-posta Gönder: E-posta gönderir
- E-posta Oku: Gelen kutusu okur
- E-posta Ara: E-posta arar
Kullanım:
- Kullanıcı: "Müşteriye teşekkür e-postası gönder"
- Asistan otomatik e-posta oluşturur ve gönderir
MCP Sunucusu Yönetimi
Sunucu Düzenleme
- Sunucu kartında "Düzenle" butonuna tıklayın
- Bilgileri güncelleyin
- "Kaydet" butonuna tıklayın
Sunucu Silme
- Sunucu kartında "Sil" butonuna tıklayın
- Onay penceresinde "Evet, Sil" butonuna tıklayın
- Sunucu kalıcı olarak silinir
Dikkat: Sunucuyu silerseniz, bu sunucuyu kullanan tüm asistanlar etkilenir!
Sunucu Durumunu Kontrol Etme
- Sunucu kartında "Test Et" butonuna tıklayın
- Bağlantı durumu kontrol edilir
- Sonuç gösterilir (Başarılı/Başarısız)
Sorun Giderme
"Sunucuya Bağlanılamıyor"
Çözüm:
- Sunucu URL'sini kontrol edin
- API anahtarının doğru olduğundan emin olun
- Sunucunun çalıştığını doğrulayın
- Güvenlik duvarı ayarlarını kontrol edin
"Araç Çalışmıyor"
Çözüm:
- Aracın parametrelerini kontrol edin
- Asistan talimatlarında aracı kullanma talimatı verin
- Sunucu loglarını inceleyin
- Test ederek sorunu belirleyin
"Yetki Hatası"
Çözüm:
- API anahtarının geçerli olduğundan emin olun
- Token'ın süresi dolmamış olmalı
- Gerekli izinlerin verildiğini kontrol edin
En İyi Uygulamalar
- Sadece güvendiğiniz MCP sunucularını kullanın
- API anahtarlarını güvenli saklayın
- Sunucu durumunu düzenli kontrol edin
- Gereksiz araçları asistana eklemeyin
- Araç kullanımını test edin
- Hata loglarını takip edin
- Sunucu dokümantasyonunu okuyun
Güvenlik
- MCP sunucuları hassas verilere erişebilir
- Sadece güvenilir kaynaklardan sunucu ekleyin
- API anahtarlarını kimseyle paylaşmayın
- Düzenli olarak erişim loglarını kontrol edin
- Şüpheli aktivite görürseniz sunucuyu devre dışı bırakın
İpuçları
- Her asistana sadece ihtiyaç duyduğu araçları ekleyin
- Araç açıklamalarını net yazın
- Test ortamında önce deneyin
- Performansı düzenli takip edin
- Kullanılmayan sunucuları kaldırın
- Dokümantasyonu güncel tutun