---
url: https://docs.ogmabox.com/uk/troubleshooting.md
description: >-
  Діагностуйте типові проблеми налаштування Ogma, запису проксі, перехоплення
  HTTPS, настільного виконання, плагінів, MCP, сканера й експорту.
---

# Усунення несправностей {#troubleshooting}

Використовуйте цю сторінку для діагностики типових проблем налаштування й виконання Ogma.

## Трафік не з’являється в історії HTTP {#no-traffic-appears-in-http-history}

Перевірте:

1. Екземпляр Ogma запущено.
2. Проксі браузера або застосунку вказує на порт прослуховування екземпляра, зазвичай `127.0.0.1:8080`.
3. Цільовий застосунок не обходить проксі.
4. Налаштування VPN, системного проксі, контейнера, емулятора або мобільного проксі не перевизначають тестовий клієнт.
5. Активний проєкт відкритий у робочому просторі.

Якщо використовуєте браузер Ogma, відкрийте нову вкладку й переконайтеся, що позначка **Через проксі** видима.

## Запити HTTPS не виконуються {#https-requests-fail}

Перевірте:

* Сертифікат CA Ogma встановлено в правильне сховище довіри.
* CA імпортовано до профілю браузера, який фактично використовується.
* Ціль не використовує закріплення сертифіката.
* Правила наскрізного TLS не виключають хост.
* Клієнтські сертифікати налаштовано в **Налаштування > Клієнтські сертифікати**, якщо ціль потребує mTLS.

Для мобільних або настільних застосунків із закріпленням сертифіката можуть знадобитися специфічні налаштування тестування поза Ogma.

## Перехоплення призупиняє забагато трафіку {#intercept-pauses-too-much-traffic}

Використовуйте вужчі правила перехоплення.

Рекомендовані кроки:

1. Вимкніть перехоплення.
2. Визначте область тестування.
3. Додайте умови збігу хоста, методу, шляху, типу вмісту або заголовка.
4. Знову ввімкніть перехоплення.
5. Стежте за розміром черги.

Якщо черга заповнюється, Ogma передає новий трафік далі, щоб уникнути взаємного блокування клієнта.

## Сканер повідомляє забагато шуму {#scanner-reports-too-much-noise}

Для шуму пасивного сканера:

* Активуйте область перед скануванням.
* Спочатку зосередьтеся на знахідках середньої, високої й критичної важливості.
* Вважайте знахідки щодо відсутніх заголовків залежними від контексту.
* Використовуйте власні пасивні правила для доказів конкретного проєкту.

Для шуму активного сканера:

* Скануйте вибрані запити перед усією історією.
* Перевіряйте доказові запити й тіла відповідей.
* Переконайтеся, що доказів із відповіді не було в базовій відповіді.
* Перевірте, чи рівень упевненості знахідки — імовірний або підтверджений.

## Плагіни не завантажуються {#plugins-do-not-load}

Перевірте:

1. Корінь плагіна містить `manifest.json`.
2. Шляхи точок входу в маніфесті існують після збірки.
3. Плагін скомпільовано у звичайний JavaScript.
4. Ресурси інтерфейсу включено до пакета плагіна.
5. Потрібні дозволи заявлено й надано.
6. Вкладка журналів плагіна не містить помилок `init()` або мосту.
7. Розмір пакета нижчий за налаштований ліміт.

## MCP-помічник не бачить Ogma {#mcp-assistant-cannot-see-ogma}

Перевірте:

* Вбудований HTTP: MCP запущено в **Налаштування > MCP**, а клієнт використовує скопійовану кінцеву точку Streamable HTTP, зазвичай `http://127.0.0.1:3000/mcp`.
* Окремий stdio: шлях бінарного файлу правильний, а `--api-url` / `OGMA_API_URL` відповідає запущеному бекенду. Настільні екземпляри можуть використовувати динамічний порт API.
* Клієнт обробляє кожен курсор `tools/list`; сама перша сторінка не містить усіх інструментів.
* Інструменти запису або надсилання потребують явних дозволів у налаштуваннях чи прапорців окремого процесу.
* Підключіться знову після перезапуску MCP. Старі ID сеансів і токени підтвердження вже недійсні.

Див. [Налаштування MCP](./mcp-setup.md).

## Браузер Ogma порожній або розташований неправильно {#ogma-browser-is-blank-or-mispositioned}

Перевірте:

* Ви запускаєте настільний застосунок, а не лише вебінтерфейс.
* Активна вкладка має справжній URL, а не `about:blank`.
* Спробуйте відкрити браузер окремим вікном.
* Змініть розмір вікна Ogma для примусового перерахунку меж браузера.

## Власний JavaScript або CSS порушує інтерфейс {#custom-javascript-or-css-breaks-the-ui}

Використовуйте один зі способів відновлення:

* Натисніть **Скинути власні зміни інтерфейсу**.
* Натисніть `Ctrl+Alt+Shift+R`.

Це прибирає власні JavaScript і CSS із локального сховища, настільних налаштувань і параметрів бекенда, потім перезавантажує Ogma.

## Дані або проєкт виглядають неправильно {#data-or-project-looks-wrong}

Перевірте:

* Відкрито правильний екземпляр.
* Активний правильний проєкт.
* Налаштування запуску не відкрили інший екземпляр.
* Фільтри або область не приховують очікувані рядки.
* Приховування статичних ресурсів не виключає потрібний тип вмісту.

Створіть резервну копію перед ручними змінами даних проєкту.