사용 방법
로컬 에이전트 설치
연결할 컴퓨터에 Node.js LTS를 설치합니다. Windows에서는 PowerShell, macOS와 Linux에서는 터미널에서 공식 에이전트 명령을 실행하세요. 브라우저에서 로그인하고 장치를 등록한 다음 허용 폴더를 지정합니다. 연결 중에는 에이전트를 계속 실행하세요.
npx -y @lhtsoft/remotecommand-agent@latestChatGPT·Claude 및 기타 클라이언트
ChatGPT와 Claude에서 MCP 연결을 사용하려면 해당 계정의 커넥터 기능이 필요합니다. Claude의 조직 계정에는 관리자 승인이 필요할 수 있습니다. Cursor 등에서는 원격 MCP 서버 설정을 사용할 수 있으며 구체적인 메뉴는 클라이언트 공식 안내를 확인하세요.
{ "mcpServers": { "remotecommand": { "url": "https://api.remotecommand.app/mcp" } } }원격 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 클라이언트의 수동 연결을 확인하세요.