Kendi bir MCP-server ekleme
Kendi bir MCP-server ile AI-Public’i bir vaka sistemine, arşive, veri kaynağına veya başka uzmanlaşmış 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 süreçler 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.organisatie.nl/mcp
Uç nokta HTTPS kullanmalı, genel DNS üzerinden yönlendirme olmadan erişilebilir olmalı ve geçerli bir MCP initialize el sıkışmasına yanıt vermelidir. Kullanıcı adları ve parolalar URL’de yer almamalıdır. Yerel adresler, özel ağ adresleri ve bulut metadata uç noktaları engellenir.
Bir sunucu ekleme
- Tercihler → Tools bölümünü açın.
- Tools toevoegen veya MCP-server toevoegen seçin. Bu düğmeyi yalnızca MCP erişiminiz varsa görürsünüz.
- Kullanılabilir ön ayarları inceleyin.
- Zelf een MCP-server toevoegen 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, Beheer → Tools → MCP üzerinden tüm ortam için bir sunucu kaydedebilir.
Kimlik doğrulama ve secret’lar
AI-Public, connector-OAuth ve statik secret’ları destekler. OAuth token’ları, refresh token’lar, API anahtarları ve parolalar yalnızca sunucu tarafı depolamada tutulur. Bir sohbet yalnızca kayıtlı connectorId değerini alır; gizli yapılandırmayı asla almaz.
URL veya kimlik doğrulama değiştiğinde, yeni yapılandırma önce yeniden kontrol edilir. Bu kontrol başarısız olursa, sorun çözülene kadar daha önce onaylanmış bir yapılandırma aktif kalabilir.
Araç izinleri ve bilgi güvenliği
Yalnızca kullanıcıların gerçekten ihtiyaç duyduğu araçları açın. Bir MCP-server hem okuma hem yazma işlemleri sunabilir. AI-Public, keşfedilen araçları sunucu tarafı bir allowlist ile filtreler ve her kullanımda ortamı, sahibini ve rolü kontrol eder. Kurum, kaynak sistemde uygun kapsamlar, kayıt tutma süreleri ve yetkilendirmeden sorumludur.
Yerel masaüstü sunucuları
Yerel bir stdio sunucusunu masaüstü uygulamasına kurarsınız. Komut, argümanlar, environmentkeys ve istenen erişim sınırlandırılır ve onaydan önce gösterilir. Secret’lar yerel olarak şifrelenir.
Sorun giderme
- Uç nokta erişilemiyor: HTTPS, DNS, güvenlik duvarı ve tam
/mcpyolunu kontrol edin. - Yeniden bağlanma gerekli: OAuth iznini veya kaydedilmiş secret’ı yenileyin.
- Başka bir ortama ait: connector’ü mevcut ortam içinde yeniden kaydedin.
- Araçlar görünmüyor: allowlist’i, rol erişimini ve aktif 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üzenlerken kayıtlı sunucu yapılandırması alınır. Kaydedilen anahtar gizli kalır: onu korumak için anahtar alanını boş bırakın. Farklı bir URL veya kimlik doğrulama yöntemi varsa yeniden bağlama gerekir. Bir MCP aracındaki hata, o sunucudaki tüm araçların erişilemez olduğu anlamına gelmez.