Democruit MCP Hatalarını Giderme ve Erişimi İptal Etme

Başarısız bir Democruit MCP görevini düzeltmek için önce sorunun yetkilendirme, izinler, araç girdisi, ürün kotası veya istek sıklığı kaynaklı olup olmadığını belirleyin. Her biri farklı bir çözüm gerektirir. Yeniden bağlanmak plan kotası eklemez, planınızı yükseltmek de eksik bir izni düzeltmez. Bir istemcinin erişimini durdurmak için Democruit ayarlarını açın, Bağlı aracılar bölümünü bulun ve Erişimi iptal et seçeneğini belirleyin.

1. Adım: Yeniden denemeden önce hatayı okuyun

İstemciyi, istenen aracı, hata mesajını ve görevin daha önce bir sonuç döndürüp döndürmediğini not edin. Sonucu belirsiz olan bir yazma isteğini tekrarlamaktan kaçının. Gecikmiş bir yanıtı başarısız bir değişiklikle karıştırmamak için önce etkilenen belgenin veya işlemin durumunu kontrol edin.

Sonraki adımı belirlemek için bu tabloyu kullanın:

Yeniden denemeden önce kurtarma adımını döndürülen hatayla eşleştirin.

2. Adım: Yetkilendirmeyi geri yükleyin veya izinleri düzeltin

Yetkilendirme eksikse istemcinin OAuth ile oturum açma ve onay akışını tamamlayın. Uç noktanın https://mcp.democruit.com/mcp olduğunu ve istediğiniz hesabı bağladığınızı doğrulayın. Claude, ChatGPT ve Gemini bağlantı kılavuzu her istemcinin kurulumunu açıklar. Gemini CLI'da sunucunun yetkilendirmeye ihtiyacı olduğunda /mcp auth democruit komutunu kullanın ve ardından tarayıcıda oturum açma işlemini tamamlayın.

Erişim belirteçleri bir saat geçerlidir. Yenileme belirteci geçerli olduğu sürece istemci erişimi yenileyebilir. Bu nedenle erişim belirtecinin bir saat geçerli olması, her saat başı oturum açmanız gerektiği anlamına gelmez. offline_access ile yenileme belirteçleri kayan 30 gün ve mutlak 90 gün geçerlidir. Bu kapsam olmadan kayan yedi gün ve mutlak 30 gün geçerlidir.

Yenileme süresi dolmuşsa veya bağlantı iptal edilmişse yeniden yetkilendirme yapın. Yetkilendirme kodları beş dakika geçerlidir. Tamamlanmamış bir kod değişimi sona ererse oturum açma işlemini yeniden başlatın. Yetkilendirme hatasını aşmak için belirteçleri sohbete yapıştırmayın.

FORBIDDEN hatasında aracın gerektirdiği izinleri ve istemciye verilen kapsamları inceleyin. Okuma ve yazma kapsamları ürün alanına göre ayrıdır. Birleşik uygulama kiti iş akışı; özgeçmiş yazma, ön yazı yazma ve ATS yazma izinlerini gerektirir. Daha küçük bir görev için kullanılan bağlantıda bu izinlerin tümü bulunmayabilir. Yalnızca yapmayı planladığınız iş için gereken erişimi isteyin.

3. Adım: Araç girdisini düzeltin

INVALID_ARGUMENTS hatasında asistandan aracın girdi gereksinimlerini incelemesini ve hangi bilgilerin eksik olduğunu belirlemesini isteyin. Seçilen belge referansını, iş tanımını veya istenen diğer bilgileri sağlayın. Asistanın deneyim uydurmasına veya yalnızca belirsiz bir başlığa dayanarak belge seçmesine izin vermeyin.

Eksik girdi bir faturalandırma sorunu değildir. Plan değişikliğini düşünmeden önce gerekli bilgileri tamamlayın. TOOL_EXECUTION_FAILED hatasında döndürülen açıklamayı okuyun ve başka bir yazma işlemi denemeden önce bir belgenin veya bekleyen bir işlemin olup olmadığını doğrulayın.

4. Adım: Ürün kotasını ve yükseltme bağlantısını kontrol edin

Ürün kotası, Democruit planınız kapsamında özellik kullanımını sınırlar. MCP, uygulamayla aynı plan kotalarını kullanır. Bir araç plan sınırı bildirirse hesabınızda ilgili özelliğin kullanımını kontrol edin. Yükseltme kararı vermeden önce mevcut kotaları karşılaştırmak için Democruit fiyatlandırmasını inceleyin.

Özelliklerin kullanılabilirliği ve kotaları mevcut planınıza bağlıdır. Her uygulama özelliğinin bir MCP aracı olduğunu veya yeniden bağlanmanın, belge silmenin ya da bir dakika beklemenin tüketilmiş bir yapay zeka kotasını geri yükleyeceğini varsaymayın.

Örneğin, Claude'u yeniden bağlamak tükenmiş bir ATS kontrol kotasını sıfırlamaz. Nasıl devam edeceğinize karar vermeden önce ATS kullanımınızı ve mevcut planları inceleyin. Yükseltme yaptıktan sonra hesap kullanımınızı kontrol edin ve istediğiniz işlemi bir kez daha deneyin. İşlem hâlâ engelleniyorsa döndürülen hatayla birlikte desteğe başvurun.

