---
url: https://docs.ogmabox.com/de/troubleshooting.md
description: >-
  Diagnostiziere häufige Probleme mit Ogmas Einrichtung, Proxy-Aufzeichnung,
  HTTPS-Interception, Desktop-Laufzeit, Plugins, MCP, Scanner und Exporten.
---

# Problemlösung {#troubleshooting}

Nutze diese Seite zur Diagnose häufiger Einrichtungs- und Laufzeitprobleme in Ogma.

## Im HTTP-Verlauf erscheint kein Datenverkehr {#no-traffic-appears-in-http-history}

Prüfe:

1. Die Ogma-Instanz läuft.
2. Der Proxy des Browsers oder der Anwendung zeigt auf den Instanz-Listener, normalerweise `127.0.0.1:8080`.
3. Die Zielanwendung umgeht den Proxy nicht.
4. VPN-, System-Proxy-, Container-, Emulator- oder mobile Proxy-Einstellungen überschreiben nicht die Proxy-Konfiguration des Test-Clients.
5. Das aktive Projekt ist im Arbeitsbereich geöffnet.

Öffne beim Ogma-Browser einen neuen Tab und prüfe, ob das Abzeichen **Über Proxy** sichtbar ist.

## HTTPS-Anfragen schlagen fehl {#https-requests-fail}

Prüfe:

* Das Ogma-CA-Zertifikat ist im richtigen Vertrauensspeicher installiert.
* Du hast die CA in das tatsächlich verwendete Browserprofil importiert.
* Das Ziel verwendet kein Certificate Pinning.
* TLS-Passthrough-Regeln schließen den Host nicht aus.
* Client-Zertifikatanforderungen sind unter **Einstellungen > Clientzertifikate** konfiguriert, falls das Ziel mTLS benötigt.

Für mobile oder Desktop-Anwendungen mit Certificate Pinning brauchst du möglicherweise eine anwendungsspezifische Testeinrichtung außerhalb von Ogma.

## Abfangen hält zu viel Datenverkehr an {#intercept-pauses-too-much-traffic}

Nutze enger gefasste Regeln für Abfangen.

Empfohlene Schritte:

1. Deaktiviere das Abfangen.
2. Definiere den Scope.
3. Füge Abgleichbedingungen für Host, Methode, Pfad, Inhaltstyp oder Header hinzu.
4. Aktiviere das Abfangen erneut.
5. Beobachte die Warteschlangengröße.

Erreicht die Warteschlange ihre Kapazität, leitet Ogma neuen Datenverkehr weiter, um eine Blockade des Clients zu vermeiden.

## Der Scanner meldet zu viele störende Treffer {#scanner-reports-too-much-noise}

Bei zu vielen störenden Treffern des passiven Scanners:

* Aktiviere vor dem Scannen den Scope.
* Konzentriere dich zuerst auf mittlere, hohe und kritische Befunde.
* Behandle Befunde zu fehlenden Headern als kontextabhängig.
* Nutze eigene passive Regeln für projektspezifische Nachweise.

Bei zu vielen störenden Treffern des aktiven Scanners:

* Scanne ausgewählte Anfragen, bevor du den gesamten Verlauf scannst.
* Prüfe Nachweisanfragen und Antwort-Bodies.
* Bestätige, dass der Antwortnachweis nicht bereits in der Referenzantwort vorhanden war.
* Prüfe, ob die Aussagesicherheit des Befunds wahrscheinlich oder bestätigt ist.

## Plugins werden nicht geladen {#plugins-do-not-load}

Prüfe:

1. Das Plugin-Stammverzeichnis enthält `manifest.json`.
2. Die Einstiegspunktpfade im Manifest existieren nach dem Build.
3. Das Plugin ist zu reinem JavaScript kompiliert.
4. Frontend-Ressourcen sind im Plugin-Paket enthalten.
5. Erforderliche Berechtigungen sind deklariert und gewährt.
6. Der Plugin-Protokolltab enthält keine `init()`- oder Bridge-Fehler.
7. Die Plugin-Paketgröße liegt unter der konfigurierten Grenze.

## Der MCP-Assistent kann Ogma nicht erreichen {#mcp-assistant-cannot-see-ogma}

Prüfe:

* Eingebettetes HTTP: MCP läuft unter **Einstellungen > MCP**, und der Client verwendet den kopierten Streamable-HTTP-Endpunkt, normalerweise `http://127.0.0.1:3000/mcp`.
* Eigenständiges stdio: Der Binärpfad ist richtig und `--api-url` / `OGMA_API_URL` entspricht dem laufenden Backend. Desktop-Instanzen können einen dynamischen API-Port verwenden.
* Der Client folgt jedem Cursor von `tools/list`; die erste Seite allein enthält nicht alle Tools.
* Schreib- oder Sendetools benötigen ausdrückliche Berechtigungen in den Einstellungen oder eigenständige Flags.
* Verbinde nach MCP-Neustarts erneut. Alte Sitzungs-IDs und Bestätigungstokens sind nicht mehr gültig.

Siehe [MCP einrichten](./mcp-setup.md).

## Der Ogma-Browser ist leer oder falsch positioniert {#ogma-browser-is-blank-or-mispositioned}

Prüfe:

* Du verwendest die Desktop-Anwendung, nicht nur das Web-Frontend.
* Der aktive Tab enthält eine echte URL statt `about:blank`.
* Versuche, den Browser in einem separaten Fenster zu öffnen.
* Ändere die Größe des Ogma-Fensters, um Position und Größe des Browserbereichs neu berechnen zu lassen.

## Eigenes JavaScript oder CSS beschädigt die Oberfläche {#custom-javascript-or-css-breaks-the-ui}

Nutze einen der Wiederherstellungswege:

* Klicke auf **Oberflächenanpassungen zurücksetzen**.
* Drücke `Ctrl+Alt+Shift+R`.

Dies löscht eigenes JavaScript und CSS aus lokalem Speicher, Desktop-Einstellungen und Backend-Präferenzen und lädt Ogma anschließend neu.

## Daten oder Projekt erscheinen falsch {#data-or-project-looks-wrong}

Prüfe:

* Die richtige Instanz ist geöffnet.
* Das richtige Projekt ist aktiv.
* Startpräferenzen haben nicht eine andere Instanz erneut geöffnet.
* Filter oder Scope verbergen keine erwarteten Zeilen.
* Das Ausblenden statischer Ressourcen schließt nicht den gesuchten Inhaltstyp aus.

Erstelle ein Backup, bevor du Projektdaten manuell änderst.