전체 문서 탐색

Cursor MCP로 경제 데이터 가져오기

Cursor는 원격 MCP 서버를 통해 Narwhal을 호출할 수 있으며, API 키와 크레딧은 REST와 MCP가 함께 씁니다. Cursor를 시작하기 전에 환경 변수에 키를 저장한 뒤 작업하면서 경제 데이터를 요청하세요. 같은 연결로 환율, 원자재 데이터, 그 밖의 실시간 도구 그룹도 쓸 수 있습니다.

빠른 시작

  1. https://narwhalapi.com/signup 에서 무료 키를 받으세요.
  2. Cursor를 시작하기 전에 셸 프로필이나 시스템 환경에 NARWHAL_API_KEY를 설정하세요.
  3. 해당 프로젝트에만 적용하려면 .cursor/mcp.json에, 모든 프로젝트에 적용하려면 ~/.cursor/mcp.json에 원격 서버 설정을 추가하세요.
  4. 사이드바의 Customize에서 Narwhal을 활성화하고 Available Tools를 확인하세요.

MCP 설정

원격 항목은 url과 headers를 사용하며, Authorization 헤더에 ${env:NARWHAL_API_KEY}를 넣습니다. Cursor는 환경에서 이 참조를 읽으며, 원격 MCP 서버는 envFile을 지원하지 않습니다.

.cursor/mcp.json
{
  "mcpServers": {
    "narwhal": {
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NARWHAL_API_KEY}"
      }
    }
  }
}

필요한 범위에 따라 프로젝트 파일이나 사용자 파일에 설정을 두세요. 시스템이나 셸 환경을 바꾼 뒤에는 Cursor를 다시 시작해 연결하기 전에 프로세스가 키를 갖게 하세요.

제공되는 도구

Cursor는 Narwhal 연결 하나로 읽기 전용 도구 그룹을 모두 쓸 수 있습니다. 초기화와 도구 탐색은 무료이고, 도구 호출이 성공할 때마다 호출 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

프롬프트 예시

  • 캐나다의 최신 실업률을 가져오세요.
  • 현재 GBP/USD 환율을 보여 줘.
  • 조회 가능한 팜유 가격 이력을 가져와 줘.
  • 미국의 다음 CPI 공식 발표일을 찾아 줘.
  • 올해 일본의 공휴일을 나열해 줘.

자주 쓰는 작업 흐름

기간별 캐나다 실업률 추적하기

Cursor에 economics 그룹의 economics_get_unemployment_history로 캐나다의 실업률 관측값을 요청하세요. 이력에는 기간별 관측값이 나열됩니다.

환산 전에 환율 확인

현재 GBP/USD 환율이 필요한 값인가요? GBP를 기준 통화, USD를 상대 통화로 지정해 fx_get_rates를 호출하세요.

Cursor에서 팜유 이력 확인

Cursor에 commodities_list_palmoil_physical_series로 팜유 시계열을 찾게 한 다음, 선택한 시리즈 ID로 commodities_get_palmoil_physical_observations를 호출해 기간별 관측값을 읽게 하세요.

발표일 중심으로 브리핑 계획하기

economics_list_releases로 브리핑을 계획하세요. 미국을 선택하고 366일을 넘지 않는 범위를 지정합니다. 결과에는 예정된 발표 날짜와 시간이 포함됩니다.

팁

  • Cursor가 특정 작업을 쓰게 하려면 도구 이름으로 요청하거나, 필요한 데이터를 설명한 뒤 Available Tools를 확인하세요.
  • 공유되는 프로젝트 파일이어도 헤더의 환경 변수 참조를 써서 실제 키는 .cursor/mcp.json에 넣지 마세요.
  • 연결 오류의 자세한 내용이 필요하면 Cmd+Shift+U로 Output 패널을 열고 MCP Logs를 선택하세요.
  • 프로젝트 상황에 맞게 Narwhal 서버를 활성화, 비활성화, 관리하려면 사이드바의 Customize를 사용하세요.

자주 묻는 질문

Cursor를 Narwhal MCP에 연결하려면 어떻게 하나요?

Cursor MCP 설정에 Narwhal URL과 Authorization Bearer 헤더가 있는 원격 서버 항목을 추가하세요. Cursor를 시작하기 전에 NARWHAL_API_KEY를 설정하고, 서버를 활성화한 뒤 Available Tools를 확인하세요.

Cursor가 envFile에서 키를 불러올 수 있나요?

아니요. Cursor의 원격 서버는 envFile을 지원하지 않습니다. 셸 프로필이나 시스템 환경에 변수를 설정하고, 헤더에서 ${env:NARWHAL_API_KEY}로 참조하세요.

Cursor에서 Narwhal 호출 비용은 얼마인가요?

성공한 도구 호출은 각각 한 건으로 계산되며 검색은 무료입니다. 모든 계정은 처음 12개월 동안 매달 $10의 무료 크레딧을 받고, 단시간 한도는 분당 50건입니다.

문제 해결

증상확인
Available Tools에 Narwhal이 표시되지 않습니다프로젝트 또는 사용자의 .cursor/mcp.json을 확인한 다음, 사이드바의 Customize에서 서버를 활성화하세요.
연결이 401 invalid_api_key를 반환합니다실행 중인 Cursor 환경의 NARWHAL_API_KEY에 유효한 키가 들어 있는지 확인한 뒤 Cursor를 다시 시작하세요.
원격 서버가 envFile을 읽을 수 없습니다변수를 셸 프로필이나 시스템 환경으로 옮기고, Authorization 헤더에 ${env:NARWHAL_API_KEY}를 사용하세요.
URL을 수정한 뒤 연결이 실패합니다끝에 슬래시 없이 정확히 https://api.narwhalapi.com/mcp를 사용한 다음, Output 패널의 MCP Logs를 확인하세요.

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