5. Adım: Hız sınırına takıldığınızda istekleri azaltın

Standart API hız sınırı, Democruit uygulamasında kullanılan varsayılan sınırla aynı olan dakikada 500 istektir. OAuth kaydı ve belirteç uç noktalarının kendi daha sıkı sınırları vardır. Bu nedenle 500 istek sınırı, hızlı oturum açma tekrarları için tanınan bir kota değildir. Özellikle görev beklerken sık aralıklarla yoklama yapıyorsanız yinelenen istekleri azaltın. HTTP 429, çok fazla istek yapıldığı anlamına gelir. Döndürülen bir yeniden deneme gecikmesi varsa buna uyun ve yeniden denemeden önce istekleri yavaşlatın. Kota veya hız sınırı hatası TOOL_EXECUTION_FAILED içinde de görünebilir. Bu genel hata koduna tek başına güvenmek yerine açıklamayı okuyun.

Hız sınırı penceresinin dolmasını beklemek, tükenmiş bir ürün kotasını yenilemez. Bir bağlantının özellik kotasında hâlâ kullanım hakkı olabilir, ancak istekler yine de fazla hızlı gönderiliyor olabilir. Hatanın hangi sınırı açıkladığını kontrol edin.

Kısaltılmış yanıtlar farklı bir durumdur. Büyük yanıtlar, detail=true kullanılmadığı sürece 20 öğelik gruplar halinde sayfalanır veya özetlenir. Döndürülen sayfalama bilgilerini kullanarak devam edin ya da görev tüm içeriği gerektiriyorsa ayrıntı isteyin. Tek başına kısa bir sayfa, kota hatası olduğuna kanıt değildir.

6. Adım: Bekleyen onayı veya süresi dolmuş yüklemeyi çözün

Yıkıcı araçlar, Democruit kontrol panelinde onay bekler. Döndürülen bağlantıyı açın ve işlemi dikkatlice gözden geçirin. Asistan get_action_status aracını kullanarak durumu kontrol edebilir. Onay hâlâ beklemedeyken silme işleminin tamamlandığını bildirmemelidir.

Bekleyen onay bir hata değildir. Döndürülen onay bağlantısı işlemi Democruit'te açar. Onaylamadan önce hedefi gözden geçirin. Reddedilen bir işlem DENIED, karara bağlanmayan bir işlem ise sonunda EXPIRED durumunu döndürür.

Onay on dakika sonra geçerliliğini yitirir. Süre dolduktan sonra işlemi hâlâ yapmak istiyorsanız yeni bir onay isteği başlatıp tekrar gözden geçirin. Yüklemeler de on dakika geçerlidir ve en fazla 10 MB olabilir. Özgeçmiş içe aktarma ve ATS yükleme amaçları yalnızca PDF kabul eder. Önceki yüklemenin süresi dolarsa yenisini oluşturun ve istenen dosya türünü ve tam dosya boyutunu kullanın.

7. Adım: Bağlantıyı kesip erişimi iptal edin

1. Democruit hesap ayarlarını açın.
2. Bağlı aracılar bölümünde istemciyi bulun ve listelenen kapsamlarını gözden geçirin.
3. Durdurmak istediğiniz bağlantı için Erişimi iptal et seçeneğini belirleyin.
4. İptal işleminin başarıyla tamamlandığını gösteren sonucu bekleyin. Ayarlar sayfasında hata bildirilirse işlemi orada yeniden deneyin veya desteğe başvurun.
5. Araçların sunulmasını veya oturum açma istemlerinin gösterilmesini de durdurmak istiyorsanız yapay zeka istemcinizde Democruit sunucusunu kaldırın veya devre dışı bırakın.
6. Bu istemciyi daha sonra yeniden bağlarsanız yetkilendirme işlemini tamamlayın ve istenen kapsamları tekrar gözden geçirin.

Democruit'te kimlik bilgilerini iptal edin, artık kullanmıyorsanız sunucuyu istemcinizden kaldırın.

Erişimin iptal edilmesi, hesabınız için istemcinin yetkilendirme iznini, erişim belirteçlerini ve yenileme belirteçlerini devre dışı bırakır. İstemci yapılandırmasından sunucu girdisini kaldırmak ayrı bir adımdır. Kimlik bilgilerini geçersiz kılmak için Democruit'teki Erişimi iptal et kontrolünü kullanın.

Erişimi iptal etmek Democruit hesabınızı ve belgelerinizi olduğu gibi bırakır. Bu işlem, ilgili kimlik bilgileriyle gelecekte yetkilendirilmiş isteklerin yapılmasını durdurur. Yapay zeka istemcisinin daha önce aldığı içerikler için o istemcinin geçmişini ve veri kontrollerini inceleyin. Bu iptal, başka bir hizmet için silme veya saklama kuralı oluşturmaz. Democruit'in yayımlanmış veri uygulamaları için Gizlilik Politikası'nı inceleyin.

Görev hâlâ engelleniyorsa

İstemci adınızı, araç adını ve hata mesajını [email protected] adresine gönderin. Oturum açmaya, belge okumaya, değişiklik kaydetmeye veya onay beklemeye çalışıp çalışmadığınızı açıklayın. Destek mesajınıza parolaları, belirteçleri veya özel belge içeriğini eklemeyin.