Kendi MCP sunucusu ekleme
Kendi MCP sunucunuzla AI-Corporate’ı dahili bir uygulamaya, veri kaynağına veya özel bir hizmete bağlarsınız. Önce kullanım yerine uygun taşıma türünü seçin.
Doğru taşıma türünü seçin
| Taşıma | Web | Mobil | Masaüstü | Kullanım |
|---|---|---|---|---|
| Streamable HTTP | Evet | Evet | Evet | Barındırılan sunucular için önerilir |
| stdio | Hayır | Hayır | Evet | Yerel işlemler ve masaüstü entegrasyonları |
| SSE | Yalnızca mevcut yapılandırmalar | Yalnızca mevcut yapılandırmalar | Evet | Eski taşıma türü; yeni sunucular için Streamable HTTP seçin |
Streamable HTTP için gereksinimler
MCP yolunu da içeren tam genel uç noktayı kullanın, örneğin:
https://mcp.example.com/mcp
Uç nokta HTTPS kullanmalı, yönlendirme olmadan genel DNS üzerinden erişilebilir olmalı ve geçerli bir MCP initialize el sıkışmasına yanıt vermelidir. Kullanıcı adları ve şifreler URL’de yer almamalıdır. Yerel adresler, özel ağ adresleri ve bulut metadata uç noktaları engellenir.
Bir sunucu ekleme
- Tercihler → Araçlar bölümünü açın.
- Araç ekle veya MCP sunucusu ekle seçin. Bu düğmeyi yalnızca MCP erişiminiz varsa görürsünüz.
- Kullanılabilir kurumsal ön ayarları inceleyin.
- Kendi MCP sunucumu ekle seçin.
- Adı, tam uç noktayı ve kimlik doğrulama yöntemini girin.
- Yapılandırmayı kaydedin ve bağlantı kontrolünü bekleyin.
- Sunucuyu varsayılan araç setiniz için etkinleştirin.
Bir yönetici, Yönetim → Araçlar → MCP üzerinden tüm ortam için bir sunucu kaydedebilir.
Kimlik doğrulama ve secret’lar
AI-Corporate, connector-OAuth ve statik secret’ları destekler. OAuth token’ları, refresh token’lar, API anahtarları ve şifreler yalnızca sunucu tarafı depolamada tutulur. Bir sohbet yalnızca kayıtlı connectorId değerini alır, gizli yapılandırmayı asla almaz.
Değişen bir URL veya kimlik doğrulama durumunda yeni yapılandırma önce yeniden doğrulanır. Bu kontrol başarısız olursa, sorun çözülene kadar daha önce onaylanmış bir yapılandırma etkin kalabilir.
Araç izinleri ve yönetişim
Yalnızca çalışanların gerçekten ihtiyaç duyduğu araçları açın. Bir MCP sunucusu hem okuma hem de yazma işlemleri sunabilir. AI-Corporate, keşfedilen araçları sunucu tarafı bir allowlist ile filtreler ve her kullanımda tenant, sahip ve rol kontrolü yapar. Kurum, kaynak sistemde uygun kapsamlar, günlükleme, saklama süreleri ve yetkilendirmeden sorumludur.
Yerel masaüstü sunucuları
Yerel bir stdio sunucusunu masaüstü uygulamasına kurarsınız. Renderer rastgele shell komutları başlatamaz: command, argümanlar, environment keys ve istenen erişim sınırlandırılır ve onaydan önce gösterilir. Secret’lar yerel olarak şifrelenir.
Sorun giderme
- Uç noktaya ulaşılamıyor: HTTPS, DNS, firewall ve tam
/mcpyolunu kontrol edin. - Yeniden bağlanma gerekiyor: OAuth iznini veya kayıtlı secret’ı yenileyin.
- Başka bir ortama ait: connector’ı geçerli ortam içinde yeniden kaydedin.
- Araçlar görünmüyor: allowlist, rol erişimi ve etkin durumu kontrol edin.
- Yalnızca masaüstünde çalışıyor: büyük olasılıkla sunucu stdio veya yerel bir adres kullanıyordur.
Geliştirme kaynakları
Ayrıca bakın
Düzenleme sırasında kayıtlı sunucu yapılandırması alınır. Saklanan anahtar gizli kalır: onu korumak için anahtar alanını boş bırakın. Farklı bir URL veya kimlik doğrulama yöntemi kullanıldığında yeniden bağlama gerekir. Tek bir MCP aracındaki bir hata, o sunucudaki tüm araçların erişilemez olduğu anlamına gelmez.