Setup MCP

Instal dan konfigurasi server IronWallet MCP untuk Cursor, Claude Code, ChatGPT, dan klien MCP lainnya.

Server IronWallet MCP (@ironwallet/mcp-server) memberikan agen AI dompet kripto non-kustodian di komputer Anda. Frasa pemulihan (seed phrase) dibuat dan dienkripsi secara lokal — frasa tersebut tidak pernah meninggalkan perangkat ini dan tidak pernah melewati agen, LLM, atau backend IronWallet. Agen dapat memeriksa saldo, menampilkan kode QR deposit, mentransfer token, dan melakukan swap di 12 jaringan: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP, dan TON.

Tidak ada UI konfirmasi per transaksi — setelah Anda meminta agen untuk mengirim atau menukar, agen dapat menandatangani dan menyiarkannya tanpa bertanya lagi. Gunakan hot wallet khusus dengan saldo terbatas, jangan pernah gunakan dompet utama Anda.

Persyaratan: Node.js 20+ (npx). Hanya Desktop / stdio.

Fitur

Non-kustodian, penandatanganan lokal

Frasa pemulihan tetap terenkripsi di host (izin file hanya untuk pemilik). Transaksi ditandatangani di mesin ini; tidak ada alat yang menerima atau mengembalikan seed.

Dompet di browser lokal

Buat dompet dengan create_wallets (mengembalikan backup_url), atau impor dan cadangkan melalui open_wallet_manager — halaman khusus loopback di 127.0.0.1 yang mati setelah 15 menit tidak aktif. Rahasia hanya muncul di halaman browser tersebut, tidak pernah di dalam obrolan.

Transfer dengan estimasi biaya

estimate_transfer mempratinjau biaya tanpa menyiarkan; send_transfer menandatangani secara lokal dan mengirim; get_operation_status melakukan polling hasil. Server mungkin sedikit mengurangi jumlah agar biaya tetap sesuai dengan saldo — respons akan memberi tahu kapan hal itu terjadi.

Swap berbasis katalog

list_swap_networks dan list_swap_assets menyediakan katalog jual/beli agar agen tidak pernah mengarang alamat token. estimate_swap memberikan kuota, execute_swap mengeksekusi pada kuota baru, get_swap_status melakukan polling.

Kode QR deposit

get_deposit_qr mengembalikan PNG untuk obrolan ditambah cadangan qr_url lokal.

Batas pengeluaran opsional

Kebijakan per dompet melalui set_wallet_policy: readOnly, maxPerTxUsd, dan daftar izin penerima transfer. Nonaktif secara default; berlaku untuk pengiriman maupun swap. IW_READ_ONLY=true membuat seluruh server menjadi read-only.

Instalasi

Opsi 1: npx (direkomendasikan)

Gunakan npx untuk menjalankan server tanpa instalasi global. Ini memastikan Anda selalu menggunakan versi terbaru.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

Peluncuran pertama mungkin memakan waktu ~30 detik saat dependensi diinstal. Jika klien MCP Anda mengalami timeout, jalankan perintah sekali di terminal untuk memanaskan cache, lalu sambungkan kembali.

Opsi 2: Instalasi global

Instal paket secara global untuk startup yang lebih cepat, lalu jalankan ironwallet-mcp.

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

Panduan pengaturan

Hanya untuk desktop

Setiap klien memiliki URL statis khusus (contohnya /ai/introduction/vscode/). Semua perintah instalasi di bawah ini juga disertakan langsung di halaman ini — tanpa tab, tidak ada yang tersembunyi di balik klik.

Cursor

Paling direkomendasikan

Buka di Cursor

Instal sekali. Setelah itu, alat dompet tersedia di setiap obrolan. Anda juga dapat menempelkan ini ke ~/.cursor/mcp.json dan memulai ulang Cursor.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

Muat ulang Cursor setelah instalasi agar PATH menyertakan npx.

Halaman mandiri untuk Cursor — satu pengambilan HTTP hanya mengembalikan panduan ini.

Claude Code

Buka di Claude Code

Jalankan perintah ini secara berurutan:

1claude plugin marketplace add ironwallet/ironwallet-agent-kit

2claude plugin install ironwallet-mcp@ironwallet

