Claude 앱 MCP를 Narwhal에 연결하기

Q: Claude 앱에 Narwhal API 키를 어떻게 전달하나요?

「No sign-in」을 선택하고 「Request headers」에 authorization을 추가한 뒤 값으로 Bearer YOUR_KEY를 입력합니다. Claude는 그 값을 그대로 보내므로 키 앞에 Bearer라는 단어와 공백을 넣어야 합니다.

조직에서 「Request headers」를 사용할 수 있으면 Claude 앱을 Narwhal에 연결할 수 있습니다. 이 기능은 일부 조직에만 제공되는 베타입니다. 「No sign-in」을 선택하고 API 키를 authorization 헤더로 추가합니다. 「Add custom connector」 대화상자에 「Request headers」가 없다면 Claude Code를 대신 사용하십시오. Narwhal은 MCP용 OAuth 로그인을 제공하지 않기 때문입니다.

빠른 시작

https://narwhalapi.com/signup 에서 무료 Narwhal 키를 발급받고, 프롬프트와 URL에는 키를 넣지 마십시오.
「Claude web」 또는 「Desktop」에서 「Customize」, 「Connectors」, 「Add custom connector」 순서로 엽니다.
정확한 MCP URL을 입력하고 「No sign-in」을 선택한 다음 「Request headers」를 찾습니다.
authorization을 추가하고 값에 Bearer YOUR_KEY를 입력합니다. Bearer라는 단어와 공백을 반드시 포함한 뒤 저장합니다.
채팅에서 더하기 버튼을 선택하고 「Connectors」 아래의 Narwhal을 켭니다.

MCP 설정

커넥터에는 HTTPS 서버 URL, 「No sign-in」 인증 방식, authorization 요청 헤더가 필요합니다. Claude는 헤더 값을 입력한 그대로 보내고 접두어를 붙이지 않으므로, 키 앞에 Bearer와 공백을 직접 넣어야 합니다.

MCP 서버 URL: https://api.narwhalapi.com/mcp 인증: 로그인 없음 요청 헤더: authorization 헤더 값: Bearer YOUR_NARWHAL_API_KEY 필수: 예

Claude는 헤더 값을 안전하게 저장하며 저장 후에는 다시 표시하지 않습니다. 인증 설정은 나중에 수정할 수 없으므로, 변경이 필요하면 커넥터를 삭제한 뒤 다시 추가하십시오.

제공되는 도구

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

프롬프트 예시

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

자주 쓰는 작업 흐름

캐나다 CPI 브리핑 준비하기

캐나다 CPI는 국가를 캐나다로 지정한 economics_get_cpi로 가져옵니다. 최신 종합 지수 값과 그 기준 시점을 반환합니다.

채팅 중 통화쌍 확인하기

fx_convert_currency로 GBP 금액을 USD로 환산합니다. 금액과 두 통화를 지정하면 현재 지표 환율로 환산한 결과를 받을 수 있습니다.

Claude로 팜유 관측값 검토하기

팜유 가격 이력을 가져옵니다. commodities_list_palmoil_physical_series로 시리즈를 찾은 뒤 그 시리즈 ID를 commodities_get_palmoil_physical_observations에 전달하면 원래 주기별 관측값을 받을 수 있습니다.

다음 CPI 발표에 맞춰 계획하기

미국의 다음 CPI 발표는 언제인가요? 미국과 최대 366일의 날짜 범위를 지정해 economics_list_releases를 사용하면 예정일을 찾을 수 있습니다.

팁

「Team」과 「Enterprise」에서는 「Owner」가 「Organization settings」, 「Connectors」, 「Add」, 「Custom」 순서로 커넥터를 추가하며, 이후 구성원은 각자의 계정으로 연결합니다.
Claude 「Free」 요금제에서는 커스텀 커넥터를 하나 추가할 수 있으며, Narwhal 인증을 위해서는 「Request headers」를 사용할 수 있어야 합니다.
표준 헤더 이름 authorization을 사용하십시오. Anthropic은 사용자 지정 헤더 이름을 승인 방식으로 허용하며 헤더는 최대 4개까지 추가할 수 있습니다.
요청은 Anthropic 클라우드에서 전송되므로 서버 URL은 공개 HTTPS여야 합니다. Narwhal의 호스팅 엔드포인트는 이 조건을 충족합니다.

자주 묻는 질문

Claude 앱에 Narwhal API 키를 어떻게 전달하나요?

「No sign-in」을 선택하고 「Request headers」에 authorization을 추가한 뒤 값으로 Bearer YOUR_KEY를 입력합니다. Claude는 그 값을 그대로 보내므로 키 앞에 Bearer라는 단어와 공백을 넣어야 합니다.

Claude 커넥터 대화상자에 「Request headers」가 보이지 않는 이유는 무엇인가요?

조직이 아직 해당 베타를 사용할 수 없는 상태입니다. 대신 Claude Code에서 Bearer 키를 사용하십시오. Narwhal에는 대안으로 선택할 수 있는 MCP용 OAuth 로그인이 없습니다.

Claude에 저장된 인증 설정을 변경할 수 있나요?

아니요. 인증 설정은 저장한 뒤에는 변경할 수 없으므로 커넥터를 삭제하고 다시 추가해야 합니다. Claude는 헤더 값을 안전하게 저장하며 저장된 값을 다시 보여 주지 않습니다.

문제 해결

증상	확인
채팅에 Narwhal이 표시되지 않습니다	해당 채팅의 더하기 버튼을 열고 「Connectors」를 선택한 다음 Narwhal을 켭니다. 「Team」이나 「Enterprise」에서는 「Owner」가 커넥터를 추가했는지 확인하십시오.
커넥터가 `401 invalid_api_key`를 반환합니다	키가 활성 상태인지, 헤더 값에 `Bearer`와 공백이 포함되어 있는지 확인하십시오. 저장된 인증 설정을 바꾸려면 커넥터를 다시 만드십시오.
대화상자에 「Request headers」 항목이 없습니다	조직이 이 베타를 사용할 수 없는 상태입니다. 같은 Narwhal 키로 Claude Code를 사용해 연결하십시오.
커넥터가 서버에 연결하지 못합니다	끝에 슬래시를 붙이지 말고 https://api.narwhalapi.com/mcp 를 정확히 입력하십시오. 이 URL은 Anthropic 클라우드에서 접근할 수 있어야 합니다.

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