EduBase

EduBase MCP sunucusu

Bu depo, EduBase platformu için Model Bağlam Protokolü (MCP) sunucusunun uygulamasını içerir. MCP istemcilerinin (örneğin Claude Desktop) ve LLM'lerin EduBase hesabınızla etkileşime girmesine ve sizin adınıza görevler gerçekleştirmesine olanak tanır. stdio, SSE ve akışlı HTTP aktarım protokollerini destekler.

EduBase Nedir?

EduBase, eğitim kurumları veya işletmeler için uygun, öğrenmeyi daha keyifli, basit ve etkileşimli hale getiren yenilikçi, modüler, çevrimiçi bir eğitim platformudur.

Neden EduBase?

EduBase, benzersiz özellik kombinasyonuyla dijital öğrenmede devrim yaratır:

• Gelişmiş Sınav Sistemi: Aynı sorunun sonsuz varyasyonuna izin veren parametrelendirme, gerçek zamanlı kopya tespiti, güzel LaTeX dizgisi, gelişmiş STEM desteği ve otomatik notlandırma
• Birleşik Öğrenme Ortamı: Tüm eğitim içeriğinizi (videolar, sınavlar, belgeler ve SCORM modülleri) sezgisel tek bir sistemde merkezileştirir
• Kurumsal Düzeyde Güvenlik: SSO entegrasyonu, ayrıntılı erişim kontrolleri, kapsamlı denetim ve GDPR uyumluluğu gibi özelliklerle
• Entegrasyon: LTI, kapsamlı API ve özel entegrasyon seçenekleri aracılığıyla mevcut sistemlerinizle
• Yapay Zeka Destekli Araçlar: Mevcut içeriğinizi anında etkileşimli sınavlara ve değerlendirmelere dönüştürebilen veya materyallerinizi bir dilden diğerine çevirebilen EduBase Asistanı gibi

Yükseköğretim kurumlarından kurumsal eğitim departmanlarına kadar EduBase, tüm cihazlarda sezgisel bir kullanıcı deneyimi sunarken özel ihtiyaçlarınızı karşılayacak şekilde ölçeklenir.

Demo videosu

Claude ile işbirliği içinde soru oluşturma ve yükleme, sınav planlama ve kullanıcı sonuçlarını analiz etme:

API kimlik bilgilerinizi edinme

Giriş yaptıktan sonra, Kontrol Panelinizde Entegrasyonlar menüsünü arayın, "entegrasyon ekle"ye tıklayın ve "EduBase API" türünü seçin.

Bu seçeneği görmüyorsanız, MCPGITHUB aktivasyon kodunu girin veya erişim talep etmek için bizimle info@edubase.net adresinden iletişime geçmekten çekinmeyin.

Araçlar

Belgelenen her API uç noktası, edubase_<method>_<endpoint> olarak adlandırılan ayrı bir araç olarak kullanılabilir. Örneğin, GET /user:me uç noktası için araç edubase_get_user_me olarak adlandırılır. Daha fazla bilgi için geliştirici belgelerimize bakın.

Yapılandırma

MCP sunucusu, ortam değişkenleri kullanılarak yapılandırılabilir. Aşağıdaki değişkenler mevcuttur:

