Bir asistan bağlama
MCP sunucusunu yapay zekâ istemcinize ekleyin, beş izin grubu arasından nelere erişebileceğini seçin ve işiniz bittiğinde iptal edin.
Read Frog web uygulamasındaki MCP sayfasını açın. Sunucu adresini, istemciye göre kurulum adımlarını ve hâlihazırda yetkilendirdiğiniz her istemciyi gösterir.
Sunucu adresi herkes için aynıdır:
https://api.readfrog.app/api/mcpİstemciler arasında değişen tek şey bu adresi nereye yapıştırdığınız ve istemcinin sizi bırakmadan önce neyi zorunlu tuttuğudur.
Sunucuyu ekleme
Yukarıdaki adreste, Streamable HTTP üzerinden uzak bir MCP sunucusu ekleyin. ChatGPT'de bu, geliştirici kipi açıkken Ayarlar → Eklentiler altındadır; Claude'da Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle altında. Codex ve Claude Code'un her biri tek bir komut alır, komutlar MCP sayfasında gösterilir.
OAuth 2.1 yetkilendirmesini seçin. Dinamik istemci kaydı ve istemci kimliği meta veri
belgeleri desteklenir, dolayısıyla girilecek bir istemci kimliği ya da parolası yoktur. Keşif
belgesinde ısrar eden istemciler bunu
https://api.readfrog.app/.well-known/oauth-protected-resource/api/mcp adresinden okuyabilir.
İstemci sizi Read Frog'un onay sayfasına gönderir. Oturum açın, orada gösterilen uygulama adını ve tanımlayıcısını denetleyin, istediği her izin grubu için bir düzey seçin ve İzin ver'i seçin.
Bazı istemciler özel bağlayıcıları kendi planlarının arkasına koyar. ChatGPT ücretli bir plan ister; kişisel bir Claude hesabı Pro ya da Max ister, Team veya Enterprise'da ise bağlayıcıyı bir sahip kuruluş ayarları altından ekler. Codex ve Claude Code'da böyle bir kısıt yoktur.
Read Frog'un kendi koşulu Ultra planıdır. Bu plan olmayan bir hesaptan gelen bağlantı yetkilendirmeyi tamamlar, ardından her araç çağrısını bir açıklamayla reddeder — yeniden oturum açmak bunu değiştirmez, çünkü hiçbir izin ataması bir aboneliği değiştirmez.
Beş izin grubu
Tam olarak beş grup vardır. account salt okunurdur; diğer dördünün her biri erişim yok, okuma ya da okuma ve yazma olarak ayarlanabilir. Seçimi grup başına ve yalnızca istemcinin gerçekten istediği gruplar arasında yaparsınız.
| Grup | Okuma, asistanın şunu görmesini sağlar | Yazma ek olarak şunu sağlar |
|---|---|---|
account | Adınız, e-posta adresiniz ve profil fotoğrafınız. Not içeriği asla dâhil değildir. | Hiçbir şey — bu grubun yazma düzeyi yoktur. |
notebases | Notebase'leriniz ve alan tanımları, alan kimlikleri dahil. | Notebase oluşturmak, yeniden adlandırmak ve silmek; alan eklemek, değiştirmek ve silmek. |
notes | Her notun alan değerleri ve bunlar arasında arama. | Not oluşturmak, düzenlemek ve silmek. |
card_templates | Kartları üreten ön ve arka yüz kalıpları. | Şablon oluşturmak, düzenlemek ve silmek. |
study | Tekrar geçmişi, program durumu, kuyruk sayıları ve günlük sınırlar. | Tekrar kaydetmek ve geri almak, günlük sınırları değiştirmek, kartları askıya almak ve bugün için atlamak. |
İki araç grupların arasında durur. Gösterilmiş bir kartı okumak — ön yüzü, arka yüzü, öğrenme durumu — notes:read ve study:read izinlerini birlikte gerektirir, çünkü bir kart not içeriği artı program durumudur. Yalnızca birini vermek list_cards ve get_card araçlarını kullanılamaz bırakır.
Bir yazma izni neyi yok edebilir
Yazma yalnızca "bir şey ekleyebilir" demek değildir. Her grubun yazma düzeyi silmeyi de içerir ve bir Notebase'de silme işlemi zincirleme gider.
| Verdiğiniz izin | En kötü durum |
|---|---|
notes:write | Bir not, ondan üretilen her kart ve o kartların tekrar kayıtlarıyla birlikte kalıcı olarak silinir. |
notebases:write | Bir Notebase'in tamamı kalıcı olarak silinir — alanları, bütün notları, şablonları, kartları ve tüm tekrar geçmişi. |
card_templates:write | Bir şablon silinir, onunla birlikte ürettiği her kart ve bunların tekrar kayıtları da silinir. Kaynak notlar hayatta kalır. |
study:write | Yapmadığınız bir tekrar kaydedilir. FSRS bunu gerçek sayar, dolayısıyla kartın kararlılığı, güçlüğü ve sonraki vade tarihi hep kayar. |
Bunların hiçbiri Read Frog tarafından geri alınamaz. undo_review bir kartın en son tekrarını geri alır, ama silinmiş bir not, alan, şablon ya da Notebase için geri alma yoktur.
Önce okuma izni verin. Salt okuma erişimi, bir şeylere bakmayı, neyi tekrar edeceğinizi planlamayı ve ilerlemenizi raporlamayı hâlihazırda kapsar — ve hiçbir şeyi yitiremez. Bir grubu yazmaya yalnızca buna ihtiyaç duyan belirli bir kullanım örneğiniz olduğunda yükseltin ve bir silmeyi onaylamadan önce asistanınızın önerdiğini okuyun.
Sonradan izin ekleme
Bir izin ataması yalnızca belirli bir yetkilendirme isteğinin istediklerini, sizin onlar için seçtiğiniz düzeyde içerir. Bağlantıda bir izin eksik olduğu için bir araç başarısız olursa, istemciye hangi izne ihtiyaç duyduğu söylenir; birçok istemci sizi kendiliğinden yeniden onay akışına gönderir, bazılarının yeniden sorabilmesi için elle yeniden bağlanması gerekir.
Tersi de işler: yeniden yetkilendirin ve bir grubu düşürün. Onay sayfası yalnızca yeni isteğin andığı grupları düşürebilir, dolayısıyla istemcinin artık sormadığı bir izin olduğu gibi kalır. Her şeyi bir kerede temizlemek için bağlantıyı iptal edin.
Yönetme ve iptal etme
MCP sayfası, bağlı her istemciyi kaydettiği adla, uygulama tanımlayıcısıyla, ne zaman bağladığınızla, en son ne zaman yetkilendirdiğiyle ve şu anda taşıdığı izinlerle listeler.
İptal et, o istemcinin izinlerini siler ve erişimini hemen geçersiz kılar. Yenileme jetonu da izin atamasıyla birlikte gider, bu yüzden bir dahaki yeniden bağlanma denemesinde istemci yeniden onay sayfasına düşer ve orada yeniden siz karar verirsiniz. Aynı istemciyi sonradan yeniden bağlayabilirsiniz; yeni bir izin ataması sıfırdan başlar.
İptal etmek geriye dönük çalışmaz. Bir hizmetin daha önce aldığı içerik o hizmette kalır — Read Frog'un verileri nasıl işlediği için bkz. Gizlilik Politikası. Bağlayıcıyı asistanın içinden de kaldırmak yararlıdır, ama bu tek başına Read Frog tarafındaki izin atamasını iptal etmez.
Bir şey çalışmadığında
- Bir araç daha fazla izne ihtiyaç duyduğunu söylüyor. O grubu yetkilendirin ya da reddedilmiş bırakıp izin verdiğiniz işlemlerin içinde kalın. İstemci kendiliğinden yeniden sormuyorsa yeniden bağlayın.
- Her şey bağlanıyor ama her araç bir plan iletisiyle reddediyor. Hesap Ultra planında değil.
- Yeni araçlar görünmüyor. Bağlayıcıyı yenileyin ya da yeniden bağlayın; istemciler araç listesini önbelleğe alır.
- Bir yazma, notun değiştiğini söyleyerek başarısız oluyor. Düzenlemeler eski veriye karşı korumalıdır. Asistandan notu yeniden okuyup yeniden denemesini isteyin.
- Bir tekrar, saat dilimi sorarak başarısız oluyor. Bir tekrarı kaydetmek, onun hangi çalışma gününe ait olduğuna karar verir; bu yüzden tahmin yürütmez. Asistana IANA saat diliminizi söyleyin ya da oturum açık hâlde Read Frog web uygulamasını bir kez açın, böylece hesabınız onu saklar.
Sıkıştıysanız bize ulaşın.