전체 문서 탐색

Gemini MCP 도구에서 Narwhal 쓰기

Antigravity CLI는 Authorization Bearer 헤더와 함께 Streamable HTTP로 Narwhal에 연결할 수 있습니다. 개인 사용자는 Gemini CLI에서 Antigravity CLI로 옮겨 갔으며, 명령어는 agy입니다. Gemini CLI도 아직 쓸 수 있는 환경에서는 자체 설정 형식으로 연결할 수 있습니다.

빠른 시작

  1. https://narwhalapi.com/signup 에서 무료 Narwhal 키를 발급받고, 프롬프트와 URL에는 키를 넣지 마십시오.
  2. Antigravity CLI는 ~/.gemini/config/mcp_config.json 또는 워크스페이스 파일 .agents/mcp_config.json을 여세요.
  3. serverUrl과 Authorization Bearer 헤더가 있는 원격 항목을 추가하고, 파일은 비공개로 유지하세요.
  4. /mcp로 Antigravity 연결을 확인하세요.
  5. Gemini CLI를 쓸 수 있는 환경에서는 -s user로 add 명령을 실행해 키를 사용자 설정에 보관하세요.

MCP 설정

Antigravity CLI는 Streamable HTTP에 serverUrl을, 헤더에 headers 객체를 사용합니다. Gemini CLI의 추가 명령어는 -s user, HTTP 전송 방식, Authorization Bearer 헤더를 사용합니다.

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "narwhal": {
      "serverUrl": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
      }
    }
  }
}
Gemini CLI
gemini mcp add -s user --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

Antigravity CLI 문서에는 헤더의 환경 변수 확장에 대한 설명이 없으므로, 설정 파일에 키 값을 직접 저장합니다. 파일이 사용자 설정에 있든 워크스페이스에 있든 비공개로 유지하고 버전 관리에 올리지 마세요.

제공되는 도구

지원되는 두 CLI 모두 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

프롬프트 예시

  • 일본의 최신 인플레이션 값을 가져오세요.
  • 현재 USD/IDR 환율을 보여주세요.
  • 현재 금 현물 가격을 가져오세요.
  • 미국의 다음 CPI 공식 발표일을 찾아 줘.
  • 올해 인도네시아의 공휴일을 나열하세요.

자주 쓰는 작업 흐름

일본 인플레이션 브리핑 준비하기

일본 인플레이션은 두 CLI 모두에서 economics_get_inflation으로 확인할 수 있습니다. 일본을 선택하면 최신 보고 변동률(퍼센트)을 받습니다.

통화를 환산하기 전에 환율 확인

fx_get_rates로 USD/IDR을 확인하세요. USD를 기준 통화, IDR을 상대 통화로 지정하면 현재 지표 환율을 받습니다.

분석에 쓸 원자재 가격 검토하기

commodities_get_spot_price는 구리와 기준 통화를 받습니다. 결과는 현재 지표 현물 가격입니다.

다음 CPI 발표 시점 확인

economics_list_releases 요청에 미국과 최대 366일의 날짜 범위를 넣으면 다음 공식 CPI 발표일을 찾을 수 있습니다.

팁

  • Antigravity CLI에서는 serverUrl을 사용하세요. httpUrl과 이전 SSE 전송 방식은 지원하지 않습니다.
  • Gemini CLI에서 -s user를 쓰면 키가 ~/.gemini/settings.json에 저장되고, 기본 프로젝트 범위는 저장소의 .gemini/settings.json에 기록됩니다.
  • Gemini CLI 설정은 mcpServers 아래에 httpUrl과 headers가 있는 항목을 사용합니다.

자주 묻는 질문

개인 Gemini 사용자도 Gemini CLI를 계속 쓸 수 있나요?

개인 사용자는 Gemini CLI에서 Antigravity CLI로 옮겨 갔으며, 명령어는 agy입니다. Gemini CLI는 아직 쓸 수 있는 환경에서는 별도의 설정 형식을 사용합니다.

Antigravity CLI는 Narwhal에 어떤 URL 필드를 쓰나요?

Antigravity CLI는 Streamable HTTP 엔드포인트 https://api.narwhalapi.com/mcp와 함께 serverUrl을 사용합니다. headers에 Authorization Bearer 헤더를 추가하고 /mcp로 연결을 확인하세요.

Antigravity가 환경 변수 참조에서 키를 읽을 수 있나요?

문서에는 헤더의 환경 변수 확장에 대한 설명이 없으므로 파일에 키 값을 저장합니다. 사용자 또는 워크스페이스 설정 파일은 비공개로 유지하고 버전 관리에 올리지 마세요.

문제 해결

증상확인
Antigravity CLI에 Narwhal이 표시되지 않습니다사용자 또는 워크스페이스의 mcp_config.json 항목을 확인하고, serverUrl을 쓰는지 확인한 뒤 /mcp를 살펴보세요.
서버가 401 invalid_api_key를 반환합니다헤더에 환경 변수 참조가 확장되지 않은 채로 남아 있지 않은지, 즉 Bearer와 공백, 유효한 키가 들어 있는지 확인하세요.
httpUrl을 쓰는 Antigravity 연결이 실패합니다원격 항목을 serverUrl과 Streamable HTTP로 바꾸세요. Antigravity는 httpUrl과 이전 SSE 전송 방식을 지원하지 않습니다.
Gemini CLI가 더 이상 해당 계정 등급을 지원하지 않습니다개인 계정에는 Antigravity CLI를 사용하고, Gemini CLI 설정 형식 대신 Antigravity CLI의 설정 형식을 따르세요.

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