Belgeler Yardım

Hata kodları ve sorun giderme

401 jetonun yok ya da yanlış olduğu, 403 jetonun tanındığı ama erişimin kapalı ya da jetonun iptal edildiği, 503 ise erişim hakkının o an doğrulanamadığı ve güvenli tarafta kalınarak reddedildiği anlamına gelir. Kota dolduğunda JSON-RPC -32002 döner.

HTTP yanıtları

Kod	Yanıt	Anlamı	Ne yapmalı
401	`unauthorized`	Jeton yok, yanlış ya da başlık biçimi hatalı.	Başlığı ve jetonu kontrol et; gerekirse jetonu yenile.
403	`revoked`	Jeton yenilendi ya da iptal edildi.	Yeni jetonla istemciyi güncelle.
403	`entitlement_inactive`	Erişimin kapalı; `reason` nedeni verir.	Deneme ya da dönem bittiyse erişim satın al ya da yenile.
403	`token_not_active`	Jeton ya da hesap üyeliği artık aktif değil.	Hesabından yeni jeton oluştur; Desk'ten çıkarıldıysan hesap sahibine yaz.
403	`seat_limit_exceeded`	Desk'te aktif jeton sayısı kişi hakkını aşıyor.	Hesap sahibine ya da satış ekibine yaz.
403	`origin_not_allowed`	İstek tarayıcıdan geldi.	MCP istemcisi kullan.
413	`payload_too_large`	İstek gövdesi 4 MB'ı aşıyor.	Daha az veri gönder.
429	`rate_limited`	Dakikada 60 istek sınırı aşıldı.	`Retry-After` kadar bekle.
503	`entitlement_unavailable`	Erişim hakkı o an doğrulanamıyor; erişim açılmaz.	Birkaç saniye sonra yeniden dene.
503	`busy`	Sunucu o an yoğun.	Birkaç saniye sonra yeniden dene.

Araç çağrısı hataları

Kod	Anlamı
`-32002`	Kota doldu; mesaj hangi hakkın dolduğunu ve dönem sonunu verir. Çağrı çalıştırılmaz.
`-32003`	Erişim hakkı o an doğrulanamıyor; yeniden dene.
`-32001`	Araç 90 saniyede tamamlanamadı; yeniden dene.

Araç sonuç kodları

Kod	Anlamı
`INVALID_INPUT`	Girdi geçersiz (ör. sembol biçimi, bilinmeyen alan) ya da harici veri reddedildi.
`UNSUPPORTED_SYMBOL`	Sembol hazır veri setinde yok.
`DATA_UNAVAILABLE`	Gereken veri şu an yok.
`STALE_DATA`	Uyarı: veri tazelik sınırını aştı; sonuç gösteriliyor.
`INSUFFICIENT_HISTORY`	Analiz için yeterli geçmiş yok.
`NOT_EVALUABLE`	Analizin gerektirdiği alan eksik; eksik alan listelenir.
`UNSUPPORTED_ANALYSIS`	Bu veri türü için istenen analiz yok; desteklenenler listelenir.

Sık karşılaşılan durumlar

Claude Code BorsaMCP'yi görmüyor

claude mcp list ile borsamcp kaydını kontrol et. Başka bir klasörde eklediysen yerel kapsam yüzünden görünmeyebilir; tüm projeler için --scope user ile yeniden ekle. Claude Code oturumunu yeniden başlat. claude mcp get borsamcp bağlanamıyor diyorsa aşağıdaki 401/403 maddelerine bak.

401 geçersiz jeton

Jeton yok, yanlış ya da başlık biçimi hatalı. Başlık tam olarak Authorization: Bearer <JETONUN> olmalı; jeton bmcp_ ile başlar, boşluk ya da tırnak taşımamalı. Emin değilsen jetonu yenile ve istemciyi güncelle.

403 erişim reddedildi

Jeton tanındı ama kullanılamıyor. Yanıttaki error alanı nedeni söyler: revoked (jeton yenilendi ya da iptal edildi: istemciyi yeni jetonla güncelle), entitlement_inactive (erişimin kapalı; reason alanı ör. trial_ended deneme bitti, access_expired dönem bitti), token_not_active (jeton ya da hesap üyeliğin artık aktif değil: hesabında MCP erişimi bölümünden Erişim jetonu oluştur; Desk'ten çıkarıldıysan hesap sahibine yaz), seat_limit_exceeded (Desk'te aktif jeton sayısı kişi hakkını aşıyor: hesap sahibine yaz).

Deneme bitti

Deneme kendiliğinden ücretliye dönmez. Devam etmek için hesabından Research ya da Pro için 30 günlük erişim satın al. Jetonun durur; erişim açılınca aynı jetonla devam edebilirsin.

Jeton kayboldu

Jeton yeniden gösterilemez ve destek ekibi de geri getiremez. Hesabında Jetonu yenile: eski jeton geçersiz olur, yenisini Claude Code'a ekle.

Jeton yenilendi, istemci çalışmıyor

Eski jeton yenilemeyle hemen geçersiz olur (403 revoked). claude mcp remove borsamcp ile kaydı sil ve yeni jetonla yeniden ekle.

Kota doldu

JSON-RPC -32002: dönemdeki araştırma işlemi ya da kendi verinle analiz hakkın doldu. Diğer hak çalışmaya devam eder. Hak yeni ödemeli dönemle yenilenir; ayrıntı: Hak dolunca.

Harici veri reddedildi

İsteğin tamamı reddedildiyse araç INVALID_INPUT ile sorun kodlarını döndürür (ör. SECRET_FIELD_REJECTED) ve kotadan düşmez. Köken eksikse sonuç UNAVAILABLE olur, analiz yapılmaz. Yalnız bazı kayıtlar hatalıysa (ör. REQUIRED_FIELD_MISSING) o kayıtlar çıkarılır, sonuç PARTIAL olur ve analiz üretildiyse hak düşer. Kodların anlamı: doğrulama hataları.

Gerçek zamanlı istek gecikmeli sayıldı

Köken providerTimestamp taşımıyorsa ya da gecikme 60 saniyeyi aşıyorsa veri DELAYED kabul edilir ve sonuca REALTIME_ANALYSIS_NOT_AVAILABLE eklenir. Bu bir hata değil, kuraldır: zaman seviyeleri.

Shopier'de ödedim, erişim açılmadı

Hesabına dön ve Ödedim, kontrol et ya da Ödemeyi kontrol et ile doğrulamayı başlat. Ödemenin BorsaMCP hesabındaki e-posta adresiyle yapıldığını kontrol et. Hâlâ görünmüyorsa birkaç dakika sonra yeniden dene; çözülmezse [email protected] adresine sipariş numaranla yaz. Kart bilgisi, parola ya da jeton gönderme.

“Bu veriye erişim yok” cevabı

VİOP, takas, derinlik ya da anlık fiyat hazır veride yoktur. Oturumda bu veriyi sağlayan bir kaynak bağlı değilse bu cevap beklenen davranıştır: Harici veri kullanımı.

Hâlâ çözülmediyse

[email protected] adresine ne yapmak istediğini, gördüğün hata kodunu ve zamanı yaz. Jetonunu, parolanı, kart bilgini ya da veri sağlayıcı kimlik bilgilerini gönderme.