Ana içeriğe atla

Kendi MCP-serverinizi ekleme

Kendi MCP-serveriniz ile AI-School’u kendi uygulamanıza, veri kaynağınıza veya özel bir hizmete bağlarsınız. Önce kullanım yerine uygun olan aktarımı seçin.

Doğru aktarımı seçin​

AktarımWebMobilMasaüstüKullanım
Streamable HTTPEvetEvetEvetBarındırılan sunucular için önerilir
stdioHayırHayırEvetYerel süreçler ve masaüstü entegrasyonları
SSEYalnızca mevcut yapılandırmalarYalnızca mevcut yapılandırmalarEvetEski aktarım; yeni sunucular için Streamable HTTP seçin

Streamable HTTP için gereksinimler​

MCP yolunu da içeren tam genel endpoint’i kullanın; örneğin:

https://mcp.example.nl/mcp

Endpoint şunları yapmalıdır:

  • HTTPS kullanmalı;
  • URL’de kullanıcı adı veya parola olmadan çalışmalı;
  • yeniden yönlendirme gerektirmemeli;
  • genel DNS üzerinden erişilebilir olmalı;
  • geçerli bir MCP initialize el sıkışmasına yanıt vermeli;
  • açıkça belirlenmiş bir izinli araçlar kümesine sahip olmalı.

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

Sunucu ekleme​

  1. Tercihler → Araçlar öğesini açın.
  2. Araç ekle veya MCP-server ekle öğesini seçin. Bu düğmeyi yalnızca MCP erişiminiz varsa görürsünüz.
  3. Önce mevcut preset’leri inceleyin.
  4. Kendi MCP-server’ınızı ekleyin seçeneğini seçin.
  5. Adı, tam endpoint’i ve kimlik doğrulama yöntemini girin.
  6. Yapılandırmayı 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 de bir sunucu kaydedebilir.

Kimlik doğrulama ve secret’lar​

AI-School, connector-OAuth ve statik secret’ları destekler. OAuth token’ları, yenileme 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 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​

Yalnızca kullanıcıların gerçekten ihtiyaç duyduğu araçlara izin verin. Bir MCP-server 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ındaki allowlist ile filtreler; ancak uygun kapsamlar ve yetkilendirmeden sunucu yöneticisi sorumludur.

Yerel test​

Yerel bir stdio-server’ı masaüstü uygulamasında test edersiniz. Renderer rastgele shell komutları başlatamaz: kurulum, onaylı bir preset veya güvenli masaüstü akışı üzerinden yapılır. Komut, bağımsız değişkenler, environment key’leri ve istenen erişim, kurulumdan önce gösterilir.

Sorun giderme​

  • Endpoint’e ulaşılamıyor: HTTPS, DNS, firewall ve tam /mcp yolunu kontrol edin.
  • Yeniden bağlanma gerekiyor: OAuth iznini veya kayıtlı secret’ı yenileyin.
  • Başka bir ortama ait: connector’ı mevcut ortam içinde yeniden kaydedin.
  • Araçlar görünmüyor: araç allowlist’ini, MCP erişiminizi ve sunucunun etkin olduğunu 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: 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. Bir MCP aracındaki hata, o sunucudaki tüm araçların erişilemez olduğu anlamına gelmez.

Bu sayfada