전체 문서 탐색

Claude Code MCP에 경제 데이터 제공

Claude Code는 호스팅된 MCP 연결 하나로 Narwhal 데이터를 요청할 수 있으며, 성공한 도구 호출 한 번이 요청 한 건으로 계산됩니다. Bearer 키를 추가하면 터미널 에이전트를 경제 지표, 환율, 그 밖의 실시간 도구 그룹에 연결할 수 있습니다. 웹이나 Desktop 클라이언트는 별도의 Claude 앱 안내를 따르세요.

빠른 시작

  1. https://narwhalapi.com/signup 에서 무료 키를 받아 NARWHAL_API_KEY로 export하세요.
  2. 모든 프로젝트에서 쓰려면 --scope user, HTTP 전송 방식, Authorization 헤더와 함께 add 명령을 실행하세요.
  3. claude mcp list, claude mcp get narwhal 또는 세션 안의 /mcp로 연결을 확인하세요.

MCP 설정

add 명령은 --scope user로 모든 프로젝트에서 쓸 HTTP 엔드포인트와 Bearer 헤더를 등록합니다. --scope project를 쓰면 Claude Code가 공유 .mcp.json 항목을 작성하며, 여기에는 "type": "http"가 있어야 합니다. URL만 있고 type이 없는 항목은 건너뜁니다.

터미널
claude mcp add --scope user --transport http narwhal https://api.narwhalapi.com/mcp \ --header 'Authorization: Bearer ${NARWHAL_API_KEY}'
.mcp.json
{
  "mcpServers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NARWHAL_API_KEY}"
      }
    }
  }
}

Claude Code는 헤더의 ${NARWHAL_API_KEY}를 확장하므로, 연결하기 전에 실제 키를 환경 변수에 두세요. 공유 .mcp.json의 서버는 대화형 세션에서 승인해야 합니다.

제공되는 도구

Claude Code는 같은 연결로 읽기 전용 도구 그룹을 모두 쓸 수 있습니다. 초기화와 도구 탐색은 무료이며, 도구 호출이 성공할 때마다 호출 1회로 세어 REST와 공유하는 크레딧에서 차감합니다.

그룹요청할 수 있는 내용도구
경제 지표국가별 CPI, 물가상승률, 실업률, 경제활동참가율, GDP, GDP 성장률, 무역 데이터를 요청할 수 있습니다. 제공 범위는 지표마다 다릅니다.economics_get_cpi economics_get_inflation economics_get_unemployment economics_get_labour_force_participation economics_get_gdp economics_get_gdp_growth economics_get_trade economics_get_cpi_history economics_get_inflation_history economics_get_unemployment_history economics_get_labour_force_participation_history economics_get_gdp_history economics_get_gdp_growth_history economics_get_trade_history economics_read_series_observations economics_search_catalogue economics_read_catalogue_series economics_read_catalogue_observations economics_read_catalogue_latest_batch economics_get_policy_rate economics_get_policy_rate_history economics_get_central_bank_reserves economics_get_central_bank_balance_sheet
환율통화쌍의 현재 환율, 과거 환율, 통화 환산, 환율 봉 데이터를 요청할 수 있습니다.fx_get_rates fx_get_rate_history fx_convert_currency fx_get_rate_bars
원자재 가격금, 은, 백금, 팔라듐, 구리, WTI원유, 브렌트유의 현물 가격과 가격 이력, 그리고 실물 팜유 가격(원유 팜유와 신선 과일 다발)을 요청할 수 있습니다.commodities_get_spot_price commodities_get_price_history commodities_list_palmoil_physical_series commodities_get_palmoil_physical_price commodities_get_palmoil_physical_observations commodities_list_physical_series commodities_get_physical_series commodities_get_physical_latest commodities_get_physical_observations
발표 및 이벤트국가별 브리핑을 준비하기 전에 공식 경제 지표 발표일과 이벤트 상세 정보를 요청할 수 있습니다.economics_list_releases economics_get_release events_list events_get
공휴일국가별 공휴일, 특정 날짜의 공휴일, 다음 공휴일을 요청할 수 있습니다.calendars_list_holidays calendars_get_holidays_on_date calendars_get_next_holiday
예측시장 확률스칼라, 극단값, 시점, 이진 결과를 가진 예측 시장의 주제와 이벤트, 그 이력, 기관별 정책 경로를 요청할 수 있습니다.predictions_list_topics predictions_get_topic predictions_list_events predictions_get_scalar predictions_get_extreme predictions_get_timing predictions_get_binary predictions_get_scalar_history predictions_get_extreme_history predictions_get_timing_history predictions_get_binary_history predictions_get_policy_path predictions_get_policy_path_history
국채 수익률같은 Narwhal 연결로 미국, 영국, 독일, 일본, 캐나다, 스웨덴, 노르웨이, 호주, 유로 지역의 국채 수익률 곡선을 요청할 수 있습니다.economics_get_yield_curve economics_get_yield_curve_history

