Bu makale, asistanınız Teamso'ya bağlanamadığında ya da bir işlemi yapamadığında ne yapacağınızı anlatır. Asistan, Teamso'dan gelen hatayı genellikle açıklamasıyla birlikte size iletir; hata metninin sonunda HTTP durumu ve Teamso hata kodu (ör. OTP_NOT_DONE) yer alır.

Belirti: 401 Unauthorized; asistan Teamso'ya hiç bağlanamıyor ya da çalışırken bağlantı kesildi.
​Neden: Token yanlış yazılmış, süresi dolmuş ya da iptal edilmiş; veya kullanıcı pasife alınmış ya da başka bir şirkete geçmiş.
​Çözüm:

Belirti: 403 ACCESS_DENIED.
​Neden: Bu işlem için Teamso'da yetkiniz yok ya da işlem token'la hiç yapılamıyor (şifre, güvenlik ayarları, token ve entegrasyon anahtarı yönetimi, SGK şifreleri, destek erişimi, webhook değişiklikleri gibi).
​Çözüm: Aynı işlemi ekranda yapabiliyor musunuz kontrol edin. Yapamıyorsanız yöneticinizden yetki isteyin (Sorumluluk Yönetme). Token'la kapalı işlemleri Teamso ekranından, kendi oturumunuzla yapın (Güvenlik ve yetkiler).

Belirti: 403 IP_NOT_ALLOWED.
​Neden: Şirketinizin IP kısıtlaması isteği reddetti.
​Çözüm: Yöneticinizden IP adresinizin izin listesine eklenmesini isteyin. Claude Desktop'taki yerel pakette bilgisayarınızın IP adresi izinli olmalıdır (Güvenlik ve erişim ayarları).

Belirti: 429 Too Many Requests.
​Neden: Hosted sunucu token başına dakikalık istek sınırı uygular; kısa sürede çok fazla istek gönderildi.
​Çözüm: Yanıttaki Retry-After süresi kadar (saniye) bekleyip yeniden deneyin. Asistandan aynı işi döngü içinde tekrar etmemesini isteyin.

Belirti: OTP_NOT_DONE; asistan SMS kodunun doğrulanmadığını söylüyor.
​Neden: Kod yanlış yazıldı ya da 3 dakikalık süre doldu.
​Çözüm: Asistandan yeni kod göndermesini isteyin ve gelen kodu 3 dakika içinde yazın. Kod gelmiyorsa profilinizdeki cep telefonu numarasını kontrol edin.

Belirti: CREDIT_INSUFFICIENT.
​Neden: İzin talebi oluşturma ve iptal etme SMS ile doğrulanır ve Dijital Kredi harcar; şirketin bakiyesi yetersiz.
​Çözüm: Şirket yöneticinizden Dijital Kredi yüklemesini isteyin (Dijital Kredi).

Belirti: Teamso araçları asistanda görünmüyor.
​Neden: İstemci yeni ayarı okumadı; Claude Desktop'ta Node.js eksik ya da eski, veya ayar dosyası bozuk.
​Çözüm:

Belirti: MCP erişimi ekranında Yalnız kendi oturumunuzda uyarısı var: "Erişim token'ları yalnız kullanıcının kendi oturumuyla yönetilir"; token oluşturulamıyor.
​Neden: Teamso destek ekibinin destek oturumundasınız.
​Çözüm: Token'ları yalnız kullanıcı kendi oturumunda yönetebilir; kendi hesabınızla giriş yapın.

Belirti: Asistan doğru araçları çağırıyor ama sonuç boş geliyor.
​Neden: O verileri görme yetkiniz yok ya da kayıt yok (ör. onay sırası sizde olan talep bulunmuyor).
​Çözüm: Aynı listeyi ekranda kontrol edin. Ekranda da görmüyorsanız asistan da göremez.

Sorun sürerse Teamso destek ekibine hata mesajındaki kodu, saatini ve kullandığınız istemciyi (Claude Desktop, Claude Code, Cursor, Windsurf vb.) iletin. Token'ınızı destek ekibiyle de paylaşmayın.

Belirti: Yeni token oluşturdum ama asistan hâlâ 401 veriyor.
​Neden: İstemci eski token'ı kullanmaya devam ediyor.
​Çözüm: Ayardaki token'ı değiştirin ve istemciyi tamamen yeniden başlatın.