문제 해결

사용자가 실제로 겪는 문제의 해결책을 대략 발생 순서대로 제공합니다. 해결되지 않으면 AI에 진단 실행을 요청하세요. AI가 대신 문제를 보고할 수 있습니다.

AI 클라이언트에 도구가 표시되지 않음

  • 설치 후 AI 앱을 한 번 다시 시작하세요. MCP 클라이언트는 시작할 때 구성을 읽습니다.
  • Cursor/VS Code: 도구는 Agent 모드에서만 표시됩니다. Chat 및 Edit 모드는 MCP 도구를 노출하지 않습니다.
  • Mac 메뉴 막대 또는 Windows 시스템 트레이에 LMCP 아이콘이 있고 상태 표시가 녹색인지 확인하세요.

메뉴 막대 또는 시스템 트레이 아이콘 누락

Mac에서는 응용 프로그램, Windows에서는 시작 메뉴에서 Local MCP를 여세요. Mac에서는 트레이가 실행되지 않을 때의 가이드로 LaunchAgent를 재설정할 수 있습니다. Windows에서는 작업 관리자에서 LMCP를 종료한 후 시작 메뉴에서 다시 여세요.

“권한 거부됨” 또는 빈 결과

운영 체제 또는 앱 권한이 없습니다. 권한 가이드를 확인하세요. Mac의 Mail, iMessage와 로컬 메시지 캐시에는 전체 디스크 접근, 앱 동작에는 자동화가 필요할 수 있습니다. Windows에서는 설정 → 개인 정보 및 보안을 확인하고 관련 데스크톱 앱이 로그인되어 있으며 로컬 데이터가 사용 가능한지 확인하세요.

ChatGPT/Claude.ai가 컴퓨터에 연결할 수 없음

  • 메뉴 막대 앱에서 웹 접근(Your web AI · Cloud Relay)을 켜세요. 기본적으로 꺼져 있습니다.
  • Mac 또는 Windows PC가 켜져 있고 온라인인지 확인하세요. 릴레이는 자동으로 다시 연결됩니다.
  • 인증 오류가 표시되면 메뉴 막대에서 연결 URL/토큰을 다시 복사하세요. AI 연결을 참조하세요.

도구가 실패하거나 예상과 다른 결과를 반환함

AI에 “이 문제를 보고해 줘”라고 요청하세요. LMCP의 기본 보고 도구가 버전, 권한 상태와 최근 오류를 포함한 전체 진단 스냅샷을 수집해 한 단계로 팀에 전송하며 사례 ID를 제공합니다.

Mac에서는 AI에 lmcp_doctor 실행을 요청할 수도 있습니다. AI 클라이언트 구성, 권한, 통합과 업데이트 검사를 먼저 보여주고 명시적으로 확인한 안전한 항목만 복구합니다. 이에 해당하는 Windows 안내 복구 흐름은 아직 개발 중입니다.

로그 위치

Mac:

~/Library/Application Support/Local MCP/server.log

Windows: 시스템 트레이에서 LMCP → Diagnostics → Open logs를 사용하세요.

아직 해결되지 않았나요?

도움말 센터를 검색하거나(질문은 개선에 도움이 됩니다) 문의하세요.