Cursor, Claude Code, ChatGPT 및 기타 MCP 클라이언트를 위한 IronWallet MCP 서버 설치 및 구성.
IronWallet MCP 서버(@ironwallet/mcp-server)는 AI 에이전트에게 컴퓨터 내 비수탁형(non-custodial) 암호화폐 지갑을 제공합니다. 시드 문구는 로컬에서 생성 및 암호화되며, 이 기기를 절대 벗어나지 않고 에이전트, LLM 또는 IronWallet 백엔드를 거치지 않습니다. 에이전트는 잔액 확인, 입금 QR 코드 표시, 토큰 전송 및 12개 네트워크(Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP, TON) 간 스왑을 수행할 수 있습니다.
거래별 확인 UI가 없습니다. 에이전트에게 전송이나 스왑을 요청하면 다시 묻지 않고 서명 및 브로드캐스트할 수 있습니다. 잔액이 제한된 전용 핫월렛을 사용하고, 절대 메인 지갑을 사용하지 마십시오.
요구 사항: Node.js 20+ (npx). 데스크톱 / stdio 전용.
비수탁형, 로컬 서명
시드 문구는 호스트에 암호화된 상태로 유지됩니다(소유자 전용 파일 권한). 거래는 이 기기에서 서명되며, 도구는 시드를 허용하거나 반환하지 않습니다.
로컬 브라우저의 지갑
create_wallets로 지갑을 생성(backup_url 반환)하거나, open_wallet_manager를 통해 가져오기 및 백업을 수행하십시오. 이는 127.0.0.1에서만 작동하는 루프백 전용 페이지로, 15분 동안 활동이 없으면 종료됩니다. 비밀 정보는 채팅이 아닌 해당 브라우저 페이지에만 나타납니다.
수수료 견적을 포함한 전송
estimate_transfer는 브로드캐스트 없이 수수료를 미리 보여주고, send_transfer는 로컬에서 서명 후 전송하며, get_operation_status는 결과를 폴링합니다. 서버는 수수료가 잔액에 맞도록 금액을 약간 줄일 수 있으며, 응답 시 해당 내용을 알려줍니다.
카탈로그 기반 스왑
list_swap_networks와 list_swap_assets는 매도/매수 카탈로그를 제공하여 에이전트가 토큰 주소를 임의로 생성하지 않도록 합니다. estimate_swap은 견적을 내고, execute_swap은 최신 견적으로 실행하며, get_swap_status는 상태를 폴링합니다.
입금 QR 코드
get_deposit_qr은 채팅용 PNG와 로컬 qr_url 대체 링크를 반환합니다.
선택적 지출 한도
set_wallet_policy를 통한 지갑별 정책: readOnly, maxPerTxUsd 및 전송 수신자 허용 목록. 기본적으로 꺼져 있으며 전송 및 스왑 모두에 적용됩니다. IW_READ_ONLY=true는 서버 전체를 읽기 전용으로 만듭니다.
옵션 1: npx (권장)
npx를 사용하여 전역 설치 없이 서버를 실행하십시오. 항상 최신 버전을 사용할 수 있습니다.
첫 실행 시 종속성 설치로 인해 약 30초가 걸릴 수 있습니다. MCP 클라이언트 시간이 초과되면 터미널에서 명령을 한 번 실행하여 캐시를 예열한 후 다시 연결하십시오.
옵션 2: 전역 설치
더 빠른 시작을 위해 패키지를 전역으로 설치한 후 ironwallet-mcp를 실행하십시오.
각 클라이언트에는 전용 정적 URL(예: /ai/introduction/vscode/)이 있습니다. 아래의 모든 설치 명령어도 이 페이지에 인라인으로 포함되어 있으므로 탭이나 클릭 뒤에 숨겨진 내용은 없습니다.
가장 권장됨
무료 버전에서도 잘 작동하며, 설치가 쉽고 최고의 경험을 제공합니다.
한 번 설치하면 모든 채팅에서 지갑 도구를 사용할 수 있습니다. ~/.cursor/mcp.json에 붙여넣고 Cursor를 다시 시작할 수도 있습니다.
설치 후 Cursor를 다시 로드하여 PATH에 npx가 포함되도록 하십시오.
독립형 페이지: Cursor — 하나의 HTTP 요청으로 이 가이드만 반환됩니다.
더 높은 전문 수준 필요
Code 모드에서 잘 작동하며, Chat 모드는 매우 제한적입니다.
다음 명령을 순서대로 실행하십시오:
플러그인 설치 후 약 45초 정도 기다린 뒤 새 채팅을 시작하여 도구가 로드되도록 하십시오.
또는 Claude Code를 stdio 서버로 직접 지정하십시오:
독립형 페이지: Claude Code — 하나의 HTTP 요청으로 이 가이드만 반환됩니다.
최고 수준의 전문 지식 필요
AI 모델의 유료 버전과 함께 추가 플러그인이 필요합니다.
VS Code를 열고 로컬 MCP 서버를 등록합니다. VS Code MCP 설정(사용자 또는 작업 영역)에 추가할 수도 있습니다.
독립형 페이지: VS Code — 하나의 HTTP 요청으로 이 가이드만 반환됩니다.
쉬운 설정 - ChatGPT 필요
무료 버전은 매우 제한적이며, 유료 버전이 더 잘 작동합니다.
다음 명령을 순서대로 실행한 후, MCP 도구를 사용할 수 있도록 다시 로드하십시오.
또는 ChatGPT를 stdio 서버로 직접 지정하십시오:
독립형 페이지: ChatGPT — 하나의 HTTP 요청으로 이 가이드만 반환됩니다.
stdio 전송을 사용하십시오. MCP 클라이언트를 다음으로 지정하십시오:
독립형 페이지: 기타 클라이언트 — 하나의 HTTP 요청으로 이 가이드만 반환됩니다.
로그인이나 계정이 없습니다. 첫 실행 시 서버는 로컬 보안 정보(릴레이 API 키, 키 저장소 래핑 비밀번호, 기기 ID)를 ~/.ironwallet-mcp/ 아래에 소유자 전용 권한으로 생성합니다. 구성할 것은 없습니다.
지갑 사용 시작 방법:
Tronscanneraccept_mcp_consent)를 기록하거나, 지갑 관리자에서 계속을 누르십시오.create_wallets는 지갑 이름과 주소, 그리고 backup_url을 반환합니다. 브라우저에서 열어 복구 문구를 확인하고 백업하십시오. 기존 지갑을 가져오거나 나중에 백업하려면 open_wallet_manager를 사용하십시오. 복구 문구는 로컬 브라우저 페이지에서만 입력하거나 표시되며, 채팅에는 절대 나타나지 않습니다.get_deposit_qr)이나 주소(list_wallets)를 요청하고 소액을 보내십시오. 잔액을 제한적으로 유지하십시오. 이는 핫월렛입니다.서버는 상태를 ~/.ironwallet-mcp/에 유지합니다(IW_KEYSTORE_DIR로 재정의 가능):
지갑 시드가 포함된 암호화된 키 저장소,
래핑 비밀번호, 릴레이 API 키 및 기기 ID,
logs/ 아래의 진단 로그(시드 정보는 절대 기록되지 않음).
경고: 서버를 "초기화"하기 위해 이 디렉토리를 삭제하지 마십시오.
여기에는 자금에 대한 암호화된 키가 포함되어 있습니다. 지갑 관리자에서 복구 문구를 백업하지 않고 삭제하면 자금을 잃게 됩니다. 백업은 이 파일들이 아니라 복구 문구입니다.
키 저장소 및 래핑 비밀번호를 가진 사람은 누구든 자금을 제어할 수 있으므로, 이 디렉토리를 민감하게 취급하십시오.
대부분의 사용자는 환경 변수를 설정할 필요가 없습니다. 서버는 첫 실행 시 필요한 모든 것을 생성하고 저장합니다. 고급 사용을 위해 다음 변수를 사용할 수 있습니다:
send_transfer 및 execute_swap 거부. 지갑별 policy.readOnly와는 별개입니다.0은 비활성화)debug / info / warn / error시드는 이 기기를 절대 벗어나지 않습니다. 저장 시 암호화되며 도구 결과, 에이전트 채팅, 로그 또는 백엔드 요청에 절대 나타나지 않습니다. 도구는 시드를 허용하거나 반환하지 않으며, 가져오기 및 백업은 로컬 브라우저에서만 이루어집니다.
에이전트는 다시 묻지 않고 자금을 이동할 수 있습니다. 거래별 확인 UI가 없으며, 귀하의 채팅 메시지가 곧 승인입니다. 전송 및 스왑은 브로드캐스트되면 되돌릴 수 없습니다.
선택적 한도. set_wallet_policy를 통한 지갑별 정책(readOnly, maxPerTxUsd, 수신자 허용 목록)과 서버 전체 IW_READ_ONLY=true 설정이 가능합니다. 둘 다 기본적으로 꺼져 있습니다.
핫월렛 전용. 메인 지갑이나 저축 지갑을 가져오지 마십시오. 키 저장소와 래핑 비밀번호를 가진 사람은 누구든 자금을 제어할 수 있으며, 유출된 시드는 취소할 수 없습니다.
시간 초과는 실패가 아닙니다. 전송이나 스왑을 재시도하기 전에 get_operation_status / get_swap_status를 폴링하십시오.
모든 백엔드 요청은 HTTPS를 사용하며, 로컬 비밀 파일은 소유자 전용 권한(Unix 0600, Windows의 NTFS ACL)을 사용합니다.
취약점 공개: SECURITY.md.
MCP 인스펙터를 사용하여 서버를 직접 테스트하십시오. AI 어시스턴트 없이 도구 호출을 테스트할 수 있는 대화형 웹 UI가 열립니다.
npx는 첫 실행 시 패키지를 다운로드하며, 약 30초가 걸릴 수 있습니다.
npx -y @ironwallet/mcp-server를 한 번 실행하여 캐시를 예열한 후 다시 연결하십시오.npm install -g @ironwallet/mcp-server@latest.node --version.PATH에 npx가 포함되도록 하십시오.create_wallets가 needs_consent를 반환함MCP 면책 조항에 아직 동의하지 않았습니다. 에이전트에게 전체 면책 조항을 표시하고 확인(accept_mcp_consent)하도록 요청하거나, 지갑 관리자를 열고 계속을 누르십시오.
시간 초과는 실패가 아닙니다. 거래가 이미 브로드캐스트되었을 수 있습니다. 재시도하기 전에 get_operation_status(전송) 또는 get_swap_status(스왑)를 폴링하십시오. 절대 무작정 다시 제출하지 마십시오.
list_wallets → policy를 확인하십시오. readOnly 또는 수신자 허용 목록이 작업을 차단하고 있을 수 있습니다. { enabled: false }는 제한이 없음을 의미합니다.maxPerTxUsd는 보수적으로 실패합니다. 자산에 대한 USD 환율을 사용할 수 없는 경우 작업이 거부됩니다.IW_READ_ONLY=true로 실행 중인지 확인하십시오.