API 키가 필요한가요?

호스팅 서버는 키 없이 작동합니다. 키 없는 호출은 공유 풀을 쓰며 IP당 분당 10회, 시간당 100회로 제한됩니다. 환율은 15분 지연됩니다.

Free 플랜에도 MCP가 포함되나요?

Free를 포함한 모든 플랜에서 MCP를 쓸 수 있습니다. Free 키에는 월 5,000회, 분당 10회의 개인 할당량이 있으며 환율은 15분 지연됩니다.

Claude가 실시간 환율을 받나요?

유료 플랜은 실시간 환율을 받습니다. 키 없는 접속과 Free는 15분 지연됩니다. Claude는 반환된 시각을 명시해야 하며, 환율은 결제나 거래용으로 쓸 수 없는 참조 환율입니다.

로컬 브리지를 키 없이 쓸 수 있나요?

로컬 브리지는 `ALLOW_ANONYMOUS=true` 설정이 없으면 API 키가 필요합니다. Node.js 20 이상도 필요합니다. 호스팅 서버는 Streamable HTTP로 키 없는 직접 연결을 받습니다.

Claude에서 환율 조회 | exchangerate.dev

호스팅 MCP 서버를 통해 Claude에 환율을 연결하세요. 연결에 API 키는 필요 없습니다. 키 없는 접속과 Free 플랜은 15분 지연 환율을, 유료 플랜은 실시간 환율을 받습니다.

무료 API 키 받기 요청 실행

Claude Code에 호스팅 서버 추가

Claude Code에서 다음 명령을 실행하면 API 키 없이 호스팅 MCP 서버가 추가됩니다.

엔드포인트는 끝의 슬래시를 포함한 https://api.exchangerate.dev/v1/mcp/이며 Streamable HTTP를 사용합니다. 도구 검색과 호출 모두 키 없이 가능합니다.

터미널

claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/

키로 개인 할당량 사용

다음 명령에 API 키를 넣어 실행하면 개인 할당량과 한도가 적용됩니다.

Authorization: Bearer YOUR_API_KEY를 전송합니다. Free는 월 5,000회, 분당 10회입니다. MCP 도구 호출마다 API 호출 1회로 계산하며, 해당 REST 요청과 분당 한도 및 월 할당량을 공유합니다.

터미널

claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/ --header "Authorization: Bearer YOUR_API_KEY"

로컬 브리지로 연결

다음 명령으로 Claude Code를 로컬 npm 브리지에 연결하세요.

Node.js 20 이상과 API 키가 필요합니다. 명령은 이중 하이픈 앞에서 -e로 EXCHANGERATE_API_KEY를 설정합니다. 키 없이 쓰려면 ALLOW_ANONYMOUS=true가 필요합니다.

터미널

claude mcp add exchangerate-dev -e EXCHANGERATE_API_KEY=YOUR_API_KEY -- npx -y @nusantara-ventures/exchangerate-mcp

Claude Desktop 설정

Claude Desktop 설정 파일에 다음 설정을 추가하고 YOUR_API_KEY를 바꾸세요.

macOS 파일 경로는 ~/Library/Application Support/Claude/claude_desktop_config.json입니다. Windows에서는 %APPDATA%\Claude\claude_desktop_config.json을 사용하세요.

Claude Desktop은 터미널 환경을 읽지 않으므로 설정의 env 블록에 EXCHANGERATE_API_KEY를 넣으세요. 저장 후 Claude Desktop을 완전히 종료하고 다시 여세요. 서버는 시작할 때 한 번 로드됩니다.

claude_desktop_config.json

{  "mcpServers": {    "exchangerate-dev": {      "command": "npx",      "args": [        "-y",        "@nusantara-ventures/exchangerate-mcp"      ],      "env": {        "EXCHANGERATE_API_KEY": "YOUR_API_KEY"      }    }  }}

Claude에 환율 질문

“지금 100유로는 몇 엔이야?”라고 물어보세요. Claude는 from, to, amount를 받는 convert를 쓸 수 있습니다. 응답에는 환율, 환산 금액, USD를 거쳐 계산한 환율임을 나타내는 플래그가 있습니다.

“9월 1일 USD 대비 IDR 환율은?”에는 get_range나 get_rate를 씁니다. 최신 환율은 base와 quote를 받는 get_rate로 조회하며, get_range는 기간별 환율을 반환합니다.

“어떤 통화를 조회할 수 있어?”는 list_currencies, “어느 중앙은행이 환율을 발표해?”는 list_official_rate_tables로 조회합니다.

Claude의 조회 및 실행 범위

Claude는 도구 9개로 환율, 통화 정보, 문서에 접근합니다. 앞서 나온 도구 외에 get_usd_index는 독립적으로 계산한 USD 지수, search_docs는 문서 검색 결과, get_official_rate는 정부 발표 환율을 반환합니다.

응답에는 source, market_session, data_updated_at과 함께 참조 환율이며 결제나 거래용이 아니라는 안내가 있습니다. Claude는 반환된 시각을 명시해야 합니다.

start_checkout은 사용자 확인 후에만 플랜 결제 화면을 엽니다. Claude가 스스로 구매하는 일은 없습니다.

오류 해결

Claude Desktop에 도구가 없으면 설정 JSON을 확인하세요. 끝에 붙은 쉼표가 흔한 원인입니다.

잘못된 API 키는 HTTP 401을 반환합니다. 429는 분당 한도나 월 할당량 소진을 뜻합니다. 재시도 시각까지 기다리세요.

Claude에서 환율 조회