Setelah instalasi plugin, tunggu ~45 detik dan mulai obrolan baru agar alat dimuat.

Atau arahkan Claude Code ke server stdio secara langsung:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

Halaman mandiri untuk Claude Code — satu pengambilan HTTP hanya mengembalikan panduan ini.

VS Code

Buka di VS Code

Membuka VS Code dan mendaftarkan server MCP lokal. Anda juga dapat menambahkannya ke pengaturan MCP VS Code Anda (pengguna atau ruang kerja).

2 "mcp": {

3 "servers": {

4 "ironwallet": {

5 "type": "stdio",

6 "command": "npx",

7 "args": ["-y", "@ironwallet/mcp-server"]

8 }

9 }

10 }

11}

Halaman mandiri untuk VS Code — satu pengambilan HTTP hanya mengembalikan panduan ini.

ChatGPT

Buka di ChatGPT

Jalankan perintah ini secara berurutan, lalu muat ulang agar alat MCP tersedia.

1codex plugin marketplace add ironwallet/ironwallet-agent-kit

2codex plugin add ironwallet-mcp@ironwallet

Atau arahkan ChatGPT ke server stdio secara langsung:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

Halaman mandiri untuk ChatGPT — satu pengambilan HTTP hanya mengembalikan panduan ini.

Klien lain

Gunakan transport stdio. Arahkan klien MCP Anda ke:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

Halaman mandiri untuk Klien lain — satu pengambilan HTTP hanya mengembalikan panduan ini.

Jalan pertama & pengaturan dompet

Tidak ada proses masuk dan tidak ada akun. Pada peluncuran pertama, server membuat rahasia lokalnya — kunci API relay, rahasia pembungkus keystore, dan id perangkat — di bawah ~/.ironwallet-mcp/ dengan izin khusus pemilik. Tidak ada yang perlu dikonfigurasi.

Untuk mulai menggunakan dompet:

Persetujuan. Sebelum membuat atau mengimpor dompet, agen akan menampilkan penafian MCP di obrolan dan mencatat persetujuan Anda (accept_mcp_consent), atau Anda menekan Lanjutkan di pengelola dompet.

Buat atau impor. create_wallets mengembalikan nama dan alamat dompet ditambah backup_url — buka di browser Anda untuk melihat dan mencadangkan frasa pemulihan. Untuk mengimpor dompet yang ada atau membuat cadangan nanti, gunakan open_wallet_manager. Frasa pemulihan diketik atau ditampilkan hanya di halaman browser lokal, tidak pernah di dalam obrolan.

Isi saldo dompet. Minta agen untuk kode QR deposit (get_deposit_qr) atau alamat (list_wallets) dan kirimkan sejumlah kecil dana. Batasi saldo — ini adalah hot wallet.

Data pada disk

Server menyimpan statusnya di ~/.ironwallet-mcp/ (timpa dengan IW_KEYSTORE_DIR):

keystore terenkripsi dengan seed dompet Anda,

rahasia pembungkus, kunci API relay, dan id perangkat,

log diagnostik di bawah logs/ (materi seed tidak pernah dicatat).

Peringatan: jangan hapus direktori ini untuk "mereset" server.

Direktori ini berisi kunci terenkripsi untuk dana Anda. Jika Anda menghapusnya tanpa mencadangkan frasa pemulihan di pengelola dompet, dana akan hilang. Cadangan Anda adalah frasa pemulihan, bukan file-file ini.

Siapa pun yang memiliki keystore dan rahasia pembungkus dapat mengontrol dana, jadi perlakukan direktori tersebut sebagai data sensitif.

Variabel lingkungan

Kebanyakan pengguna tidak perlu mengatur variabel lingkungan apa pun. Server membuat dan menyimpan semua yang dibutuhkannya pada peluncuran pertama. Berikut ini tersedia untuk penggunaan tingkat lanjut:

Variabel

Deskripsi

Default

IW_READ_ONLY

Menolak send_transfer dan execute_swap di seluruh proses. Berbeda dari policy.readOnly per dompet

false

IW_KEYSTORE_DIR

Direktori keystore

~/.ironwallet-mcp

IW_PASSPHRASE

Timpa rahasia pembungkus keystore

generated locally

IW_RELAY_API_KEY

Timpa kunci API relay

generated UUID

IW_HTTP_TIMEOUT_MS

