---
url: https://docs.ogmabox.com/ko/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}

확인 사항:

* Ogma CA 인증서가 올바른 신뢰 저장소에 설치되어 있습니다.
* 실제로 사용하는 브라우저 프로필로 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`가 아니라 실제 URL입니다.
* 브라우저를 별도 창으로 열어 봅니다.
* Ogma 창 크기를 조절하여 브라우저 표시 영역을 강제로 다시 계산합니다.

## 사용자 지정 JavaScript 또는 CSS로 UI가 깨짐 {#custom-javascript-or-css-breaks-the-ui}

다음 복구 방법 중 하나를 사용하세요:

* **사용자 지정 UI 초기화**를 클릭합니다.
* `Ctrl+Alt+Shift+R`을 누릅니다.

로컬 저장소, 데스크톱 설정, 백엔드 환경 설정에서 사용자 지정 JavaScript와 CSS를 지운 뒤 Ogma를 다시 로드합니다.

## 데이터 또는 프로젝트가 예상과 다름 {#data-or-project-looks-wrong}

확인 사항:

* 올바른 인스턴스가 열려 있습니다.
* 올바른 프로젝트가 활성화되어 있습니다.
* 시작 환경 설정이 다른 인스턴스를 다시 열지 않았습니다.
* 필터나 점검 범위가 예상되는 행을 숨기지 않습니다.
* 정적 자산 숨김이 찾고 있는 콘텐츠 유형을 제외하지 않습니다.

프로젝트 데이터를 직접 변경하기 전에 백업을 만드세요.