이 글에서는 Cryptohopper 마켓 데이터 MCP 서버를 Claude Code에 연결하여 터미널에서 직접 마켓 데이터를 쿼리하는 방법을 알려줄게.
필수 조건
활성화된 Claude 구독
Cryptohopper MCP API 키(bearer 토큰) — 사용자 프로필의 MCP API 키 섹션에서 찾을 수 있음 — 또는 OAuth2 인증 사용(키 필요 없음).
설정
컴퓨터에서 터미널을 열어:
Windows 10: Windows 키 + R을 누르고
cmd를 입력한 후 Enter를 누르세요. 명령 프롬프트가 열립니다.Windows 11: 작업 표시줄의 검색창을 클릭하거나 (Windows 키를 누르세요)
Terminal을 입력한 후 결과에서 Terminal을 클릭하세요. 또는 시작 버튼을 마우스 오른쪽 버튼으로 클릭하고 Terminal을 선택하세요.Mac: Cmd + Spacebar를 눌러 Spotlight를 열고
Terminal을 입력한 후 Enter를 누르세요.
claude를 입력하고 Enter를 누르세요. 메시지가 표시되면 네, 이 폴더를 신뢰합니다를 확인하세요.
다음 인증 방법 중 하나를 선택하고 해당 구성을 붙여넣으세요:
옵션 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에 이렇게 말하세요: "Claude Code 설정에 추가 — Cryptohopper Exchange Data MCP 서버를 설치하여 세션에서 사용할 수 있도록 해주세요."
5. 설정을 업데이트할지 묻는 메시지가 나오면 네, 다시 묻지 마세요를 선택하세요.
6. 프로젝트 수준을 선택하고 claude mcp 추가를 확인하세요. 보안상의 이유로 자신의 기기에서만 네, 괜찮습니다를 선택하세요.
7. 이제 준비되었습니다 — 질문을 시작하세요.
작동하지 않나요?
Claude Code가 아직 설치되지 않은 경우: Claude Code가 올바르게 설치되었는지 확인하세요. 자세한 내용은 "터미널에서 Claude Code 설치 방법" 기사를 확인하세요.
인증 오류: API 키를 사용하는 경우 bearer 토큰이 올바르고 만료되지 않았는지 다시 확인하세요. Cryptohopper 프로필의 MCP API 키 섹션에서 다시 생성할 수 있습니다. OAuth2를 사용하는 경우 메시지가 표시될 때 인증 흐름을 완료했는지 확인하세요.
서버를 찾을 수 없음: URL이
https://mcp-data.cryptohopper.com/mcp로 정확한지, 그리고 설정을 업데이트하라는 메시지가 표시될 때 Yes를 선택했는지 확인하세요.세션에 MCP가 나열되지 않음: Claude Code를 다시 시작하고 설치된 MCP 서버 아래에 해당 서버가 나타나는지 확인하세요.
인증을 계속 다시 요청받는 경우: OAuth 로그인 시 발생할 수 있습니다. API 키가 도움이 될 수 있지만, 구독을 사용하는 대신 API를 통해 별도로 청구된다는 점에 유의하세요.
누락된 종속성: 프롬프트에 추가 도구나 라이브러리가 필요한 경우 먼저 설치한 다음 요청을 다시 시도하세요.