Timeout HTTP umum

15000

IW_HTTP_FORWARD_TIMEOUT_MS

Timeout untuk panggilan gaya siaran. Timeout klien tidak selalu berarti operasi gagal — periksa status

60000

IW_LOG_ENABLED

Diagnostik JSONL ke file log (0 untuk menonaktifkan)

IW_LOG_LEVEL

debug / info / warn / error

info

Keamanan

Seed tidak pernah meninggalkan mesin ini. Seed dienkripsi saat disimpan dan tidak pernah muncul dalam hasil alat, obrolan agen, log, atau permintaan backend. Tidak ada alat yang menerima atau mengembalikan seed — impor dan cadangan hanya terjadi di browser lokal.

Agen dapat memindahkan dana tanpa bertanya lagi. Tidak ada UI konfirmasi per transaksi; pesan obrolan Anda adalah otorisasi. Transfer dan swap tidak dapat dibatalkan setelah disiarkan.

Batas opsional. Kebijakan per dompet (readOnly, maxPerTxUsd, daftar izin penerima) melalui set_wallet_policy, dan IW_READ_ONLY=true di seluruh server. Keduanya nonaktif secara default.

Hanya hot wallet. Jangan impor dompet utama atau tabungan Anda. Siapa pun yang memiliki keystore dan rahasia pembungkus dapat mengontrol dana; seed yang bocor tidak dapat dicabut.

Timeout bukan berarti gagal. Lakukan polling get_operation_status / get_swap_status sebelum mencoba ulang pengiriman atau swap.

Semua permintaan backend menggunakan HTTPS; file rahasia lokal menggunakan izin khusus pemilik (Unix 0600, NTFS ACL di Windows).

Pengungkapan kerentanan: SECURITY.md.

Pengujian

Uji server secara langsung menggunakan inspektur MCP. Ini akan membuka UI web interaktif tempat Anda dapat menguji panggilan alat tanpa asisten AI.

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

Pemecahan masalah

Klien MCP mengalami timeout pada awal mulai

npx mengunduh paket pada saat dijalankan pertama kali, yang bisa memakan waktu ~30 detik.

Jalankan npx -y @ironwallet/mcp-server sekali di terminal untuk memanaskan cache, lalu sambungkan kembali.
Atau instal secara global: npm install -g @ironwallet/mcp-server@latest.

Alat tidak muncul di klien

Pastikan Node.js 20+ terinstal: node --version.
Muat ulang klien setelah instalasi agar PATH menyertakan npx.
Setelah instalasi plugin (Claude Code / ChatGPT), mulai obrolan baru agar alat dimuat.
Pastikan file konfigurasi berisi JSON yang valid dan mulai ulang klien.
Uji server secara manual dengan inspektur MCP (lihat Pengujian).

`create_wallets` mengembalikan `needs_consent`

Penafian MCP belum diterima. Minta agen untuk menampilkan penafian lengkap dan konfirmasi (accept_mcp_consent), atau buka pengelola dompet dan tekan Lanjutkan.

Transfer atau swap mengalami timeout

Timeout bukan berarti gagal — transaksi mungkin sudah disiarkan. Lakukan polling get_operation_status (transfer) atau get_swap_status (swap) sebelum mencoba ulang. Jangan pernah kirim ulang secara membabi buta.

Pengiriman atau swap ditolak

Periksa list_wallets → policy: readOnly atau daftar izin penerima mungkin memblokir operasi. { enabled: false } berarti tidak ada batasan.
maxPerTxUsd gagal tertutup: jika tidak ada nilai tukar USD yang tersedia untuk aset tersebut, operasi ditolak.
Periksa apakah server berjalan dengan IW_READ_ONLY=true.

Setup MCP

Fitur

Instalasi

Panduan pengaturan

Cursor

Claude Code

VS Code

ChatGPT

Klien lain

Jalan pertama & pengaturan dompet

Data pada disk

Variabel lingkungan

Keamanan

Pengujian

Pemecahan masalah

Klien MCP mengalami timeout pada awal mulai

Alat tidak muncul di klien

create_wallets mengembalikan needs_consent

Transfer atau swap mengalami timeout

Pengiriman atau swap ditolak

Terkait

`create_wallets` mengembalikan `needs_consent`