Ironwallet is the best online crypto wallet in the world.Ironwallet is the best online crypto wallet in the world.
Máy tính phíKiểm tra số dư víTronScanner - check transactions in the Tron blockchain.Tronscanner

Thiết lập MCP

Cài đặt và cấu hình máy chủ IronWallet MCP cho Cursor, Claude Code, ChatGPT và các ứng dụng khách MCP khác.

Máy chủ IronWallet MCP (@ironwallet/mcp-server) cung cấp cho các tác nhân AI một ví tiền điện tử không lưu ký ngay trên máy tính của bạn. Cụm từ khôi phục (seed phrase) được tạo và mã hóa cục bộ — chúng không bao giờ rời khỏi máy này và không bao giờ đi qua tác nhân, LLM hay các hệ thống phụ trợ của IronWallet. Các tác nhân có thể kiểm tra số dư, hiển thị mã QR gửi tiền, chuyển token và hoán đổi trên 12 mạng lưới: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP và TON.

Không có giao diện xác nhận cho mỗi giao dịch — một khi bạn yêu cầu tác nhân gửi hoặc hoán đổi, nó có thể ký và phát lệnh mà không cần hỏi lại. Hãy sử dụng ví nóng chuyên dụng với số dư hạn chế, không bao giờ dùng ví chính của bạn.

Yêu cầu: Node.js 20+ (npx). Chỉ hỗ trợ Desktop / stdio.

Tính năng

Không lưu ký, ký cục bộ

Cụm từ khôi phục được mã hóa trên máy chủ (quyền tệp chỉ chủ sở hữu). Giao dịch được ký trên máy này; không có công cụ nào chấp nhận hoặc trả về seed.

Ví trong trình duyệt cục bộ

Tạo ví với create_wallets (trả về backup_url), hoặc nhập và sao lưu thông qua open_wallet_manager — một trang chỉ chạy cục bộ trên 127.0.0.1 và sẽ tự tắt sau 15 phút không hoạt động. Các bí mật chỉ xuất hiện trên trang trình duyệt đó, không bao giờ xuất hiện trong cuộc trò chuyện.

Chuyển tiền với ước tính phí

estimate_transfer xem trước phí mà không phát lệnh; send_transfer ký cục bộ và gửi; get_operation_status thăm dò kết quả. Máy chủ có thể giảm số tiền một chút để phí vẫn nằm trong số dư — phản hồi sẽ thông báo khi điều đó xảy ra.

Hoán đổi dựa trên danh mục

list_swap_networks và list_swap_assets cung cấp danh mục bán/mua để tác nhân không bao giờ tự tạo địa chỉ token. estimate_swap báo giá, execute_swap thực thi trên báo giá mới, get_swap_status thăm dò trạng thái.

Mã QR gửi tiền

get_deposit_qr trả về hình ảnh PNG cho cuộc trò chuyện kèm theo dự phòng qr_url cục bộ.

Giới hạn chi tiêu tùy chọn

Chính sách cho mỗi ví thông qua set_wallet_policy: readOnly, maxPerTxUsd và danh sách cho phép người nhận. Mặc định là tắt; áp dụng cho cả gửi và hoán đổi. IW_READ_ONLY=true làm cho toàn bộ máy chủ ở chế độ chỉ đọc.

Cài đặt

Tùy chọn 1: npx (khuyên dùng)

Sử dụng npx để chạy máy chủ mà không cần cài đặt toàn cục. Điều này đảm bảo bạn luôn sử dụng phiên bản mới nhất.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Lần khởi chạy đầu tiên có thể mất khoảng 30 giây trong khi cài đặt các phụ thuộc. Nếu ứng dụng khách MCP của bạn bị hết thời gian chờ, hãy chạy lệnh một lần trong terminal để làm nóng bộ nhớ đệm, sau đó kết nối lại.

Tùy chọn 2: Cài đặt toàn cục

Cài đặt gói toàn cục để khởi động nhanh hơn, sau đó chạy ironwallet-mcp.

npm install -g @ironwallet/mcp-server@latest

Hướng dẫn thiết lập

Chỉ dành cho máy tính để bàn

Mỗi ứng dụng khách có một URL tĩnh chuyên dụng (ví dụ: /ai/introduction/vscode/). Tất cả các lệnh cài đặt bên dưới cũng được hiển thị trực tiếp trên trang này — không có tab, không có gì ẩn sau các cú nhấp chuột.

Cursor

Được khuyên dùng nhiều nhất

Được khuyên dùng nhiều nhất

Hoạt động tốt với phiên bản miễn phí, cài đặt dễ dàng, trải nghiệm tốt nhất

Mở trong Cursor

Cài đặt một lần. Sau đó, các công cụ ví sẽ có sẵn trong mọi cuộc trò chuyện. Bạn cũng có thể dán nội dung này vào ~/.cursor/mcp.json và khởi động lại Cursor.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Tải lại Cursor sau khi cài đặt để PATH bao gồm npx.

Trang độc lập cho Cursor — một yêu cầu HTTP chỉ trả về hướng dẫn này.

Claude Code

Yêu cầu trình độ chuyên gia cao hơn

