이 콘텐츠는 기계 번역된 것입니다. 기계 번역 부인정보를 참조하십시오.
영어로 전환

How to set up MCP Assistant for Claude to operate my NAS with natural language commands?
Claude가 자연어 명령으로 NAS를 작동하도록 MCP Assistant를 설정하는 방법은 무엇입니까?


최신 업데이트일: 2025-08-15

QNAP MCP Assistant을 Claude Desktop과 함께 설정하는 방법은 무엇입니까?적용되는 제품

  • QTS 5.2, QuTS hero h5.2 또는 이후 버전을 실행하는 QNAP NAS 장치
  • MCP Assistant

소개

이 튜토리얼은 QNAP NAS와 Claude의 AI 기능 간의 원활한 통합을 가능하게 하는 Claude Desktop과 함께 QNAP의 MCP Assistant를 설정하는 과정을 안내합니다. 그런 다음 자연어 명령을 사용하여 NAS를 운영할 수 있습니다.


필수 조건

시작하기 전에 다음 설정을 확인하십시오:

  • QTS 5.2, QuTS hero h5.2 또는 이후 버전을 실행하는 QNAP NAS 장치
  • 인터넷 연결이 가능한 컴퓨터(Windows 또는 macOS; Claude Desktop은 Linux에서 사용할 수 없음)
  • QNAP NAS에 대한관리자액세스
  • 기본 MCP Assistant 포트: 8442 및 8443

