본문으로 건너뛰기
MCP · RemoteCommand

Claude에서 RemoteCommand MCP 사용 준비

RemoteCommand 에이전트로 컴퓨터를 등록하고 OAuth 및 권한 설정을 준비하세요. Claude 전용 통합 기능은 아직 공개되지 않았으며 원격 MCP 지원 여부는 클라이언트와 계정에 따라 다릅니다.

Claude 전용 연결 기능은 아직 공개되지 않았습니다. 호환되는 MCP 클라이언트의 수동 연결을 확인하세요.

로컬 에이전트 설치

연결할 컴퓨터에 Node.js LTS를 설치합니다. Windows에서는 PowerShell, macOS와 Linux에서는 터미널에서 공식 에이전트 명령을 실행하세요. 브라우저에서 로그인하고 장치를 등록한 다음 허용 폴더를 지정합니다. 연결 중에는 에이전트를 계속 실행하세요.

설정 가이드

사용 방법

  1. 로컬 에이전트 설치

    연결할 컴퓨터에 Node.js LTS를 설치합니다. Windows에서는 PowerShell, macOS와 Linux에서는 터미널에서 공식 에이전트 명령을 실행하세요. 브라우저에서 로그인하고 장치를 등록한 다음 허용 폴더를 지정합니다. 연결 중에는 에이전트를 계속 실행하세요.

    npx -y @lhtsoft/remotecommand-agent@latest
  2. ChatGPT·Claude 및 기타 클라이언트

    ChatGPT와 Claude에서 MCP 연결을 사용하려면 해당 계정의 커넥터 기능이 필요합니다. Claude의 조직 계정에는 관리자 승인이 필요할 수 있습니다. Cursor 등에서는 원격 MCP 서버 설정을 사용할 수 있으며 구체적인 메뉴는 클라이언트 공식 안내를 확인하세요.

    {
      "mcpServers": {
        "remotecommand": {
          "url": "https://api.remotecommand.app/mcp"
        }
      }
    }
  3. 원격 MCP 엔드포인트

    호환 AI 클라이언트의 Streamable HTTP 방식 원격 MCP 설정에 아래 주소를 입력하세요. 먼저 OAuth 인증과 장치 등록을 완료해야 합니다. 이 주소는 로컬 stdio MCP 서버와 다르며 주소만 등록해도 시스템 전체 권한이 부여되는 것은 아닙니다.

    https://api.remotecommand.app/mcp

읽기 전용 작업으로 확인

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

list_devices

장치별 권한 프로필

Read only는 파일과 Git 조회만 허용합니다. 권장 Standard는 허용 폴더 내 파일 수정도 허용하지만 터미널 명령은 허용하지 않습니다. Custom에서 터미널, 삭제, Docker와 관리자 작업을 개별 설정할 수 있습니다. 승인 및 폴더 제한은 계속 적용됩니다.

요청과 데이터의 흐름

AI 클라이언트의 인증된 도구 요청은 RemoteCommand 중계 서버를 거쳐 선택된 온라인 에이전트로 전달됩니다. 에이전트가 로컬 권한을 검사합니다. 작업 파일은 기기에 남지만 요청된 파일 내용과 명령 출력은 중계 서버와 AI 제공업체를 거칠 수 있습니다.

자주 묻는 질문

Claude 전용 연결 기능은 공개되었나요?

Claude 전용 연결 기능은 아직 공개되지 않았습니다. 호환되는 MCP 클라이언트의 수동 연결을 확인하세요.

다음 단계

설치하고 연결하기