본문으로 건너뛰기
MCP · RemoteCommand

에이전트 오프라인 및 MCP 연결 오류 해결

장치가 오프라인이거나 명령이 차단되는 경우, npx 설치 문제, OAuth 인증 및 MCP 클라이언트 연결 문제를 단계별로 해결하세요.

장치가 오프라인인 경우

컴퓨터에서 에이전트가 실행 중인지, 인터넷 연결이 정상인지 확인하세요. 에이전트 버전과 대시보드의 장치 상태를 확인합니다. 필요한 경우 같은 OS 계정으로 재시작하세요. 오프라인 장치에서는 원격 작업을 실행할 수 없습니다.

npx -y @lhtsoft/remotecommand-agent@latest doctor
설정 가이드

사용 방법

  1. 장치가 오프라인인 경우

    컴퓨터에서 에이전트가 실행 중인지, 인터넷 연결이 정상인지 확인하세요. 에이전트 버전과 대시보드의 장치 상태를 확인합니다. 필요한 경우 같은 OS 계정으로 재시작하세요. 오프라인 장치에서는 원격 작업을 실행할 수 없습니다.

  2. 에이전트 재시작과 업데이트

    현재 작업을 마친 뒤 Ctrl+C로 에이전트를 종료합니다. 최초 등록 때와 같은 OS 계정에서 최신 버전을 실행하세요. 하나의 장치에 에이전트를 중복 실행하지 마세요. 기존 등록 정보는 재사용할 수 있습니다.

    npx -y @lhtsoft/remotecommand-agent@latest run
  3. 명령 차단 또는 npx 오류

    COMMAND_BLOCKED는 장치의 정상적인 보안 정책 때문에 발생할 수 있습니다. 권한 프로필과 허용 폴더를 확인하세요. npx를 찾을 수 없다면 Node.js LTS를 설치하고 터미널을 다시 열어 node 및 npm 실행 여부를 확인합니다.

    node --version
    npm --version

읽기 전용 작업으로 확인

AI 비서에게 list_devices 호출을 요청하고 온라인 장치를 선택한 후 허용된 폴더의 파일을 조회해 보세요. 장치가 온라인이라는 이유만으로 터미널 명령이 허용되지는 않습니다. 거부된 작업은 권한 정책을 확인하세요.

list_devices

자주 묻는 질문

명령이 차단되거나 npx가 실행되지 않으면 어떻게 하나요?

COMMAND_BLOCKED는 장치의 정상적인 보안 정책 때문에 발생할 수 있습니다. 권한 프로필과 허용 폴더를 확인하세요. npx를 찾을 수 없다면 Node.js LTS를 설치하고 터미널을 다시 열어 node 및 npm 실행 여부를 확인합니다.

다음 단계

설치하고 연결하기