Değişken	Açıklama	Gerekli	Varsayılan değer
EDUBASE_API_URL	EduBase API'sinin temel URL'si, büyük olasılıkla https://subdomain.edubase.net/api.	Evet	https://www.edubase.net/api
EDUBASE_API_APP	EduBase üzerindeki entegrasyon uygulamanızın Uygulama Kimliği, EduBase API'sindeki app. Bunu EduBase'deki entegrasyon detayları penceresinde bulabilirsiniz.	Kimlik doğrulamalı HTTP aktarımı kullanılıyorsa gerekli değil, aksi takdirde Evet	-
EDUBASE_API_KEY	EduBase üzerindeki entegrasyon uygulamanızın Gizli anahtarı, EduBase API'sindeki secret. Bunu EduBase'deki entegrasyon detayları penceresinde Uygulama Kimliği ile birlikte bulabilirsiniz.	Kimlik doğrulamalı HTTP aktarımı kullanılıyorsa gerekli değil, aksi takdirde Evet	-
EDUBASE_SSE_MODE	MCP sunucusunu SSE aktarımı ile HTTP modunda başlatır. Değer true olmalıdır.	Hayır	false
EDUBASE_STREAMABLE_HTTP_MODE	MCP sunucusunu akışlı HTTP aktarımı ile HTTP modunda başlatır. Değer true olmalıdır.	Hayır	false
EDUBASE_HTTP_PORT	SSE veya akışlı HTTP aktarım modu kullanılıyorsa, HTTP sunucusu bu portu dinleyecektir.	Hayır	3000
EDUBASE_OAUTH	OAuth 2.1 korumalı kaynak davranışını etkinleştirir: kimlik doğrulanmamış istekler /.well-known/oauth-protected-resource adresini işaret eden 401 + WWW-Authenticate ile reddedilir ve taşıyıcı belirteçler EduBase API'sine iletilir.	Hayır	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	OAuth IdP olarak görev yapan EduBase dağıtımının genel temel URL'si. Korumalı kaynak meta veri belgesinde yetkilendirme sunucusunu duyurmak için kullanılır.	Hayır	EDUBASE_API_URL değerinden türetilir
EDUBASE_OAUTH_RESOURCE_URL	Bu MCP sunucusunun genel temel URL'si (OAuth kaynak göstergesi). WWW-Authenticate başlığında ve kaynak meta verilerinde kullanılır.	Hayır	EDUBASE_API_URL değerinden türetilir
EDUBASE_ALLOW_PRIVATE_NETWORK	Bir HTTP aktarımı kullanıldığında, edubase_filebin aracı özel, geri döngü, bağlantı yerel ve ayrılmış adreslere giden istekleri engeller (SSRF koruması) ve yerel dosya yollarını reddeder. Bunlara izin vermek için true olarak ayarlayın, örn. güvenilir bir özel ağda kendi kendine barındırılan bir dağıtım. Yalnızca yerel kullanıcının çağrı yaptığı stdio modunda etkisi yoktur.	Hayır	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	edubase_filebin yükleme hedefleri olarak izin verilen ana bilgisayar adlarının isteğe bağlı virgülle ayrılmış izin listesi (tam ana bilgisayar veya herhangi bir alt alan adı, örn. edubase.net). Boş olduğunda, herhangi bir genel ana bilgisayara izin verilir (yine de yukarıdaki adres filtrelemesine tabidir).	Hayır	-

Uzak MCP sunucusu olarak kullanım

MCP istemciniz için EduBase MCP sunucusunu uzak bir MCP sunucusu olarak kullanabilirsiniz. Bunu yapmak için, MCP sunucusunu istemcilerin erişebileceği bir yerde barındırmanız ve ardından istemciyi sunucuya bağlanacak şekilde yapılandırmanız gerekir. SSE veya akışlı HTTP aktarım moduyla başlatın ve sunucuya internet üzerinden uzaktan erişirken her zaman HTTPS kullanın!

Uzak sunucularla kimlik doğrulama

Sunucuyu iki modda kullanabilirsiniz:

• İstemci kimlik doğrulaması olmadan: Bu modda, sunucu istemciden herhangi bir kimlik doğrulaması gerektirmez. Bu, test veya geliştirme amaçları için veya kapalı bir ağda kullanışlıdır ancak üretim kullanımı için önerilmez. Bunun için sunucuyu EDUBASE_API_APP ve EDUBASE_API_KEY ile de yapılandırmanız gerekir!
• Taşıyıcı belirteç kimlik doğrulaması ile: Bu modda, sunucu her istekle birlikte bir Taşıyıcı belirteç gönderilmesini gerektirir. Bu, sunucuyu üretimde kullanmanın önerilen yoludur. Taşıyıcı belirteci, bir entegrasyon uygulaması oluşturarak ve Uygulama Kimliği ile Gizli anahtarı {app}:{secret} formatında, base64 kodlanmış bir belirteç olarak sağlayarak EduBase hesabınızdan edinebilirsiniz. Sunucu daha sonra bu belirteci, istemcinin kimliğini doğrulamak ve API uç noktalarına erişimi yetkilendirmek için kullanacaktır.
• OAuth 2.1 ile (IdP olarak EduBase): EDUBASE_OAUTH=true olduğunda, uyumlu istemciler (Claude Desktop, Claude.ai bağlayıcıları, Cursor, ChatGPT bağlayıcıları vb.) /.well-known/oauth-protected-resource aracılığıyla EduBase yetkilendirme sunucusunu keşfeder, kendilerini dinamik olarak kaydeder (RFC 7591), kullanıcıyı bir EduBase onay ekranından geçirir ve opak bir erişim belirteci için bir yetkilendirme kodu (PKCE S256 ile) değiştirir. MCP sunucusu bu belirteci olduğu gibi EduBase API'sine iletir, API de bunu ilk onayda oluşturulan otomatik sağlanan MCP entegrasyonuna çözümler. Kopyalanacak Uygulama Kimliği/Gizli anahtar yok — kullanıcılar istemcilerinde sadece "EduBase'e Bağlan"a tıklar.

