GoMining
GoMining
Docs

GoMining MCP 서버

GoMining MCP 서버란?

GoMining MCP 서버 (https://mcp.gomining.com/mcp)는 AI 어시스턴트(예: Claude)를 GoMining 계정에 직접 연결하는 커넥터입니다. 앱을 열지 않고도 LLM을 통해 계정 정보를 추출하고 분석할 수 있습니다.

예를 들어, 다음과 같이 물어볼 수 있습니다:

  • 내 BTC 잔액은 얼마인가요?
  • 이번 달에 채굴로 얼마나 벌었나요?
  • 채굴 보상을 최적화할 수 있는 방법을 제안해 주실 수 있나요?

AI 어시스턴트는 계정에서 가져온 실제 개인화된 데이터로 뒷받침된 응답을 생성합니다.

WARNING

응답은 AI가 생성하므로 항상 중요한 정보는 다시 확인해주세요.


어떤 도구들을 사용할 수 있나요?

다음은 GoMining MCP 서버를 통해 사용할 수 있는 모든 도구의 전체 목록입니다(영역별로 그룹화됨).

NOTE

모든 도구는 읽기 전용입니다. 이들은 GoMining 계정에서 데이터를 반환하지만 변경할 수는 없습니다.

지갑

  • get_virtual_wallet_balances — GoMining 계정 지갑의 모든 자산(BTC, GMT, USDT, USDC, ETH, BNB, SOL, TON)에 걸친 잔액을 반환합니다.
  • get_deposit_addresses — GoMining 계정의 입금 주소와 각 주소가 지원하는 네트워크 및 자산을 반환합니다.
  • get_conversion_quote — 계정의 두 자산 간 전환 견적을 반환하며, 환율과 수령할 금액을 표시합니다.
  • get_transaction_history — 지갑의 입금 및 출금 내역을 각 거래의 금액, 자산, 상태와 함께 반환합니다.

채굴기

  • get_nfts — 소유한 채굴기 목록을 이름, 해시레이트, 에너지 효율, 현재 상태를 포함하여 반환합니다.
  • get_nft_detail — 특정 채굴기의 전체 세부 정보를 해시레이트, 에너지 효율, 현재 가격, ROI, 회수 기간, 일일 및 총 수입, 희귀성, 업그레이드 수준을 포함하여 반환합니다.
  • get_nft_mining_rewards — 선택한 날짜 범위에 걸쳐 모든 채굴기의 일일 채굴 수입을 각 날짜에 획득한 총 BTC와 함께 반환합니다.
  • get_nft_upgrade_total — 전체 채굴기 업그레이드 통계를 반환하며, 수행한 업그레이드 수, 업그레이드된 채굴기 수, 업그레이드에 소비한 총 GMT 및 USD를 포함합니다.

시장 데이터

  • get_ticker_prices — BTC, ETH, GMT 같은 암호화폐와 USD, EUR 같은 법정화폐의 현재 시장 가격을 반환합니다.

카드

  • get_cards — GoMining 카드 목록을 각 카드의 상태, 마지막 4자리, 발급 여부, PIN 설정 여부, Apple Pay 또는 Google Wallet 추가 여부를 포함하여 반환합니다.
  • get_card_balance — GoMining 카드의 모든 자산(BTC, GMT, USDC, USDT)에 걸친 잔액을 반환합니다.
  • get_card_transactions — GoMining 카드 거래 내역(충전, 결제, 환불)을 각 거래의 금액, 자산, 상태와 함께 반환합니다.
  • get_card_transaction_detail — 특정 GoMining 카드 거래의 전체 세부 정보를 결제 정보, 환불 상태, EUR 금액을 포함하여 반환합니다.

스테이킹

  • get_staking_positions — 잠금된 GMT 금액, 투표, 잠금 시작 시간, 만료까지의 일수를 포함하여 활성 veGOMINING 스테이킹 포지션을 반환합니다.
  • get_staking_types — 사용 가능한 스테이킹 유형과 해당 매개변수를 반환합니다.

계정

  • get_kyc_status — KYC 검증 상태와 국가, 검증 만료 여부를 반환합니다.
  • get_referral_link — 추천 코드와 공유 가능한 링크, 계정에서 추천 프로그램 사용 가능 여부를 반환합니다.
  • get_referral_stats — 추천 코드, 초대한 친구 수, USD로 획득한 총 보상, 보상 유형별 세부 분석을 포함하여 추천 프로그램의 통계를 반환합니다.
  • get_avatars — 프로필 사진으로 설정할 수 있는 소유한 아바타를 현재 활성인 아바타를 포함하여 반환합니다.
  • get_avatar_collections — 구매 가능한 아바타를 인종(Humans, Sentinels, Cryptiles, Luminars)과 나열된 마켓플레이스로 필터링하여 표시합니다.
  • get_account_summary — 지갑 잔액, 소유한 채굴기 수, VIP 상태, 활성 스테이킹 포지션을 포함하여 계정의 빠른 개요를 반환합니다.

채굴기 전쟁

  • get_miner_wars_mining_income — 선택한 날짜 범위에 걸쳐 기간별로 집계된 채굴기 전쟁 수입을 반환합니다.
  • get_spells — 각 스펠의 유형, 티어, GOMINING 가격, 무료 사용 횟수를 포함하여 사용 가능한 모든 채굴기 전쟁 스펠을 반환합니다.

마켓플레이스

  • get_marketplace_pricing — 공식 GoMining 마켓플레이스에서 구매 가능한 채굴기를 각 컬렉션의 가격, 총 해시레이트, TH당 가격, ROI 배수, 판매 상태를 포함하여 반환합니다.
  • search_secondary_marketplace — 보조 마켓플레이스(사용자가 서로에게 판매하는 곳)에 나열된 채굴기를 검색하며, 가격 통화, 해시레이트 범위, 가격 범위, 컬렉션으로 필터링할 수 있습니다.
  • get_marketplace_listing — 보조 마켓플레이스에서 자신의 채굴기 목록을 반환하며, 특정 채굴기를 조회할 수 있습니다.
  • get_my_marketplace_orders — 보조 마켓플레이스에서 자신의 판매 주문(활성 및 과거)을 반환합니다.

Simple Earn

  • check_simple_earn_eligibility — Simple Earn을 사용할 수 있는지 확인하며, 이미 등록되었는지 여부와 사용 불가 시 그 이유(예: 국가 제한)를 포함합니다.
  • get_simple_earn_status — Simple Earn 등록 상태(암호 잔액에서 BTC 보상을 획득할 수 있게 하는 수익 창출 기능)와 국가, VIP 수준, VIP 구독 상태를 반환합니다.
  • get_simple_earn_rewards — 각 자산에 대해 잔액, APR, 가격, 획득한 BTC 보상, 적용된 VIP 배수를 포함하여 사이클별 Simple Earn 보상 내역을 반환합니다.
  • get_simple_earn_reward_totals — 모든 시간 총계(BTC 및 USD), 마지막 사이클의 보상, 자산별 세부 분석을 포함하여 획득한 총 Simple Earn 보상을 반환합니다.
  • get_simple_earn_config — 각 지원 자산(USDT, USDC, ETH, BNB, TON, SOL)의 APR과 각 VIP 수준에 적용된 배수를 포함하여 현재 Simple Earn 요율을 반환합니다.

VIP 및 충성도

  • get_vip_level — VIP 티어, 유지보수 할인, 카드 캐시백 요율, Launchpad 티어를 포함하여 현재 VIP 상태를 반환합니다.
  • get_vip_benefits — 현재 VIP 수준에서의 완전한 혜택 분석을 유지보수 할인, 재투자 보너스, 카드 캐시백 요율, Simple Earn 배수, 카드 거래 수수료, Launchpad 티어, 해제된 기능을 포함하여 반환합니다.
  • get_vip_progress — 각 티어에 필요한 해시레이트 또는 veGOMINING 투표와 각 티어에서 해제되는 혜택을 포함하여 현재 VIP 수준과 모든 VIP 티어를 반환합니다.
  • get_vip_subscription — VIP Platinum Subscription+ 상태를 반환합니다.
  • get_cashback_stats — TH 캐시백을 수령하는 채굴기, VIP 수준, 카드 결제, 가맹점 결제, 카드 추천의 캐시백 비율을 포함하여 캐시백 설정을 반환합니다.
  • get_cashback_history — 원래 거래 금액, USD 가치, 채굴기에 제공된 TH, 각 항목의 처리 상태를 포함하여 캐시백 수입 내역을 반환합니다.

Launchpad

  • get_launchpad_projects — 각 프로젝트의 설명, 토큰 가격, 판매 및 등록 날짜, 현재 단계, 네트워크, KYC 또는 국가 제한을 포함하여 GoMining Launchpad에서 사용 가능한 BTCFi 토큰 판매를 반환합니다.
  • get_launchpad_allocation — 특정 지갑 주소에 대해 VIP 수준을 기반으로 Launchpad 티어와 할당 금액을 반환합니다.
  • get_launchpad_tier_config — 각 티어의 요구 사항과 각 수준에서 사용 가능한 할당 금액을 포함하여 Launchpad 티어가 설정되는 방식을 반환합니다.

Academy

  • get_academy_courses — 각 과정의 제목, 설명, 난이도, 진행 상황(시작 시간, 완료 시간, 평가)을 포함하여 GoMining Academy의 모든 사용 가능한 과정을 반환합니다.
  • get_course_progress — 특정 Academy 과정의 진행 상황을 제목, 설명, 난이도, 시작 시간, 완료 시간, 평가를 포함하여 반환합니다.

어떻게 사용할 수 있나요?

GoMining MCP 서버를 사용할 수 있는 몇 가지 예는 다음과 같습니다:

  • 포트폴리오 개요 — 앱의 여러 섹션을 탐색하는 대신 한 메시지에서 채굴기, 잔액, 채굴 수입의 요약을 요청합니다.
  • 일일 체크인 — 에이전트를 설정하고 자는 동안 일일 요약을 받습니다.
  • 채굴기 분석 — 해시레이트, 효율성, 희귀성별로 디지털 채굴기를 비교하여 성능이 가장 좋은 것을 식별하고 채굴 팜의 성능을 개선하는 방법에 대한 제안을 받습니다.
  • 스테이킹 및 Simple Earn 추적 — veGOMINING 스테이킹 포지션 및 Simple Earn 보상을 모니터링합니다.
  • 입금 흐름 — 특정 통화 및 네트워크에 대한 입금 주소를 요청합니다(거래 중에 빨리 필요할 때 유용함).
  • 시장 맥락 — 계정 데이터와 함께 GOMINING 또는 다른 지원 자산의 현재 가격을 요청하여 더 완전한 그림을 얻습니다.

누가 사용할 수 있나요?

이 커넥터는 모든 GoMining 사용자가 사용할 수 있으며 다음과 함께 작동합니다:

  • Claude.ai
  • Claude Code
  • Cursor
  • Windsurf
  • MCP 연결을 지원하는 모든 AI 도구

Claude Web에서는 어떻게 연결하나요?

NOTE

연결하기 전에 같은 브라우저에서 app.gomining.com에 GoMining 계정으로 로그인되어 있는지 확인하세요.

  1. Claude.ai를 열고 Customize → Connectors로 이동합니다.
  2. + 버튼을 클릭하여 새로운 커넥터를 추가합니다.
  3. Add custom connector 대화 상자에서 다음을 입력합니다:
    • Name: GoMining
    • Remote MCP server URL: https://mcp.gomining.com/mcp
  4. Add를 클릭합니다.
  5. 커넥터 화면에서 Connect를 클릭하고 GoMining 계정으로 로그인하여 접근을 허용합니다.

연결되면 Claude는 대화에서 직접 GoMining 계정 데이터를 쿼리할 수 있습니다.


Claude Desktop에서는 어떻게 연결하나요?

NOTE

연결하기 전에 app.gomining.com에 GoMining 계정으로 로그인되어 있는지 확인하세요. 인증 단계는 기본 브라우저에서 열립니다.

  1. Claude Desktop 앱을 열고 사이드바의 Customize를 클릭합니다.
  2. Connectors 탭을 선택합니다.
  3. + 버튼을 클릭하고 Add custom connector를 선택합니다.
  4. Add custom connector 대화 상자에서 다음을 입력합니다:
    • Name: GoMining
    • Remote MCP server URL: https://mcp.gomining.com/mcp
  5. Add를 클릭합니다.
  6. 커넥터 화면에서 Connect를 클릭하고 로그인된 GoMining 계정을 사용하여 접근을 허용합니다.

연결되면 Claude Desktop은 대화에서 직접 GoMining 계정 데이터를 쿼리할 수 있습니다.


다른 AI 도구에서는 어떻게 연결하나요?

도구가 MCP를 지원하면 설정에서 다음을 원격 MCP 서버로 추가합니다: https://mcp.gomining.com/mcp


AI가 내 계정을 변경할 수 있나요?

현재 GoMining MCP 서버는 읽기 전용 접근만 지원합니다 — AI는 계정 데이터를 볼 수 있고 질문에 답할 수 있지만, 이체, 구매, 설정 변경 같은 작업은 수행할 수 없습니다.

설정 중에 어떤 권한을 부여할지 선택할 수 있는 동의 화면이 표시됩니다. 향후 릴리스에서 쓰기 접근이 추가될 수 있으며, 현재는 읽기 접근만 작동합니다.


문제가 발생하면 어떻게 해야 하나요?

데이터가 반환되지 않음 — 이 기능이 계정에서 아직 활성화되지 않았을 수 있습니다. 예를 들어, 디지털 채굴기가 없거나 Simple Earn을 활성화하지 않았다면 이러한 쿼리는 빈 결과를 반환합니다. 이는 예상된 동작입니다.

이것도 도움이 되지 않으면, app.gomining.com의 라이브 채팅을 통해 또는 [email protected]으로 이메일을 통해 GoMining 지원팀에 문의하세요.