Ana içeriğe atla

Kendi MCP Sunucunuzu Eklemek

Kendi MCP sunucunuzla AI-School'u kendi uygulamanıza, veri kaynağınıza veya özel bir hizmete bağlayabilirsiniz. Öncelikle kullanım yerine uygun taşıma yöntemini seçin.

Doğru Taşıma Yöntemini Seçin​

TaşımaWebMobilMasaüstüKullanım
Streamable HTTPEvetEvetEvetBarındırılan sunucular için önerilir
stdioHayırHayırEvetYerel süreçler ve masaüstü entegrasyonları
SSESadece mevcut konfigürasyonlarSadece mevcut konfigürasyonlarEvetEski taşıma yöntemi; yeni sunucular için Streamable HTTP tercih edin

Streamable HTTP Gereksinimleri​

Tam genel endpoint'i, MCP yoluyla birlikte kullanın, örneğin:

https://mcp.example.nl/mcp

Endpoint şunları sağlamalıdır:

  • HTTPS kullanmalı;
  • URL'de kullanıcı adı veya şifre olmadan çalışmalı;
  • yönlendirme gerektirmemeli;
  • genel DNS üzerinden erişilebilir olmalı;
  • geçerli bir MCP initialize el sıkışmasını yanıtlamalı;
  • açıkça izin verilen araçlar setine sahip olmalı.

Yerel adresler, özel ağ adresleri ve bulut meta veri endpoint'leri engellenir. Bu nedenle, localhost üzerindeki bir sunucuyu web uygulamasından kaydedemezsiniz.

Bir Sunucu Eklemek​

  1. Tercihler → Araçlar bölümünü açın.
  2. Araç ekle veya MCP sunucusu ekle seçeneğini seçin.
  3. Öncelikle mevcut ön ayarları inceleyin.
  4. Kendi MCP sunucunuzu ekleyin seçeneğini seçin.
  5. İsim, tam endpoint ve kimlik doğrulama yöntemini girin.
  6. Konfigürasyonu kaydedin ve bağlantı kontrolünü bekleyin.
  7. Sunucuyu varsayılan araç setiniz için etkinleştirin.

Bir yönetici, Yönetim → AI Ayarları → Araçlar → MCP üzerinden tüm ortam için bir sunucu kaydedebilir.

Kimlik Doğrulama ve Gizli Bilgiler​

AI-School, connector-OAuth ve statik gizli anahtarları destekler. OAuth tokenları, yenileme tokenları, API anahtarları ve şifreler sadece sunucu tarafında saklanır. Bir sohbet yalnızca kayıtlı connectorId'yi alır, gizli konfigürasyon asla paylaşılmaz.

URL veya kimlik doğrulama değiştiğinde, yeni konfigürasyon önce yeniden kontrol edilir. Bu kontrol başarısız olursa, önceki onaylanmış konfigürasyon sorun çözülene kadar aktif kalabilir.

Araç İzinleri​

Kullanıcıların gerçekten ihtiyaç duyduğu araçları serbest bırakın. Bir MCP sunucusu, dosya silme, e-posta gönderme veya kayıtları değiştirme gibi okuma ve yazma işlemleri sunabilir. AI-School, keşfedilen araçları sunucu tarafı izin listesiyle filtreler, ancak sunucu yöneticisi uygun kapsamlar ve yetkilendirmeden sorumludur.

Yerel Test​

Yerel bir stdio sunucusunu masaüstü uygulamasında test edebilirsiniz. Renderer rastgele shell komutları başlatamaz: kurulum onaylanmış bir ön ayar veya güvenli masaüstü akışı ile yapılır. Komut, argümanlar, ortam değişkenleri ve istenen erişim kurulumdan önce gösterilir.

Sorun Giderme​

  • Endpoint erişilemiyor: HTTPS, DNS, güvenlik duvarı ve tam /mcp yolunu kontrol edin.
  • Yeniden bağlanma gerekiyor: OAuth izinlerini veya kayıtlı gizli anahtarı yenileyin.
  • Başka bir ortama ait: Connector'ü mevcut ortamda yeniden kaydedin.
  • Araçlar görünmüyor: Araç izin listesini, MCP erişiminizi ve sunucunun aktif olup olmadığını kontrol edin.
  • Sadece masaüstünde çalışıyor: Muhtemelen sunucu stdio veya yerel adres kullanıyor.

Geliştirici Kaynakları​

Ayrıca Bakınız​

WhatsApp