Claude Desktop ile Kullanım

Adım adım bir rehber için, EduBase'i Claude ile Bağlama: Eksiksiz MCP Entegrasyon Kılavuzu hakkındaki blog yazımıza bakın.

Sağlanan EduBase MCP sunucusunu kullanma

Sağlanan EduBase MCP sunucusunu (varsa), OAuth kimlik doğrulamasını destekliyorsa istemcinizde https://domain.edubase.net/mcp URL'si (gerçek alan adıyla değiştirin) ile uzak bir sunucu olarak ekleyerek veya Authorization başlığında (Authorization: Bearer ${BASE64_ENCODED_TOKEN}) uygun Taşıyıcı belirteç ile herhangi bir yapılandırma olmadan kullanabilirsiniz.

www.edubase.net kullanıcıları için önerilir, çünkü sunucu tarafımızdan korunur ve güncellenir ve barındırma veya yapılandırma konusunda endişelenmenize gerek kalmaz. İstemcinizi bağlarken doğru URL'yi ve kimlik doğrulama yöntemini kullandığınızdan emin olun.

Manuel kurulum

claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

Node.js kullanarak

MCP sunucusunu çalıştırmadan önce, Node.js'in kurulu olduğundan emin olun. nodejs.org adresinden indirebilir veya brew gibi bir paket yöneticisi kullanabilirsiniz.

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "-y",
        "@edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Veya EduBase MCP sunucusu sürümünü indirin ya da depoyu klonlayın ve sunucuyu oluşturmak için npm run build komutunu çalıştırın. /path/to/dist değerini gerçek dizine ayarlamayı ve ortam değişkenlerini yapılandırmayı unutmayın!

{
  "mcpServers": {
    "edubase": {
      "command": "node",
      "args": [
        "/path/to/dist/index.js"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Docker kullanarak

MCP sunucusunu çalıştırmadan önce, Docker'ın kurulu ve çalışıyor olduğundan emin olun. docker.com adresinden indirebilir veya bir paket yöneticisi kullanabilirsiniz. Ortam değişkenlerini yapılandırmayı unutmayın!

{
  "mcpServers": {
    "edubase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "EDUBASE_API_URL",
        "-e",
        "EDUBASE_API_APP",
        "-e",
        "EDUBASE_API_KEY",
        "edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Uzak MCP sunucusu aracılığıyla kurulum

Sağlanan EduBase MCP sunucusunu (varsa) uzak bir sunucu olarak kullanabilirsiniz. EDUBASE_API_APP ve EDUBASE_API_KEY değerlerinizi Base64 ile kodlamanızı ve Authorization başlığında (Authorization: Bearer ${BASE64_ENCODED_TOKEN}) bir Taşıyıcı belirteç olarak kullanmanızı öneririz.

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://domain.edubase.net/mcp",
        "--header",
        "Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}"
      ]
    }
  }
}

Smithery aracılığıyla kurulum

Claude Desktop için EduBase MCP sunucusunu Smithery aracılığıyla otomatik olarak kurmak için:

npx -y @smithery/cli install @EduBase/MCP --client claude

İletişim

Web sitesi: www.edubase.net
Geliştirici Belgeleri: developer.edubase.net
E-posta: info@edubase.net