Hoạt động tốt với chế độ Code, chế độ Chat rất hạn chế

Mở trong Claude Code

Chạy các lệnh này theo thứ tự:

1claude plugin marketplace add ironwallet/ironwallet-agent-kit
2claude plugin install ironwallet-mcp@ironwallet

Sau khi cài đặt plugin, đợi khoảng 45 giây và bắt đầu cuộc trò chuyện mới để các công cụ tải lên.

Hoặc trỏ Claude Code trực tiếp vào máy chủ stdio:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Trang độc lập cho Claude Code — một yêu cầu HTTP chỉ trả về hướng dẫn này.

VS Code

Trình độ chuyên gia cao nhất

Yêu cầu các plugin bổ sung với phiên bản trả phí của các mô hình AI

Mở trong VS Code

Mở VS Code và đăng ký máy chủ MCP cục bộ. Bạn cũng có thể thêm nội dung này vào cài đặt MCP của VS Code (người dùng hoặc không gian làm việc).

1{
2 "mcp": {
3 "servers": {
4 "ironwallet": {
5 "type": "stdio",
6 "command": "npx",
7 "args": ["-y", "@ironwallet/mcp-server"]
8 }
9 }
10 }
11}

Trang độc lập cho VS Code — một yêu cầu HTTP chỉ trả về hướng dẫn này.

ChatGPT

Thiết lập dễ dàng - yêu cầu ChatGPT

Phiên bản miễn phí rất hạn chế, phiên bản trả phí hoạt động tốt hơn

Mở trong ChatGPT

Chạy các lệnh này theo thứ tự, sau đó tải lại để các công cụ MCP khả dụng.

1codex plugin marketplace add ironwallet/ironwallet-agent-kit
2codex plugin add ironwallet-mcp@ironwallet

Hoặc trỏ ChatGPT trực tiếp vào máy chủ stdio:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Trang độc lập cho ChatGPT — một yêu cầu HTTP chỉ trả về hướng dẫn này.

Các ứng dụng khách khác

Sử dụng giao thức stdio. Trỏ ứng dụng khách MCP của bạn đến:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Trang độc lập cho Các ứng dụng khách khác — một yêu cầu HTTP chỉ trả về hướng dẫn này.

Lần chạy đầu tiên & thiết lập ví

Không cần đăng nhập và không có tài khoản. Trong lần khởi chạy đầu tiên, máy chủ sẽ tạo các bí mật cục bộ — khóa API chuyển tiếp, bí mật bao bọc keystore và ID thiết bị — tại ~/.ironwallet-mcp/ với quyền chỉ chủ sở hữu mới truy cập được. Không cần cấu hình gì thêm.

Để bắt đầu sử dụng ví:

1
Sự đồng ý. Trước khi tạo hoặc nhập ví, tác nhân sẽ hiển thị tuyên bố từ chối trách nhiệm MCP trong cuộc trò chuyện và ghi lại sự chấp nhận của bạn (accept_mcp_consent), hoặc bạn nhấn Tiếp tục trong trình quản lý ví.
2
Tạo hoặc nhập. create_wallets trả về tên và địa chỉ ví cùng với backup_url — mở nó trong trình duyệt của bạn để xem và sao lưu cụm từ khôi phục. Để nhập ví hiện có hoặc sao lưu sau, hãy sử dụng open_wallet_manager. Cụm từ khôi phục chỉ được nhập hoặc hiển thị trong trang trình duyệt cục bộ, không bao giờ trong cuộc trò chuyện.
3
Nạp tiền vào ví. Yêu cầu tác nhân cung cấp mã QR gửi tiền (get_deposit_qr) hoặc địa chỉ (list_wallets) và gửi một số lượng nhỏ. Giữ số dư hạn chế — đây là ví nóng.

Dữ liệu trên đĩa

Máy chủ lưu trạng thái của nó trong ~/.ironwallet-mcp/ (có thể ghi đè bằng IW_KEYSTORE_DIR):

keystore đã mã hóa với các seed ví của bạn,

bí mật bao bọc, khóa API chuyển tiếp và ID thiết bị,

nhật ký chẩn đoán trong logs/ (dữ liệu seed không bao giờ được ghi lại).

Cảnh báo: không xóa thư mục này để "đặt lại" máy chủ.

Nó chứa các khóa đã mã hóa cho tiền của bạn. Nếu bạn xóa nó mà không sao lưu cụm từ khôi phục trong trình quản lý ví, tiền sẽ bị mất. Bản sao lưu của bạn là cụm từ khôi phục, không phải các tệp này.

Bất kỳ ai có keystore và bí mật bao bọc đều có quyền kiểm soát số tiền, vì vậy hãy coi thư mục này là dữ liệu nhạy cảm.

Biến môi trường

Hầu hết người dùng không cần thiết lập bất kỳ biến môi trường nào. Máy chủ tự tạo và lưu trữ mọi thứ cần thiết trong lần khởi chạy đầu tiên. Các biến sau đây có sẵn cho mục đích nâng cao:

