Claude에서 금 시세를 조회하려면 비용이 드나요?

Free를 포함한 모든 goldprice.dev 플랜에서 MCP를 이용할 수 있습니다. 무료 API 키는 신용카드 없이 발급받을 수 있으며 월 5,000회 호출을 지원합니다. 실시간 시세를 조회하려면 유료 플랜이 필요합니다.

Claude에 표시되는 시세는 얼마나 지연되나요?

지연 시간은 goldprice.dev 플랜에 따라 다릅니다. Free와 키 없는 연결의 시세는 15분 지연되며, 유료 플랜은 실시간 시세를 제공합니다. 모든 답변에는 도구가 반환한 가격의 기준 시각이 표시됩니다.

Claude에서 어떤 도구를 사용할 수 있나요?

get_spot_price, list_commodities, get_metadata, get_carat, get_historical, search_docs, get_physical_price, get_forward_view, start_checkout의 아홉 가지 도구를 제공합니다. 사용 범위는 플랜에 따라 다릅니다. get_forward_view는 기존 플랜 전용이며, 유료 결제에는 사용자의 확인이 필요합니다.

Claude 금 시세 조회: MCP 설정

goldprice.dev MCP 서버로 Claude에서 금, 은, 구리 시세를 조회하세요. 로컬 설정에는 무료 API 키와 Node.js가 필요합니다. 유료 플랜은 실시간 시세를, Free는 지연 시세를 제공합니다.

Free를 포함한 모든 플랜에서 MCP를 이용할 수 있습니다.
현물가, 순도별 g당 가격, 과거 시세를 물어보세요.
모든 답변에 가격 기준 시각이 표시됩니다.

API 키 받기 요금

무료 API 키 발급

goldprice.dev에 가입하면 신용카드 없이 무료 API 키를 발급받을 수 있습니다. Free는 월 5,000회 호출과 분당 10회 요청을 지원합니다.

서버 연결 시 Claude가 goldprice.dev MCP 프로그램을 로컬에서 실행할 수 있도록 Node.js를 설치하세요.

Claude Desktop에 서버 추가

Claude Desktop 설정 파일을 여세요. macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json입니다. mcpServers 아래에 goldprice 항목을 추가하고 YOUR_API_KEY를 발급받은 키로 바꾸세요.

파일을 저장한 뒤 Claude를 완전히 종료하고 다시 여세요. macOS에서는 Cmd-Q를 사용하세요. MCP 서버는 Claude 시작 시에만 로드되므로 창을 닫는 것만으로는 부족합니다.

claude_desktop_config.json

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

Claude Code에 추가

Node.js를 설치한 뒤 YOUR_API_KEY를 goldprice.dev 키로 바꾸고 Claude Code 명령을 실행하세요. 이 명령은 -e로 GP_KEY를 설정합니다.

Shell

claude mcp add goldprice -e GP_KEY=YOUR_API_KEY -- npx -y @nusantara-ventures/goldprice-mcp

원격 서버 연결

Streamable HTTP로 https://api.goldprice.dev/v1/mcp/ 에 연결하고 끝의 슬래시를 유지하세요. 원격 서버는 설치, Node.js, API 키가 필요 없습니다. Claude Code 명령으로 서버를 추가하세요.

키 없이 get_spot_price, list_commodities, get_carat, search_docs, get_metadata 및 get_historical 도구를 사용할 수 있으며, 시세는 Free와 동일하게 15분 지연됩니다. get_physical_price와 get_forward_view는 plan_gated 오류를, start_checkout은 api_key_required를 반환합니다. get_physical_price는 Basic 이상, get_forward_view는 기존 플랜 전용입니다. get_historical은 30일간의 일별 내역을 제공하며, 더 긴 내역은 유료 플랜이 필요합니다. 실시간 시세는 위 안내대로 유료 키를 설정한 로컬 서버나 REST API로 조회하세요.

Shell

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

Claude에 시세 물어보기

서버를 연결한 뒤 평소 쓰는 말로 물어보세요. Claude는 요청에 맞는 도구를 사용합니다.

"지금 인도 루피 기준 22K 금의 g당 가격은 얼마인가요?"라고 물으면 get_carat을 사용합니다.

"미국 달러 기준 금 시세는 얼마인가요?"라고 물으면 get_spot_price를 사용합니다.

"지난달 은의 일별 종가를 보여주세요"라고 요청하면 get_historical을 사용합니다.

"어느 나라의 판매점 가격을 볼 수 있나요?"라고 물으면 get_physical_price를 사용하며, Basic 이상이 필요합니다.

Claude에서 조회할 수 있는 정보

모든 플랜에서 금, 은, 구리 현물가를 조회할 수 있습니다. 순도별 가격은 24K부터 10K까지 g당 가격을 35개 통화로 제공합니다. Claude는 지원 종목 목록, 단위와 갱신 상태를 확인하고 goldprice.dev 문서를 검색할 수 있습니다.

일별 내역은 Free에서 30일, Basic에서 일 년간 제공하며, 상위 플랜에서는 더 긴 내역을 제공합니다. 일중 봉 데이터는 Plus 또는 Pro, 판매점 가격은 Basic 이상이 필요합니다.

Claude는 반환된 수치를 읽고 가격 기준 시각을 표시합니다. 참조 가격은 거래 제안이 아닙니다. Claude에서 유료 플랜을 구매할 때는 결제 도구를 사용하며 사용자의 확인이 필요합니다.

문제 해결

Claude에 도구가 나타나지 않으면 JSON 오류를 확인하세요. 주로 마지막 항목 뒤의 쉼표가 원인입니다. 수정 후 저장하고 Claude Desktop을 완전히 종료한 뒤 다시 열어 서버를 로드하세요.

invalid_api_key 오류가 나면 Claude Desktop 설정의 env 블록에 GP_KEY를 설정하세요. Claude Desktop은 터미널의 환경 변수를 상속하지 않으므로 셸 설정은 적용되지 않습니다.

Claude에서 금 시세 조회