문제 해결

확장 프로그램이 연결되지 않음

증상： MCP 도구 호출이 "확장 프로그램이 연결되지 않음" 또는 타임아웃을 반환합니다.

1. chrome://extensions 에서 DevBridge 확장 프로그램이 설치되고 활성화되어 있는지 확인
2. MCP 서버 재시작（AI 도구에서 중지 후 재추가）
3. 확장 프로그램 리로드（chrome://extensions 의 새로고침 아이콘 클릭）
4. 네이티브 메시징 호스트가 설치되지 않은 경우 npx devbridge-mcp@latest --install 을 실행하여 강제 재설치

프롬프트 없이 도구가 거부됨

증상： 도구 호출이 승인 대화상자 없이 즉시 "user rejected" 를 반환합니다.

이는 Claude Code 에서 도구가 사전 승인되지 않은 상태로 비대화형 환경（CI、헤드리스 세션、프롬프트가 억제된 터미널）에서 실행될 때 발생합니다.

해결 방법： 프로젝트의 .claude/settings.local.json 에 DevBridge 허용 규칙을 추가합니다：

{
  "permissions": {
    "allow": ["mcp__devbridge__*"]
  }
}

이렇게 하면 18 개의 모든 DevBridge 도구가 사전 승인됩니다. 자세한 내용은 Claude Code 설정 섹션 을 참조하세요.

권한 거부됨

증상： 도구 호출이 도메인에 대한 권한 오류를 반환합니다.

DevBridge 는 도메인별 민감한 작업에 명시적 권한이 필요합니다. 실수로 권한을 거부한 경우：

1. 도구 모음의 DevBridge 아이콘 클릭
2. 권한 으로 이동하여 해당 도메인의 거부 규칙 삭제
3. 작업 재시도 — 다시 승인 프롬프트가 표시됩니다

디버거가 이미 연결됨

증상： "다른 확장 프로그램이 이 탭에서 디버거를 사용하고 있습니다".

한 번에 하나의 확장 프로그램만 탭에 Chrome 디버거를 연결할 수 있습니다. chrome.debugger 를 사용하는 다른 확장 프로그램（다른 자동화 도구 등）을 탭에서 연결 해제한 후 재시도하세요.

액션 인디케이터가 멈춤

증상： 작업 완료 후에도 DevBridge 발광 인디케이터가 계속 표시됩니다.

인디케이터의 중지 버튼을 클릭하거나 탭을 리로드하세요. 정상적으로 작업이 완료되면 인디케이터는 50ms 후 자동으로 숨겨집니다.

GIF 가 생성되지 않음

증상： gif_creator 가 오류 또는 빈 결과를 반환합니다.

• 탭이 표시 상태인지 확인（GIF 캡처는 탭이 활성 상태여야 합니다）
• 단계 수 또는 캡처 시간을 줄이세요
• Chrome 에 충분한 메모리가 있는지 확인하세요

여전히 해결되지 않나요？

브라우저 콘솔（chrome://extensions → DevBridge → 백그라운드 페이지 → 콘솔）에서 오류 세부 정보를 확인하세요.