프롬프트 예시

  • 미국의 최신 인플레이션 값을 가져오세요.
  • USD/IDR 환율의 이력을 보여주세요.
  • 현재 GBP/USD 환율로 GBP를 USD로 환산하세요.
  • 미국의 다음 CPI 공식 발표일을 찾아 줘.
  • 조회 가능한 팜유 가격 이력을 가져와 줘.

자주 쓰는 작업 흐름

미국 경제 브리핑 준비하기

최신 미국 인플레이션 값은 얼마인가요? economics_get_inflation에 국가를 지정해 보고된 변동률(퍼센트)을 받으세요.

개발 중 환율 확인

fx_get_rate_history에 USD를 기준 통화로, ["IDR"]를 상대 통화 목록으로 지정하고 start_date를 2026-09-01, end_date를 2026-09-07로 설정하면 과거 환율 관측값을 받습니다.

팜유 가격 이력 검토하기

commodities_list_palmoil_physical_series로 팜유 시리즈를 선택하세요. 그 시리즈 ID를 commodities_get_palmoil_physical_observations에 전달하면 고유 기간별 관측값을 받으며, 범위를 지정할 때는 시작일과 종료일을 함께 입력합니다.

다음 미국 CPI 발표 확인

회의 전에 미국과 최대 366일의 날짜 범위로 economics_list_releases를 호출해 공식 CPI 발표일을 찾아보세요.

팁

  • 서버를 추가하거나 연결하기 전에 Claude Code가 터미널 환경을 사용할 수 있게 하세요. 변수가 설정되지 않으면 참조 문자열 그대로 전송되어 경고가 표시됩니다.
  • 설정을 바꾸기 전에 /mcp로 Connected, Needs authentication, Failed to connect를 구분해 확인하세요.
  • 모든 프로젝트에서 같은 연결을 쓰려면 --scope user를, 프로젝트와 함께 설정을 관리하려면 --scope project를 선택하세요.
  • 끝 슬래시에서 발생하는 리디렉션이 일부 클라이언트를 망가뜨리므로 정확한 URL https://api.narwhalapi.com/mcp를 사용하세요.

자주 묻는 질문

Claude Code가 경제 데이터를 쓰게 하려면 어떻게 하나요?

Authorization Bearer 헤더를 사용하는 HTTP MCP 서버로 Narwhal을 추가하세요. 키를 NARWHAL_API_KEY로 export하고 서버를 연결한 뒤 국가 지표나 과거 시계열을 요청해 보세요.

Claude Code는 내 REST 크레딧을 함께 쓰나요?

예. REST와 MCP는 같은 계정, API 키, 크레딧을 씁니다. 모든 계정은 처음 12개월 동안 매달 $10의 무료 크레딧을 받으며, 단시간 한도는 분당 50건입니다.

프로젝트 설정을 버전 관리에 올려도 되나요?

예. 헤더에 환경 변수 참조를 넣은 .mcp.json 설정을 공유하세요. 실제 키는 파일, 프롬프트, URL에 넣지 말고, claude를 대화형으로 실행해 프로젝트 서버를 승인하세요.

문제 해결

증상확인
서버 목록에 Narwhal이 표시되지 않습니다.mcp.json 항목에 "type": "http"가 있는지 확인한 뒤, claude mcp get narwhal과 선택한 범위를 확인하세요.
서버가 Pending approval 상태로 남아 있습니다claude를 대화형으로 실행하고 .mcp.json의 프로젝트 서버를 승인하세요.
401 invalid_api_key로 연결이 실패합니다claude mcp get narwhal을 확인하고, Claude Code를 시작하는 셸에서 NARWHAL_API_KEY가 export되어 있는지 확인하세요. 키가 틀렸거나 비활성이면 Narwhal이 401 invalid_api_key를 반환합니다.
도구 호출이 402 또는 429 오류를 반환합니다코드가 rate_limit_exceeded인지 insufficient_credits인지 확인한 다음 오류와 크레딧을 따르세요.

이 페이지가 도움이 되었나요?