중요: 여러 개의 키를 생성한다고 해서 주간 할당량이 늘어나는 것은 아닙니다. 계정의 모든 키는 동일한 주간 제한을 공유합니다. 여러 키의 목적은 할당량 곱셈이 아니라 세분화(독립적인 회전, 속성 부여, 취소)입니다.
사전 요구 사항
설정 단계
키 생성 전에 세분화 계획하기
각 키는 하나의 논리적 소비자에게 해당되어야 합니다. 일반적인 패턴:
- 에이전트별 키: daily-digest, volume-scanner, research-assistant.
- 환경별 키: prod-agent, staging-agent, dev-laptop.
- 소규모 팀의 경우 인원별 키.
key-1 또는 temp와 같은 이름은 피하세요. 목적이 불분명한 키는 시간이 지남에 따라 보이지 않는 위험이 됩니다.
Cryptohopper 계정 인터페이스에서 키 생성
각 키에 대해 Cryptohopper MCP API 키 얻는 방법을 따르세요. 1단계에서 계획한 대로 정확하게 이름을 지정하세요.
각 키를 의도된 소비자에게만 배포
daily-digest 키는 다이제스트를 실행하는 cron 스크립트에만 전달됩니다. volume-scanner 키는 스캐너의 예약된 작업에만 전달됩니다. research-assistant 키는 Claude 데스크톱 또는 Claude Code 구성에만 전달됩니다. 동일한 키를 여러 곳에 붙여넣지 마세요. 이는 세분화가 손실된 것입니다.
에이전트별 스로틀링 구현
모든 키는 할당량을 공유하므로 제대로 작동하지 않는 에이전트가 다른 에이전트에 영향을 줄 수 있습니다. 각 에이전트가 자체 주간 호출 수를 로컬에서 추적하고 설정된 예산을 초과하면 계속 진행하지 않도록 합니다. MCP는 계정 수준 제한을 시행하며, 사용자는 에이전트별 분할을 시행합니다.# 각 에이전트의 실행 루프 내부
agent_name = "daily-digest"
weekly_budget = 2000 # 이 에이전트에 대한 주간 호출 단위
current_weekly_usage = load_local_counter(agent_name)
if current_weekly_usage > weekly_budget:
log(f"{agent_name} 이번 주 예산 초과, 실행 건너뜀")
return
result = run_mcp_workflow()
current_weekly_usage += result.calls_consumed
save_local_counter(agent_name, current_weekly_usage)회전 일정 설정
키 회전은 방어적인 위생입니다. 간단한 시작 규칙: 각 키를 90일마다 회전하며, 가장 오래된 키부터 회전하여 한 달에 최대 하나의 키만 변경되도록 합니다. API 키 보안 모범 사례를 참조하세요.
키 인벤토리 유지 관리
모든 키, 목적, 생성 날짜, 배포 위치를 나열하는 작은 텍스트 파일 또는 Notion 페이지입니다. 모든 회전 또는 취소 시 업데이트합니다. 인벤토리가 실제와 달라지면 양쪽을 모두 감사합니다.
샘플 키 인벤토리
이름 | 생성일 | 배포 위치 | 마지막 회전 |
daily-digest | 2026-02-01 | GitHub Actions repo X | 2026-04-01 |
volume-scanner | 2026-02-15 | 홈 서버 cron | 2026-04-01 |
research-assistant | 2026-03-10 | Claude 데스크톱 (노트북) | 없음 |
매월 인벤토리가 Cryptohopper 계정 패널과 일치하는지 확인하세요.
비용 프로필
키 생성, 회전 또는 취소는 할당량을 소비하지 않습니다. 키당 비용은 없습니다. 키는 속성 부여만을 제공합니다. 속도 제한 설명을 참조하세요.
문제 해결
등급의 키 제한에 도달했습니다.
모험가는 3개, 영웅은 10개의 키를 허용합니다. 업그레이드하거나 통합하세요. 즉, 에이전트 수를 줄이거나 키를 재사용하세요. 대부분의 사용자는 3개 이상 필요하지 않습니다.
하나의 에이전트가 갑자기 주간 할당량을 모두 소진했습니다.
Cryptohopper MCP 지출 모니터링 방법을 통해 사용량을 확인하고, 키별 로컬 로그를 사용하여 원인을 파악한 후, 클라이언트 측에서 스로틀링하거나 키를 일시적으로 취소하세요.
키를 회전했지만 소비자가 여전히 이전 키를 사용하고 있습니다.
이전 키는 새 키를 배포할 때까지 UNAUTHORIZED로 반환됩니다. 이것이 소비자별 별도 키의 장점입니다. 하나의 키를 회전해도 다른 키에는 영향을 주지 않습니다. 회전이 일상적인 절차가 되도록 배포 체크리스트를 유지하세요.
어떤 키가 어떤 호출을 했는지 알 수 없습니다.
MCP는 계정 수준에서 사용량을 보고합니다. 키별 속성 부여는 로컬 로깅이 필요합니다. 즉, 각 소비자는 자신이 호출하는 내용을 로깅합니다. 무인으로 실행하는 에이전트에는 로깅을 필수로 설정하세요.
팀원이 퇴사했는데 어떤 키가 그들의 것인지 모릅니다.
이것이 인벤토리가 중요한 이유입니다. 퇴사한 팀원과 관련된 모든 키는 즉시 취소하세요. 누구의 키인지 알 수 없다면 해당 사용자의 프로젝트가 소유한 모든 키를 취소하고 새 키로 다시 배포하세요.
외부 계약자 또는 협력자에게 키를 제공해야 합니다.
Cryptohopper MCP 키는 읽기 전용이지만 주간 할당량을 소비합니다. 클라이언트 측 스로틀링 로직에서 해당 키에 대한 엄격한 예산을 설정하고 계약 종료 시 적극적으로 취소하세요.
Cryptohopper에서 직접 키별 사용량 분석을 원합니다.
현재 사용량 엔드포인트는 계정 수준 수치만 보고합니다. 키별 속성 부여를 위해서는 로컬 로깅이 유일한 경로입니다. 에이전트가 많은 경우, 로컬 로그를 집계하는 내부 대시보드를 구축하는 것을 고려해 보세요.