Biến
Mô tả
Mặc định
IW_READ_ONLY
Từ chối send_transfer và execute_swap trên toàn bộ tiến trình. Khác với policy.readOnly của từng ví.
false
IW_KEYSTORE_DIR
Thư mục Keystore
~/.ironwallet-mcp
IW_PASSPHRASE
Ghi đè bí mật bao bọc keystore
generated locally
IW_RELAY_API_KEY
Ghi đè khóa API chuyển tiếp
generated UUID
IW_HTTP_TIMEOUT_MS
Thời gian chờ HTTP chung
15000
IW_HTTP_FORWARD_TIMEOUT_MS
Thời gian chờ cho các lệnh gọi kiểu phát sóng. Thời gian chờ của ứng dụng khách không phải lúc nào cũng có nghĩa là thao tác đã thất bại — hãy kiểm tra trạng thái
60000
IW_LOG_ENABLED
Chẩn đoán JSONL vào tệp nhật ký (0 để tắt)
1
IW_LOG_LEVEL
debug / info / warn / error
info

Bảo mật

Seed không bao giờ rời khỏi máy này. Chúng được mã hóa khi lưu trữ và không bao giờ xuất hiện trong kết quả công cụ, cuộc trò chuyện của tác nhân, nhật ký hoặc yêu cầu hệ thống phụ trợ. Không có công cụ nào chấp nhận hoặc trả về seed — việc nhập và sao lưu chỉ diễn ra trong trình duyệt cục bộ.

Tác nhân có thể di chuyển tiền mà không cần hỏi lại. Không có giao diện xác nhận cho mỗi giao dịch; tin nhắn trò chuyện của bạn là sự ủy quyền. Các giao dịch chuyển và hoán đổi là không thể đảo ngược sau khi đã phát lệnh.

Giới hạn tùy chọn. Chính sách cho mỗi ví (readOnly, maxPerTxUsd, danh sách cho phép người nhận) thông qua set_wallet_policy và IW_READ_ONLY=true trên toàn máy chủ. Cả hai đều mặc định tắt.

Chỉ dùng ví nóng. Không nhập ví chính hoặc ví tiết kiệm của bạn. Bất kỳ ai có keystore và bí mật bao bọc đều kiểm soát tiền; seed bị lộ không thể thu hồi.

Hết thời gian chờ không phải là thất bại. Hãy thăm dò get_operation_status / get_swap_status trước khi thử lại lệnh gửi hoặc hoán đổi.

Tất cả các yêu cầu phụ trợ sử dụng HTTPS; các tệp bí mật cục bộ sử dụng quyền chỉ chủ sở hữu (Unix 0600, NTFS ACL trên Windows).

Công bố lỗ hổng: SECURITY.md.

Kiểm thử

Kiểm tra máy chủ trực tiếp bằng trình kiểm tra MCP. Thao tác này mở ra một giao diện web tương tác nơi bạn có thể kiểm tra các lệnh gọi công cụ mà không cần trợ lý AI.

npx @modelcontextprotocol/inspector npx -y @ironwallet/mcp-server

Khắc phục sự cố

Ứng dụng khách MCP bị hết thời gian chờ khi khởi động lần đầu

npx tải xuống gói trong lần chạy đầu tiên, có thể mất ~30 giây.

  • Chạy npx -y @ironwallet/mcp-server một lần trong terminal để làm nóng bộ nhớ đệm, sau đó kết nối lại.
  • Hoặc cài đặt toàn cục: npm install -g @ironwallet/mcp-server@latest.

Công cụ không hiển thị trong ứng dụng khách

  • Kiểm tra xem Node.js 20+ đã được cài đặt chưa: node --version.
  • Tải lại ứng dụng khách sau khi cài đặt để PATH bao gồm npx.
  • Sau khi cài đặt plugin (Claude Code / ChatGPT), bắt đầu cuộc trò chuyện mới để các công cụ tải lên.
  • Xác minh tệp cấu hình chứa JSON hợp lệ và khởi động lại ứng dụng khách.
  • Kiểm tra máy chủ thủ công bằng trình kiểm tra MCP (xem phần Kiểm thử).

create_wallets trả về needs_consent

Tuyên bố từ chối trách nhiệm MCP chưa được chấp nhận. Yêu cầu tác nhân hiển thị toàn bộ tuyên bố và xác nhận (accept_mcp_consent), hoặc mở trình quản lý ví và nhấn Tiếp tục.

Giao dịch chuyển hoặc hoán đổi bị hết thời gian chờ

Hết thời gian chờ không phải là thất bại — giao dịch có thể đã được phát lệnh. Hãy thăm dò get_operation_status (chuyển tiền) hoặc get_swap_status (hoán đổi) trước khi thử lại. Không bao giờ gửi lại một cách mù quáng.

Lệnh gửi hoặc hoán đổi bị từ chối

  • Kiểm tra list_wallets → policy: readOnly hoặc danh sách cho phép người nhận có thể đang chặn thao tác. { enabled: false } nghĩa là không có giới hạn.
  • maxPerTxUsd sẽ thất bại nếu không có tỷ giá USD cho tài sản đó.
  • Kiểm tra xem máy chủ có đang chạy với IW_READ_ONLY=true hay không.