이 글에서는 Cryptohopper 마켓 데이터 MCP 서버를 Claude 데스크톱 앱(Mac 또는 Windows)에 연결하여 채팅에서 직접 마켓 데이터를 쿼리하는 방법을 안내합니다.

사전 준비

활성화된 Claude 구독
Mac 또는 Windows에 설치된 Claude 데스크톱 앱
Cryptohopper MCP API 키(베어러 토큰) - 사용자 프로필의 MCP API 키 섹션에서 확인 가능 — 또는 OAuth2 인증 사용(키 불필요).

설정

Claude 데스크톱 앱을 엽니다.
설정 → 개발자 → 설정 편집으로 이동합니다. 그러면은 claude_desktop_config.json 파일이 기본 편집기에서 열립니다.
다음 인증 방법 중 하나를 선택하고 해당 구성을 붙여넣습니다. 파일에 이미 mcpServers 블록이 있으면, 그 안에 `Cryptohopper.com Market Data` 항목만 추가합니다.

옵션 A — API 키(베어러 토큰)

`YOUR_REAL_MCP_API_KEY`를 실제 베어러 토큰으로 바꾸세요. 이 토큰은 Cryptohopper 프로필의 MCP API 키 섹션에서 찾을 수 있습니다.

{
  "mcpServers": {
    "Cryptohopper.com Market Data": {
      "type": "http",
      "url": "https://mcp-data.cryptohopper.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_REAL_MCP_API_KEY"
      }
    }
  }
}

옵션 B — OAuth2(API 키 불필요)

{
  "mcpServers": {
    "Cryptohopper.com Market Data": {
      "type": "http",
      "url": "https://mcp-data.cryptohopper.com/mcp"
    }
  }
}

4. 파일을 저장합니다.

5. Claude 데스크톱 앱을 완전히 종료하고 다시 시작합니다 (창을 닫는 것만으로는 충분하지 않습니다).

6. 새 채팅을 열고 MCP/도구 아이콘 아래에 Cryptohopper 도구가 나열되어 있는지 확인합니다.

7. 준비 완료 — 질문을 시작하세요.

작동하지 않나요?

인증 오류: API 키를 사용하는 경우, 베어러 토큰이 올바르고 유효한지 확인하세요. Cryptohopper 프로필의 MCP API 키 섹션에서 다시 생성할 수 있습니다. OAuth2를 사용하는 경우, 프롬프트가 나타났을 때 인증 흐름을 완료했는지 확인하세요.
도구가 표시되지 않음: 앱을 완전히 종료하고 (창만 닫지 말고) 다시 시작하세요. Mac에서는 Cmd + Q를, Windows에서는 시스템 트레이에서 종료하세요.
잘못된 JSON: 설정 파일이 유효한 JSON인지 다시 확인하세요. 쉼표나 괄호가 빠지면 앱이 MCP 서버를 로드하지 못합니다.
서버에 연결할 수 없음: URL이 정확히 https://mcp-data.cryptohopper.com/mcp인지, 그리고 네트워크(방화벽, VPN)에서 연결을 허용하는지 확인하세요.

Claude 데스크톱 앱에서 Cryptohopper MCP를 설정하는 방법은?

사전 준비

설정

작동하지 않나요?