GitHub Copilot MCP에 경제 데이터 제공

Q: Copilot CLI는 내 Narwhal 키를 어디에 저장하나요?

Copilot CLI는 add 명령 실행 후 키를 ~/.copilot/mcp-config.json에 저장합니다. 이 파일은 비공개로 유지하고 버전 관리에 올리지 말며, 키를 프롬프트나 URL에 붙여 넣지 마세요.

GitHub Copilot은 VS Code 또는 Copilot CLI에서 MCP로 Narwhal을 호출할 수 있으며, 도구는 읽기 전용이고 크레딧은 REST와 MCP가 함께 씁니다. VS Code는 키를 입력받아 안전하게 저장할 수 있습니다. Copilot CLI는 키를 설정 파일에 기록하므로 그 파일을 비공개로 유지하세요.

빠른 시작

https://narwhalapi.com/signup 에서 무료 Narwhal 키를 발급받고, 프롬프트와 URL에는 키를 넣지 마십시오.
Business나 Enterprise에서는 연결하기 전에 관리자가 Copilot 정책에서 MCP 서버를 활성화해야 합니다.
VS Code는 1.99 이상 버전을 사용하고 .vscode/mcp.json에 서버 설정을 추가하세요.
MCP: List Servers로 Narwhal을 시작하고 비밀번호 입력창에 키를 입력하세요.
Copilot CLI는 별도의 add 명령을 사용하고 /mcp show narwhal로 항목을 확인하세요.

MCP 설정

VS Code 설정은 HTTP 항목이 있는 servers 객체와 헤더용 비밀번호 입력을 사용합니다. 별도의 CLI 명령은 같은 호스팅 엔드포인트를 Copilot CLI에 등록합니다.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "NARWHAL_API_KEY",
      "description": "Narwhal API Bearer key",
      "password": true
    }
  ],
  "servers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:NARWHAL_API_KEY}"
      }
    }
  }
}

copilot mcp add --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

VS Code는 서버가 처음 시작될 때 키를 묻고 안전하게 저장합니다. CLI는 키를 ~/.copilot/mcp-config.json에 기록하므로, 이 파일은 비공개로 유지하고 버전 관리에 올리지 마세요.

제공되는 도구

GitHub Copilot은 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 환율 이력을 보여주세요.
조회 가능한 팜유 가격 이력을 가져와 줘.
영국의 다음 공휴일을 찾아보세요.
미국의 최신 GDP 성장률을 가져오세요.

자주 쓰는 작업 흐름

독일의 최신 GDP 관측값 확인

독일의 최신 GDP 관측값은 독일을 선택해 경제 도구 economics_get_gdp를 호출하면 됩니다.

통화쌍의 환율 검토하기

GBP/USD 이력은 GBP를 기준 통화로, ["USD"]를 상대 통화 목록으로 지정한 fx_get_rate_history로 가져옵니다. start_date는 2026-09-08, end_date는 2026-09-14로 설정하세요.

Copilot에서 팜유 데이터 확인

어떤 생과일 다발 시리즈가 필요한가요? commodities_list_palmoil_physical_series로 하나를 선택한 다음, 그 시리즈 ID를 commodities_get_palmoil_physical_observations에 전달하면 고유 기간별 가격을 받습니다.

영국 공휴일에 맞춰 계획하기

영국과 시작 날짜를 calendars_get_next_holiday에 전달하면 그 날짜 이후 처음 공표된 공휴일을 찾을 수 있습니다.

팁

VS Code에서 "password": true가 있는 promptString 유형의 입력을 사용하고, Authorization 헤더에서 ${input:NARWHAL_API_KEY}로 참조하세요.
명령 팔레트에서 MCP: List Servers를 열어 Narwhal을 시작, 중지, 재시작하고 출력을 확인하세요.
세션 밖에서 등록된 서버를 확인하려면 copilot mcp get narwhal로 CLI 항목을 확인하세요.
Business와 Enterprise의 MCP 정책은 기본적으로 꺼져 있으며, Copilot Free, Pro, Pro+, Max에는 적용되지 않습니다.

자주 묻는 질문

VS Code의 GitHub Copilot에 Narwhal을 추가하려면 어떻게 하나요?

HTTP 서버 항목, Narwhal URL, 비밀번호 입력으로 채우는 Authorization 헤더가 있는 .vscode/mcp.json을 만드세요. MCP: List Servers에서 서버를 시작하고 VS Code가 물으면 키를 입력합니다.

Copilot CLI는 내 Narwhal 키를 어디에 저장하나요?

Copilot CLI는 add 명령 실행 후 키를 ~/.copilot/mcp-config.json에 저장합니다. 이 파일은 비공개로 유지하고 버전 관리에 올리지 말며, 키를 프롬프트나 URL에 붙여 넣지 마세요.

Copilot에서 MCP를 쓰려면 관리자가 활성화해야 하나요?

Business와 Enterprise에서는 관리자가 Copilot 정책에서 MCP 서버를 활성화해야 합니다. 이 정책은 기본적으로 꺼져 있으며 Copilot Free, Pro, Pro+, Max에는 적용되지 않습니다.

문제 해결

증상	확인
VS Code에 Narwhal이 표시되지 않습니다	`.vscode/mcp.json`에 `servers` 객체와 `"type": "http"` 항목이 있는지 확인한 뒤 `MCP: List Servers`를 여세요.
호출이 `401 invalid_api_key`를 반환합니다	입력한 키가 유효하고 Authorization 값에 `Bearer`, 공백, 키가 차례로 들어 있는지 확인하세요.
Business 또는 Enterprise 계정에서 MCP가 차단됩니다	관리자에게 Copilot 정책의 MCP 서버를 확인하고 내 계정에 활성화해 달라고 요청하세요.
CLI 항목이 없거나 URL이 잘못되었습니다	`copilot mcp get narwhal`로 확인하고, 끝에 슬래시 없이 정확히 https://api.narwhalapi.com/mcp를 사용하세요.

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