Cursor에서 환율 조회

Cursor에 exchangerate.dev MCP 서버를 추가하면 도우미가 환율을 조회하고 금액을 환산할 수 있습니다. 호스팅 서버는 키 없이 작동하며 환율은 15분 지연됩니다. 유료 플랜은 같은 엔드포인트에서 실시간 환율을 받습니다.

호스팅 서버 추가

모든 프로젝트에 적용하려면 ~/.cursor/mcp.json에, 한 프로젝트에 적용하려면 프로젝트 루트의 .cursor/mcp.json에 다음 설정을 저장하세요.

mcpServers 아래에 항목을 넣고 url로 https://api.exchangerate.dev/v1/mcp/에 Streamable HTTP 연결을 합니다. 끝의 슬래시를 유지하세요. API 키는 필요 없습니다. 저장 후 Cursor의 MCP 설정을 다시 로드하거나 Cursor를 재시작하면 MCP 도구에 서버가 나타납니다.

{  "mcpServers": {    "exchangerate-dev": {      "url": "https://api.exchangerate.dev/v1/mcp/"    }  }}

개인 할당량 사용

다음 설정의 YOUR_API_KEY를 API 키로 바꾸고 저장한 뒤 Cursor의 MCP 설정을 다시 로드하거나 Cursor를 재시작하세요.

headers로 Authorization: Bearer YOUR_API_KEY를 추가합니다. 키에는 플랜의 할당량과 한도가 적용됩니다. Free는 월 5,000회, 분당 10회입니다. Free를 포함한 모든 플랜에서 MCP를 쓸 수 있으며, Free 환율은 15분 지연됩니다.

{  "mcpServers": {    "exchangerate-dev": {      "url": "https://api.exchangerate.dev/v1/mcp/",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

로컬 브리지 실행

Node.js 20 이상을 설치한 뒤 다음 설정에 API 키를 넣으면 호스팅 연결 대신 로컬 브리지를 실행할 수 있습니다.

로컬 항목은 command, args, env를 사용합니다. npx로 npm 브리지를 시작하고 환경에 EXCHANGERATE_API_KEY를 설정합니다. 브리지에는 API 키가 필요합니다. 저장 후 Cursor의 MCP 설정을 다시 로드하거나 Cursor를 재시작하세요.

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

도구 확인 후 환율 질문

Cursor에 도구 9개가 모두 있는지 확인한 뒤 “지금 100유로는 몇 엔이야?”라고 물어보세요.

convert는 from, to, amount로 답합니다. “9월 1일 USD 대비 IDR 환율은?”은 get_range, “어떤 통화를 조회할 수 있어?”는 list_currencies로 조회합니다.

get_rate는 base와 quote로 최신 환율을, get_range는 기간별 환율을 조회합니다. get_usd_index는 독립적으로 계산한 USD 지수를 반환하며 search_docs는 문서를 검색합니다.

list_official_rate_tables는 정부 발표 환율표 목록을, get_official_rate는 정부 발표 환율을 조회합니다. 아홉 번째 도구인 start_checkout은 사용자 확인 후에만 플랜 결제 화면을 엽니다.

환율과 시각 확인

Cursor는 반환된 수치와 함께 source, market_session, data_updated_at을 읽을 수 있습니다. 도우미에게 환율과 시각을 함께 명시하도록 요청하세요.

환산 응답에는 환율과 환산 금액, USD를 거쳐 계산한 경우 이를 나타내는 플래그가 있습니다. 응답에는 참조 환율이며 결제나 거래용이 아니라는 안내가 포함됩니다.

연결 오류 해결

도구가 없으면 mcp.json의 JSON 오류를 확인하세요. 끝에 붙은 쉼표가 흔한 원인입니다.

HTTP 401은 헤더의 키가 잘못됐다는 뜻입니다. HTTP 429는 분당 한도나 월 할당량 소진을 뜻합니다. 재시도 시각까지 기다리세요.