이 아티클에서는 Cryptohopper 마켓 데이터 MCP 서버를 Claude Code에 연결하여 터미널에서 직접 마켓 데이터를 쿼리하는 방법을 보여줍니다.

사전 준비

활성 Claude 구독
Windows 또는 Mac 머신에 Claude Code 설치
Cryptohopper MCP API 키(Bearer 토큰) - 내 프로필의 MCP API 키에서 확인할 수 있으며, OAuth2 인증 사용(키 불필요)도 가능합니다.

설정

컴퓨터에서 터미널을 엽니다:
1. Windows 10: Windows 키 + R을 누르고 cmd를 입력한 후 Enter 키를 누릅니다. 명령 프롬프트가 열립니다.
2. Windows 11: 작업 표시줄의 검색 창을 클릭하거나(또는 Windows 키를 누름) Terminal을 입력한 후 결과에서 Terminal을 클릭합니다. 또는 시작 버튼을 마우스 오른쪽 버튼으로 클릭하고 Terminal을 선택합니다.
3. Mac: Cmd + 스페이스바를 눌러 Spotlight를 열고 Terminal을 입력한 후 Enter 키를 누릅니다.
claude를 실행하고 메시지가 표시되면 Yes, trust this folder를 확인합니다.
다음 인증 방법 중 하나를 선택하고 해당 구성을 붙여넣습니다.

옵션 A — API 키(Bearer 토큰)

YOUR_REAL_MCP_API_KEY 부분을 실제 Bearer 토큰으로 바꿔주세요. 이 토큰은 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. Claude Code에 이렇게 말하세요: "Add to Claude Code settings — install the Cryptohopper Exchange Data MCP server so I can use it in sessions." (Claude Code 설정에 추가 — Cryptohopper Exchange Data MCP 서버를 설치해서 세션에서 사용할 수 있게 해줘.)

5. 설정을 업데이트할지 묻는 메시지가 나오면 Yes, and don’t ask again(네, 다시 묻지 않기)을 선택합니다.

6. project-level(프로젝트 수준)을 선택하고 claude mcp add를 확인합니다. 보안상의 이유로 본인의 기기에서만 Yes, I’m comfortable with that(네, 괜찮습니다)를 선택하세요.

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

작동하지 않나요?

인증 오류: API 키를 사용하는 경우 Bearer 토큰이 올바른지, 만료되지 않았는지 다시 확인하세요. Cryptohopper 프로필의 MCP API 키에서 다시 생성할 수 있습니다. OAuth2를 사용하는 경우 메시지가 표시될 때 인증 흐름을 완료했는지 확인하세요.
서버를 찾을 수 없음: URL이 정확히 https://mcp-data.cryptohopper.com/mcp인지, 설정을 업데이트하라는 메시지가 나왔을 때 Yes를 선택했는지 확인하세요.
MCP가 세션에 나열되지 않음: Claude Code를 다시 시작하고 설치된 MCP 서버에 서버가 나타나는지 확인하세요.

필수 종속성이 누락된 경우: 프롬프트에 추가 도구나 라이브러리가 필요한 경우 먼저 설치한 다음 요청을 다시 시도하세요.

Claude Code에서 Cryptohopper MCP 설정하는 방법?

사전 준비

설정

작동하지 않나요?