---
url: https://docs.ogmabox.com/cs/troubleshooting.md
description: >-
  Diagnostikujte běžné problémy s nastavením Ogma, zachytáváním přes proxy,
  zachytáváním HTTPS, desktopovým prostředím, pluginy, MCP, skenerem a exporty.
---

# Řešení problémů {#troubleshooting}

Na této stránce najdete postupy pro diagnostiku běžných problémů s nastavením a provozem Ogma.

## V historii HTTP se nezobrazuje žádný provoz {#no-traffic-appears-in-http-history}

Ověřte, že:

1. Instance Ogma běží.
2. Proxy prohlížeče nebo aplikace směřuje na naslouchací adresu instance, obvykle `127.0.0.1:8080`.
3. Cílová aplikace neobchází proxy.
4. Nastavení VPN, systémové proxy, kontejneru, emulátoru nebo mobilní proxy nepřepisuje nastavení testovacího klienta.
5. Aktivní projekt je otevřený v pracovním prostoru.

Pokud používáte prohlížeč Ogma, otevřete novou kartu a ověřte, že je viditelný štítek **Přes proxy**.

## Požadavky HTTPS selhávají {#https-requests-fail}

Ověřte, že:

* Certifikát CA Ogma je nainstalován ve správném úložišti důvěryhodných certifikátů.
* CA jste importovali do skutečně používaného profilu prohlížeče.
* Cíl nepoužívá certificate pinning.
* Pravidla pro předávání TLS bez dešifrování nevylučují daného hostitele.
* Pokud cíl vyžaduje mTLS, jsou požadavky na klientské certifikáty nastaveny v **Nastavení > Klientské certifikáty**.

U mobilních nebo desktopových aplikací s certificate pinning může být nutné zvláštní testovací nastavení dané aplikace mimo Ogma.

## Zachytávání pozastavuje příliš mnoho provozu {#intercept-pauses-too-much-traffic}

Použijte užší pravidla zachytávání.

Doporučené kroky:

1. Vypněte **Zachytávání**.
2. Vymezte rozsah testování.
3. Přidejte podmínky shody pro hostitele, metodu, cestu, typ obsahu nebo hlavičku.
4. Znovu zapněte **Zachytávání**.
5. Sledujte velikost fronty.

Pokud fronta dosáhne své kapacity, Ogma nový provoz předává dál, aby nedošlo k zablokování klienta.

## Skener hlásí příliš mnoho šumu {#scanner-reports-too-much-noise}

Při šumu z pasivního skeneru:

* Před skenováním aktivujte rozsah testování.
* Nejdříve se zaměřte na nálezy se střední, vysokou a kritickou závažností.
* Nálezy chybějících hlaviček posuzujte podle kontextu.
* Pro důkazy specifické pro projekt používejte vlastní pasivní pravidla.

Při šumu z aktivního skeneru:

* Před skenováním celé historie skenujte vybrané požadavky.
* Zkontrolujte důkazní požadavky a těla odpovědí.
* Ověřte, že důkaz v odpovědi nebyl přítomen již ve výchozí odpovědi.
* Zkontrolujte, zda je nález označen jako pravděpodobný, nebo potvrzený.

## Pluginy se nenačítají {#plugins-do-not-load}

Ověřte, že:

1. Kořenová složka pluginu obsahuje `manifest.json`.
2. Cesty vstupních bodů uvedené v manifestu po sestavení existují.
3. Plugin je zkompilován do běžného JavaScriptu.
4. Balíček pluginu obsahuje frontendové prostředky.
5. Požadovaná oprávnění jsou deklarována a udělena.
6. Karta protokolů pluginu neobsahuje chyby `init()` ani chyby komunikačního můstku.
7. Velikost balíčku pluginu je pod nastaveným limitem.

## MCP asistent nevidí Ogma {#mcp-assistant-cannot-see-ogma}

Ověřte následující:

* Vestavěné HTTP: MCP běží v **Nastavení > MCP** a klient používá zkopírovaný koncový bod Streamable HTTP, obvykle `http://127.0.0.1:3000/mcp`.
* Samostatné stdio: cesta k binárnímu souboru je správná a `--api-url` / `OGMA_API_URL` odpovídá běžícímu backendu. Desktopové instance mohou používat dynamický port API.
* Klient zpracovává každý kurzor `tools/list`; samotná první stránka neobsahuje všechny nástroje.
* Nástroje pro zápis nebo odesílání vyžadují výslovná oprávnění v nastavení nebo přepínače samostatného procesu.
* Po restartu MCP se znovu připojte. Staré identifikátory relací a potvrzovací tokeny již nejsou platné.

Viz [Nastavení MCP](./mcp-setup.md).

## Prohlížeč Ogma je prázdný nebo nesprávně umístěný {#ogma-browser-is-blank-or-mispositioned}

Zkontrolujte následující:

* Spouštíte desktopovou aplikaci, nejen webový frontend.
* Aktivní karta má skutečnou URL místo `about:blank`.
* Zkuste otevřít prohlížeč v samostatném okně.
* Změňte velikost okna Ogma, aby se přepočítaly rozměry prohlížeče.

## Vlastní JavaScript nebo CSS narušuje rozhraní {#custom-javascript-or-css-breaks-the-ui}

Použijte jeden z postupů obnovení:

* Klikněte na **Obnovit vlastní rozhraní**.
* Stiskněte `Ctrl+Alt+Shift+R`.

Tím se odstraní vlastní JavaScript a CSS z lokálního úložiště, desktopového nastavení i předvoleb backendu a Ogma se znovu načte.

## Data nebo projekt vypadají nesprávně {#data-or-project-looks-wrong}

Ověřte, že:

* Je otevřena správná instance.
* Je aktivní správný projekt.
* Předvolby spuštění neotevřely jinou instanci.
* Filtry nebo rozsah testování neskrývají očekávané řádky.
* Skrývání statických prostředků nevylučuje hledaný typ obsahu.

Před ručními změnami dat projektu vytvořte zálohu.