본문으로 건너뛰기
MCP · RemoteCommand

AI 도구용 원격 MCP 서버 설정

RemoteCommand MCP 주소를 ChatGPT, Claude 또는 호환 클라이언트에 등록하고 인증하는 방법을 알아보세요. 지원 방식과 권한 제한도 설명합니다.

보안을 위해 현재 지원되는 Node.js LTS 버전(22, 24 또는 26)을 설치하세요. Node.js 18과 20은 보안 업데이트가 종료되었습니다.

원격 MCP 엔드포인트

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

npx -y @lhtsoft/remotecommand-agent@latest
https://api.remotecommand.app/mcp
설정 가이드

사용 방법

  1. 원격 MCP 엔드포인트

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

    https://api.remotecommand.app/mcp
  2. ChatGPT·Claude 및 기타 클라이언트

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

    {
      "mcpServers": {
        "remotecommand": {
          "url": "https://api.remotecommand.app/mcp"
        }
      }
    }
  3. 읽기 전용 작업으로 확인

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

    list_devices

요청과 데이터의 흐름

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

장치별 권한 프로필

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

자주 묻는 질문

원격 MCP 주소를 등록하면 모든 명령이 바로 실행되나요?

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

다음 단계

설치하고 연결하기