---
url: https://docs.ogmabox.com/tr/troubleshooting.md
description: >-
  Ogma kurulumu, proxy trafik kaydı, HTTPS incelemesi, masaüstü çalışma zamanı,
  eklenti, MCP, tarayıcı ve dışa aktarım sorunlarını teşhis edin.
---

# Sorun giderme {#troubleshooting}

Yaygın Ogma kurulum ve çalışma zamanı sorunlarını teşhis etmek için bu sayfayı kullanın.

## HTTP geçmişi bölümünde trafik görünmüyor {#no-traffic-appears-in-http-history}

Kontrol edin:

1. Ogma örneği çalışıyor mu?
2. Tarayıcı veya uygulamanın proxy'si, genellikle `127.0.0.1:8080` olan örnek dinleyicisine yönlendirilmiş mi?
3. Hedef uygulama proxy'yi atlıyor mu?
4. VPN, sistem proxy'si, kapsayıcı, emülatör veya mobil proxy ayarları test istemcisinin ayarlarını geçersiz kılıyor mu?
5. Etkin proje çalışma alanında açık mı?

Ogma Browser kullanıyorsanız yeni bir sekme açın ve **Proxy üzerinden** rozetinin göründüğünü doğrulayın.

## HTTPS istekleri başarısız oluyor {#https-requests-fail}

Kontrol edin:

* Ogma CA sertifikası doğru güven deposuna yüklenmiş mi?
* CA'yı gerçekten kullanılan tarayıcı profiline aktardınız mı?
* Hedef sertifika sabitleme kullanıyor mu?
* TLS geçiş kuralları ana makineyi kapsam dışında bırakıyor mu?
* Hedef mTLS gerektiriyorsa istemci sertifikası gereksinimleri **Ayarlar > İstemci sertifikaları** bölümünde yapılandırılmış mı?

Sertifika sabitleme kullanan mobil veya masaüstü uygulamaları için Ogma dışında uygulamaya özgü bir test kurulumu gerekebilir.

## Trafik durdurma çok fazla trafiği bekletiyor {#intercept-pauses-too-much-traffic}

Daha dar trafik durdurma kuralları kullanın.

Önerilen adımlar:

1. Trafik durdurmayı devre dışı bırakın.
2. Kapsamı tanımlayın.
3. Ana makine, yöntem, yol, içerik türü veya başlık için eşleşme koşulları ekleyin.
4. Trafik durdurmayı yeniden etkinleştirin.
5. Kuyruk boyutunu izleyin.

Kuyruk kapasiteye ulaşırsa Ogma, istemcinin kilitlenmesini önlemek için yeni trafiği iletir.

## Tarayıcı çok fazla ilgisiz sonuç bildiriyor {#scanner-reports-too-much-noise}

Pasif tarayıcının ilgisiz sonuçları için:

* Taramadan önce kapsamı etkinleştirin.
* Önce orta, yüksek ve kritik bulgulara odaklanın.
* Eksik başlık bulgularını bağlama göre değerlendirin.
* Projeye özgü kanıtlar için özel pasif kurallar kullanın.

Aktif tarayıcının ilgisiz sonuçları için:

* Tüm geçmişi taramadan önce seçilen istekleri tarayın.
* Kanıt isteklerini ve yanıt gövdelerini inceleyin.
* Yanıt kanıtının temel yanıtta bulunmadığını doğrulayın.
* Bulgunun güven düzeyinin olası mı yoksa doğrulanmış mı olduğunu kontrol edin.

## Eklentiler yüklenmiyor {#plugins-do-not-load}

Kontrol edin:

1. Eklenti kök dizini `manifest.json` içeriyor mu?
2. Manifeste yazılan giriş noktası yolları derleme sonrasında mevcut mu?
3. Eklenti düz JavaScript olarak derlenmiş mi?
4. Ön uç varlıkları eklenti paketine eklenmiş mi?
5. Gerekli izinler bildirilmiş ve verilmiş mi?
6. Eklentinin günlükler sekmesinde `init()` veya köprü hatası var mı?
7. Eklenti paketinin boyutu yapılandırılan sınırın altında mı?

## MCP asistanı Ogma'yı göremiyor {#mcp-assistant-cannot-see-ogma}

Kontrol edin:

* Yerleşik HTTP: MCP **Ayarlar > MCP** bölümünde çalışıyor mu ve istemci, genellikle `http://127.0.0.1:3000/mcp` olan kopyalanmış Streamable HTTP uç noktasını kullanıyor mu?
* Bağımsız stdio: ikili dosya yolu doğru mu ve `--api-url` / `OGMA_API_URL` çalışan arka uçla eşleşiyor mu? Masaüstü örnekleri dinamik bir API portu kullanabilir.
* İstemci tüm `tools/list` imleçlerini takip ediyor mu? Yalnızca ilk sayfa tüm araçları içermez.
* Yazma veya gönderme araçları Ayarlar'da açık izinler ya da bağımsız çalıştırmada bayraklar gerektirir.
* MCP yeniden başladıktan sonra yeniden bağlanın. Eski oturum kimlikleri ve onay belirteçleri artık geçerli değildir.

[MCP kurulumu](./mcp-setup.md) bölümüne bakın.

## Ogma Browser boş veya yanlış konumda {#ogma-browser-is-blank-or-mispositioned}

Kontrol edin:

* Yalnızca web ön uç yerine masaüstü uygulamasını çalıştırıyor musunuz?
* Etkin sekmede `about:blank` yerine gerçek bir URL var mı?
* Tarayıcıyı ayrı bir pencerede açmayı deneyin.
* Tarayıcı sınırlarının yeniden hesaplanmasını sağlamak için Ogma penceresini yeniden boyutlandırın.

## Özel JavaScript veya CSS arayüzü bozuyor {#custom-javascript-or-css-breaks-the-ui}

Kurtarma yollarından birini kullanın:

* **Özel arayüzü sıfırla** düğmesine tıklayın.
* `Ctrl+Alt+Shift+R` tuşlarına basın.

Bu işlem özel JavaScript ve CSS'yi yerel depolamadan, masaüstü ayarlarından ve arka uç tercihlerinden temizler, ardından Ogma'yı yeniden yükler.

## Veriler veya proje yanlış görünüyor {#data-or-project-looks-wrong}

Kontrol edin:

* Doğru örnek açık mı?
* Doğru proje etkin mi?
* Başlangıç tercihleri farklı bir örneği yeniden açmış olabilir mi?
* Filtreler veya kapsam beklenen satırları gizliyor mu?
* Statik varlıkları gizleme seçeneği aradığınız içerik türünü dışlıyor mu?

Proje verilerini elle değiştirmeden önce bir yedek oluşturun.