Sorun giderme

Hata numarasına bakın; 401 kimlik, 403 yetki, 429 hız sınırı demektir ve üçünün de çözümü panelde.

Nerede bulunur: Uygulamanızın hata mesajı + panelde Ayarlar → Yapay Zeka Erişimi Kimler için: Bağlantısı kurulmayan ya da beklenmedik bir hata alan herkes Kısaca: Hata numarasına bakın; 401 kimlik, 403 yetki, 429 hız sınırı demektir ve üçünün de çözümü panelde.

Hızlı tablo

Gördüğünüz	Anlamı	Ne yapmalı
401 / "invalid token" / "needs authentication"	Anahtar kabul edilmedi	Aşağıdaki 401 bölümü
403 / "bu anahtarın kapsamı … çağıramaz"	Anahtar var ama o iş için yetkisi yok	Aşağıdaki 403 bölümü
429 / "too many requests"	Çok hızlı çağrı yapıldı	Aşağıdaki 429 bölümü
Hiç bağlanmıyor, adres bulunamıyor	Adres yanlış ya da erişim açık değil	Bağlanamıyorum bölümü
Bağlanıyor ama araçlar yok	Paketler kapalı ya da liste eski	Araç görünmüyor bölümü

401 · Anahtar kabul edilmedi

Treyza hangi sebeple reddettiğini bilerek söylemez (bu bir güvenlik tercihidir), bu yüzden listeyi sırayla geçin:

Anahtar eksik kopyalanmış olabilir. Anahtar uzundur; başındaki trz_mcp_ ile sonundaki karakterlerin tam olduğundan emin olun. Başında/sonunda boşluk kalmamalı.
Anahtar iptal edilmiş olabilir. Panelde satırın Durum sütununa bakın: İptal edildi yazıyorsa yeni anahtar oluşturun.
Süresi dolmuş olabilir. Durum Süresi doldu ise yeni anahtar oluşturun.
IP listesi engelliyor olabilir. Anahtarı oluştururken IP yazdıysanız ve internet adresiniz değiştiyse anahtar çalışmaz. Çözüm: yeni bir anahtar oluşturup IP kutusunu boş bırakın.
Anahtar başka mağazanın olabilir. Birden fazla mağazanız varsa doğru mağazanın anahtarını kullandığınızdan emin olun.
Başlık biçimi bozuk olabilir. Başlık tam olarak şöyle olmalı (Bearer ve tek boşluk dâhil):
```
Authorization: Bearer trz_mcp_live_...
```
Anahtarı üreten kişi mağazadan çıkarılmış olabilir. Bu durumda onun anahtarları otomatik iptal edilir.

En hızlı test: paneldeki Kullanımı gör kartına bakın. Denemeleriniz orada Hata olarak görünüyorsa anahtar Treyza'ya ulaşıyor demektir ve sorun anahtarın durumundadır. Hiçbir kayıt yoksa istek Treyza'ya hiç ulaşmıyordur — adrese bakın.

403 · Yetki yetmiyor

İki farklı 403 vardır:

"Bu anahtarın kapsamı … aracını çağıramaz."

Anahtar geçerli ama o araç, açık olan paketlerin dışında.

Panelde anahtarın satırında Kapsamı düzenle'yi açın ve hangi paketlerin verilmiş olduğuna bakın.
Gereken paket yoksa: kapsam sonradan genişletilemez. Gereken paketleri içeren yeni bir anahtar oluşturun.
Gereken paket yazma içeriyorsa anahtarın Okuma-yazma modunda olması gerekir; mod da değiştirilemez, yeni anahtar gerekir.

"Origin başlığı kabul edilmedi."

İstek tanınmayan bir web sayfasından geliyor. Bu genellikle Treyza'nın desteklemediği bir eklenti ya da tarayıcı aracı kullanıldığında olur. Desteklenen yollar için: Yapay Zeka Erişimi (MCP)

429 · Çok fazla çağrı

Bir anahtar dakikada 60, günde 2.000 çağrı yapabilir (yazma araçları dakikada 20).

Tek seferlik gördüyseniz: bir şey yapmanıza gerek yok, uygulama biraz sonra yeniden dener.
Sürekli görüyorsanız: yapay zekâya tek seferde çok büyük bir iş vermiş olabilirsiniz ("bütün ürünleri tek tek gez" gibi). Soruyu daraltın: eşik verin, dönem verin, kaç sonuç istediğinizi söyleyin.
Aynı anahtarı birden çok uygulamada kullanıyorsanız her uygulamaya ayrı anahtar verin; sınır anahtar başınadır.

