Codex MCP에서 경제 데이터 쓰기

Q: Codex에서 API 키로 Narwhal을 쓸 수 있나요?

예. Narwhal 서버 테이블에서 bearer_token_env_var를 NARWHAL_API_KEY로 설정하세요. 실제 키는 Codex를 실행하는 환경에서 export하면 Codex가 Authorization Bearer 헤더를 보냅니다.

Codex는 MCP로 Narwhal 데이터를 요청할 수 있으며, CLI, IDE 확장, 데스크톱 앱이 하나의 설정을 함께 씁니다. Bearer 토큰 환경 변수를 설정해 경제 지표, 환율, 그 밖의 실시간 그룹에 연결하세요. REST와 MCP는 같은 계정 크레딧을 쓰며, 호출이 성공할 때마다 호출 1회로 셉니다.

빠른 시작

https://narwhalapi.com/signup 에서 무료 키를 받아 NARWHAL_API_KEY로 export하세요.
모든 프로젝트에 적용하려면 ~/.codex/config.toml을, 신뢰하는 프로젝트 안에서는 .codex/config.toml을 여세요.
Narwhal 서버 테이블에 URL과 변수 이름으로 설정한 bearer_token_env_var를 추가하세요.
키를 export한 환경에서 Codex를 시작하고 특정 지표나 환율을 요청하세요.

MCP 설정

[mcp_servers.narwhal] 테이블에는 호스팅 URL과 키를 담은 환경 변수 이름을 지정합니다. bearer_token_env_var에 NARWHAL_API_KEY를 넣으면 Codex가 값을 읽어 Authorization Bearer 헤더로 보냅니다.

[mcp_servers.narwhal]
url = "https://api.narwhalapi.com/mcp"
bearer_token_env_var = "NARWHAL_API_KEY"

공유 사용자 설정은 ~/.codex/config.toml에 있고, 신뢰하는 프로젝트는 자체 .codex/config.toml을 둘 수 있습니다. 키는 Codex를 시작하는 프로세스의 환경에 두고, 파일에는 변수 이름만 남기세요.

제공되는 도구

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

프롬프트 예시

미국의 최신 GDP 성장률을 가져오세요.
영국의 인플레이션 이력을 보여주세요.
현재 USD/IDR 환율을 가져오세요.
일본의 다음 공휴일을 찾아보세요.
현재 금 현물 가격을 가져오세요.

자주 쓰는 작업 흐름

호주 브리핑에 필요한 지표 모으기

economics_get_cpi_history는 호주 CPI를 기간별로 가져오며, 해당 시리즈의 지수 기준 시점이 함께 표시됩니다.

개발 중 통화쌍 확인

fx_get_rate_bars에 USD를 기준 통화, IDR을 상대 통화로 전달하면 기본 일간 간격의 마감된 바를 받습니다. 필수 값인 start는 2026-09-15, end는 2026-09-21로 설정하세요.

다음 미국 CPI 발표 검토하기

회의 전에 어떤 미국 CPI 발표가 있나요? economics_list_releases에 국가와 최대 366일의 날짜 범위를 지정하면 공식 일정 항목을 받을 수 있습니다.

분석 전에 원자재 가격 확인

은 현물 가격은 commodities_get_spot_price로 가져오며, 요청에 은과 기준 통화를 지정합니다.

팁

codex mcp add로 서버를 등록했다면, 문서에 나온 add 명령에는 Bearer 토큰 플래그가 없으므로 이후 설정에 bearer_token_env_var를 추가하세요.
연결하기 전에 Bearer 변수를 설정하세요. 그렇지 않으면 Codex가 기본적으로 OAuth 로그인을 시도하며, Narwhal에는 MCP용 OAuth 로그인이 없습니다.
프롬프트, 설정 값, URL에 키를 넣지 마세요. 설정에는 환경 변수 이름만 필요합니다.
리디렉션이 일부 클라이언트를 망가뜨리지 않도록, 끝에 슬래시 없이 정확한 엔드포인트 https://api.narwhalapi.com/mcp를 사용하세요.

자주 묻는 질문

Codex에서 API 키로 Narwhal을 쓸 수 있나요?

예. Narwhal 서버 테이블에서 bearer_token_env_var를 NARWHAL_API_KEY로 설정하세요. 실제 키는 Codex를 실행하는 환경에서 export하면 Codex가 Authorization Bearer 헤더를 보냅니다.

Codex CLI와 데스크톱 앱을 따로 설정해야 하나요?

아니요. CLI, IDE 확장, 데스크톱 앱은 Codex 설정을 공유합니다. 사용자 파일은 모든 프로젝트에 적용되고, 신뢰하는 프로젝트는 자체 설정 파일을 쓸 수 있습니다.

서버를 추가하면 OAuth 로그인이 시작되나요?

Codex는 기본적으로 OAuth를 시도하지만, Bearer 변수를 설정하면 토큰을 보냅니다. Narwhal은 해당 키가 필요하고 MCP용 OAuth 로그인이 없으므로, 연결하기 전에 변수를 확인하세요.

문제 해결

증상	확인
Codex에 Narwhal이 표시되지 않습니다	사용자 설정에 `[mcp_servers.narwhal]`이 있는지, 또는 `.codex/config.toml`이 있는 프로젝트를 신뢰하고 있는지 확인하세요.
Narwhal이 `401 invalid_api_key`를 반환합니다	키가 없거나 잘못되면 Narwhal이 `401 invalid_api_key`를 반환합니다. Codex를 시작하는 셸에서 `NARWHAL_API_KEY`가 export되어 있는지 확인하세요.
Codex가 OAuth 로그인을 열려고 합니다	서버 테이블에 `bearer_token_env_var`를 추가하고, Codex를 시작하기 전에 해당 환경 변수를 설정하세요.
add 명령이 URL은 등록했지만 호출이 실패합니다	`config.toml`을 열고 Bearer 변수 설정을 추가하세요. 문서에 나온 add 명령은 이 자격 증명 설정 없이 URL만 등록합니다.

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