절차

  1. App Center에서 MCP Assistant(베타)를 설치합니다.
    1. NAS가 QTS/QuTS hero 5.2.1 이상 버전을 실행하는 경우:
      1. QNAP NAS에 로그인합니다.
      2. 로 이동합니다App Center.
      3. 오른쪽 위 모서리에서 클릭합니다 
      4. 선택QNAP 앱 베타 프로그램에 가입합니다 그리고 클릭합니다 적용.
      5. 검색 창에서 검색합니다MCP Assistant.
      6. 클릭합니다설치.
    2. NAS가 QTS/QuTS hero 5.2.0을 실행하는 경우:
      1. App Center의 웹페이지로 이동합니다.
      2. 검색합니다MCP Assistant.
      3. 클릭합니다MCP Assistant검색 결과에서.
      4. NAS 모델을 선택합니다.
      5. 설치 파일을 다운로드합니다.
      6. QNAP NAS에 로그인합니다.
      7. App Center로 이동합니다.
      8. 오른쪽 위 모서리에서 클릭합니다 
      9. 선택수동으로 설치합니다.
      10. 클릭합니다Browse(찾아보기)QNAP 웹사이트에서 방금 다운로드한 설치 파일을 업로드합니다.
      11. 클릭합니다.설치합니다.
  2. MCP Assistant을 엽니다.
    1. 메인 메뉴에서 MCP Assistant을 찾습니다.
    2. MCP Assistant을 실행합니다.
       
  3. 자격 증명을 생성하고 MCP Server를 다운로드합니다.
    1. MCP Assistant에서자격 증명탭으로 이동합니다.
    2. 클릭합니다.생성새 키를 생성합니다.
    3. 키에 대한 설명 이름을 입력하고 키 유형을 선택한 후 이 키와 연결할 사용자 계정을 선택합니다.
      기본적으로읽기 전용 모드가 활성화되어 있습니다. 신뢰할 수 있는 사용자에게 더 많은 권한을 부여하려면 이 옵션의 선택을 해제할 수 있습니다.
    4. 사용자가 액세스할 수 있는 MCP 도구를 지정합니다.
    5. 클릭합니다.생성키 생성을 완료합니다.
    6. 키가 생성된 후에는작업 아래의 다운로드 화살표를 클릭합니다. 
      • 키 및 MCP Server 다운로드대화 상자가 나타나며, 인증 키와 MCP Server 파일을 컴퓨터에 다운로드할 수 있습니다.
         
         
         
    7. 운영 체제를 선택합니다:
      • Windows– Windows 기반 컴퓨터용
      • macOS (M1 이상)– Apple Silicon Macs용
      • macOS (Intel)– Intel 기반 Macs용
      • Linux– Claude Desktop은 Linux에서 사용할 수 없으며 다른 MCP 호스트를 사용하십시오.
      • 운영 체제에 맞는 버튼을 클릭하여 패키지를 다운로드합니다. 이 패키지에는 사용자 키와 MCP Server 파일이 모두 포함되어 있습니다.
  4. MCP Server ZIP 패키지를 추출합니다.
    1. 다운로드한 파일을 찾습니다:
      • 파일 이름은 다양할 수 있습니다(예: qmcp-darwin-arm64-250630_1502.zip).
      • Downloads 폴더 또는 선택한 위치를 확인합니다.
    2. ZIP 파일을 추출합니다:
      • Windows:ZIP 파일을 마우스 오른쪽 버튼으로 클릭하고모두 추출또는 선호하는 추출 도구를 사용합니다.
      • macOS:ZIP 파일을 더블 클릭하여 자동으로 추출하거나 The Unarchiver와 같은 도구를 사용합니다.
    3. 추출 확인:
      • MCP Server 실행 파일과 구성 파일이 포함된 폴더가 표시됩니다.
      • 폴더 경로를 확인합니다. Claude Desktop 구성에 필요합니다.
        중요
        나중에 구성 단계에서 사용할 수 있도록 추출된 폴더 위치를 추적합니다.
  5. Claude Desktop을 다운로드합니다.
    1. 공식 Anthropic 웹사이트를 방문합니다claude.ai.
    2. Claude Desktop 다운로드 섹션으로 이동합니다.
    3. 운영 체제에 맞는 설치 관리자를 다운로드합니다:
      • Windows: .exe 설치 관리자를 다운로드합니다.
      • macOS: .dmg 설치 관리자를 다운로드합니다.
  6. Claude Desktop을 설치합니다.
    1. Windows:
      • 다운로드한 .exe 설치 관리자를 실행합니다.
      • 설치 마법사의 지침을 따르고라이선스계약을 수락합니다.
      • 설치 위치를 선택하고 프로세스를 완료합니다.
    2. macOS:
      • 다운로드한 .dmg 파일을 엽니다.
      • Claude Desktop을 Applications 폴더로 드래그합니다.
      • 메시지가 표시되면시스템 기본 설정 > 보안 및 개인정보로 이동합니다.애플리케이션 실행을 허용합니다.
  7. Claude Desktop을 엽니다.
    1. 바탕 화면 바로 가기에서 Claude Desktop을 실행합니다.
    2. Claude를 처음 실행하는 경우:
      • Anthropic 계정으로 로그인합니다.
      • 초기 설정 절차를 완료합니다.
      • 메시지가 표시되면서비스 조건을(를) 수락합니다.
  8. Claude Desktop의 구성을 편집합니다.

    1. 구성 파일을 찾습니다:
      • Claude Desktop UI를 사용합니다:메뉴 (왼쪽 상단) > 설정 > 개발자 > 구성 편집.
      • 구성 파일을 여기에서도 찾을 수 있습니다:
        • Windows:%APPDATA%\Claude\claude_desktop_config.json
        • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
           
           

    2. 파일을 편집합니다:

      • 텍스트 편집기(예: Notepad++, VS Code, TextEdit)에서 엽니다.
      • MCP Assistant 대화 상자에 표시된 대로 MCP 서버 구성을 추가합니다. 예를 들어:

        {
          "mcpServers": {
            "qnap-nas": {"command": "/path/to/qmcp-folder/qmcp"}
          }
        }
      • 다음으로 대체 /path/to/qmcp-folder/qmcp 추출된 MCP 서버 실행 파일의 실제 경로로 대체합니다.

      • Windows에서는 단일 백슬래시(\) 대신 이중 백슬래시(\\)를 사용합니다. 예를 들어:C:\\Users\\YourName\\Downloads\\qmcp-folder\\qmcp.exe.
    3. 구성 파일을 저장합니다.

  9. MCP 서버 실행을 허용합니다.

    1. macOS 사용자:
      • MCP 서버 실행 파일을 실행할 때 보안 경고가 표시될 수 있습니다. 클릭합니다완료경고를 닫습니다.
      • 이동합니다Apple메뉴 > 시스템 설정 > 개인 정보 및 보안 > 보안.
      • 클릭어쨌든 허용차단된 qmcp 실행 파일 옆에.
      • 위험을 피하기 위해 신뢰할 수 있는 출처의 실행 파일만 허용합니다.
         
         
         
    2. Windows 사용자:
      • 바이러스 백신 또는방화벽소프트웨어가 MCP 서버 실행 파일을 차단하지 않도록 합니다.
      • 필요한 경우 예외를 추가합니다.
  10. Claude Desktop을 다시 열고 설정을 테스트합니다.
    1. 이전 구성을 로드하려면 Claude Desktop을 완전히 종료하고 다시 엽니다.
      1. macOS: 앱을 강제 종료하거나 활동 모니터에서 앱을 닫습니다.
      2. Windows: 작업 관리자를 열고 앱을 찾아 선택합니다.작업 종료.

        이 방법이 작동하지 않으면 컴퓨터를 다시 시작합니다.

    2. 다음과 같은 프롬프트로 테스트합니다:
      • 내 QNAP NAS에 액세스할 수 있습니까?
      • 내 NAS 스토리지의 상태를 보여주세요.
      • 내 공유 폴더의 파일 목록을 보여주세요.
    3. Claude가 NAS와 관련된 성공적인 상호작용을 응답하는지 확인합니다.
    4. 오류가 나타나면 사용자 인터페이스에서 세부 정보를 확인합니다.

문제 해결 팁

아래는 일반적인 문제를 빠르게 해결하기 위한 팁입니다.

  • 연결 문제:구성 파일에서 MCP 서버 경로가 올바른지 확인합니다.
  • 권한 오류:MCP 서버 실행 파일에 적절한 권한이 있는지 확인합니다.
  • 인증 문제:MCP Assistant의 인증 키가 올바른 위치에 있는지 확인합니다.
  • 방화벽차단: 귀하의방화벽가 MCP 서버 통신을 허용하는지 확인합니다.

결론

QNAP MCP Assistant를 Claude Desktop과 성공적으로 설정했습니다. 이제 Claude의 AI 기능을 활용하여 자연어 명령을 통해 QNAP NAS와 상호작용할 수 있으며, 파일 관리 및 시스템 모니터링을 포함합니다.

이 기사가 도움이 되었습니까?

100% 의 사용자들이 도움이 된다고 생각할 것입니다.
피드백을 주셔서 감사드립니다.

이 기사가 어떻게 개선될 수 있을지 말해 주십시오.

추가 피드백을 제공하려면 아래에 포함하십시오.

사양 선택

      더 보기 적게 보기

      다른 국가/지역 사이트:

      open menu
      back to top