Bağlanamıyorum

Adresi kontrol edin. Tam olarak şu olmalı:
```
https://api.treyza.co/mcp
```
Sonundaki /mcp unutulursa bağlantı kurulmaz.
Dosya biçimini kontrol edin. Cursor, VS Code ve Gemini CLI'ın ayar dosyaları birbirinden farklıdır; birinin bloğunu diğerine yapıştırmak sessizce çalışmaz. Doğru bloklar: Cursor, VS Code ve diğer uygulamalar
Planınıza bakın. Sekmede "Yapay Zeka Erişimi planınızda yok" yazıyorsa bağlantı zaten kurulamaz.
Sekmeyi görebiliyor musunuz? "Bu ekranı yalnız mağaza sahibi kullanabilir" diyorsa mağaza sahibinden anahtar isteyin.
Adres doğru, plan uygun ve yine de sunucu bulunamıyorsa Yapay Zeka Erişimi hesabınız için henüz açılmamış olabilir — destek ekibine yazın.

Araç görünmüyor

Bağlantı kuruldu ama yapay zekâ "böyle bir aracım yok" diyor:

Sebep	Çözüm
İlgili paket anahtarda açık değil	Kapsamı düzenle ile bakın; gerekiyorsa yeni anahtar oluşturun
Anahtar Salt okuma modunda, siz yazma aracı istiyorsunuz	Salt okuma anahtarı yazma araçlarını hiç görmez; yeni bir okuma-yazma anahtarı gerekir
Araç henüz yayında değil	Yayındaki araçların tam listesi: Araç kataloğu
Kapsamı yeni daralttınız ama uygulama eski listeyi gösteriyor	Uygulamalar araç listesini kısa bir süre (yaklaşık 5 dakika) akıllarında tutar. Bekleyin ya da bağlantıyı kapatıp yeniden açın.

Anahtarımı kaybettim

Anahtar yalnız bir kez gösterilir ve geri getirilemez. Yapılacak:

Eski anahtarı İptal et (kimsenin elinde kalmasın).
Yeni bir anahtar oluşturun: Anahtar oluşturma
Uygulamanızdaki eski anahtarı yenisiyle değiştirin.

Onay ekranı "istek geçersiz ya da süresi dolmuş" diyor

İzin ekranı (OAuth) istekleri kısa ömürlüdür. Tarayıcı sekmesi uzun süre açık kaldıysa istek düşer.

Çözüm: uygulamadaki bağlayıcıyı silip yeniden ekleyin ve onay ekranını hemen tamamlayın.

Claude Code'da oturum açma adımı takılıyor

Claude Code'un izin ekranı (OAuth) yolu, oturum açmayı gerçek bir terminalde yapmanızı ister; otomasyon içinden ya da bir betikten sürülemez. Claude Code için en kısa yol anahtarla bağlanmaktır: Claude Code

Sayılar panelden farklı

İki ayrı sebep olabilir; önce hangisi olduğunu ayırın.

1. Tanım farkı (en sık sebep, kusur değil). "Ciro" her ekranda aynı şeyi saymaz:

Sayı	Ne sayar
Yapay zekânın verdiği ciro	Sipariş tutarı — sipariş verildiği anda toplama girer, ödemesi henüz alınmamış olsa bile
Kontrol panelindeki Net Gelir kartı	Tahsilat esaslı — ödemesi tamamlanmış siparişler

İkisi de doğrudur; farklı olmaları beklenir. Karşılaştıracaksanız sipariş ekranındaki sipariş tutarlarıyla karşılaştırın.

2. Aracın veri kaynağı. Rapor araçlarının bir kısmı sipariş kayıtlarından, bir kısmı ziyaret olaylarından okur; olay toplanmamışsa ikinci grup gerçek toplamın altında kalabilir. Hangi aracın hangi gruptan olduğu araç kataloğundaki "Sayılar nereden geliyor?" bölümünde yazıyor ve o tablo araç kaydından üretildiği için her zaman günceldir: Araç kataloğu

Kesinlik gereken işlerde sipariş listesini kullanın. Sipariş sayısı ve sipariş listesi panelin sipariş ekranıyla birebir olmalıdır — değilse bize bildirin.

Hâlâ çözülmediyse

Destek talebi açarken şunları yazın; teşhisi çok hızlandırır:

Kullandığınız uygulama ve sürümü (Claude Code, Cursor, ChatGPT…)
Panelde anahtarın maskesi (asla anahtarın tamamı değil)
Hata mesajının tam metni ve varsa numarası
Kullanımı gör kartındaki son çağrının saati

Bu sayfada