Ironwallet is the best online crypto wallet in the world.Ironwallet is the best online crypto wallet in the world.
Calcolatore commissioniControllo saldo walletTronScanner - check transactions in the Tron blockchain.Tronscanner

Configurazione MCP

Installa e configura il server MCP di IronWallet per Cursor, Claude Code, ChatGPT e altri client MCP.

Il server MCP di IronWallet (@ironwallet/mcp-server) fornisce agli agenti IA un portafoglio crypto non-custodial sul tuo computer. Le frasi di ripristino (seed phrase) vengono generate e crittografate localmente: non lasciano mai questa macchina e non passano mai attraverso l'agente, l'LLM o i backend di IronWallet. Gli agenti possono controllare i saldi, mostrare codici QR per i depositi, trasferire token ed effettuare swap su 12 reti: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP e TON.

Non esiste un'interfaccia di conferma per singola transazione: una volta che chiedi all'agente di inviare o scambiare, questo può firmare e trasmettere senza chiedere nuovamente. Usa un hot wallet dedicato con un saldo limitato, mai il tuo portafoglio principale.

Requisiti: Node.js 20+ (npx). Solo desktop / stdio.

Funzionalità

Firma locale non-custodial

Le frasi di ripristino rimangono crittografate sull'host (permessi file solo proprietario). Le transazioni sono firmate su questa macchina; nessuno strumento accetta o restituisce una seed phrase.

Portafogli nel browser locale

Crea portafogli con create_wallets (restituisce un backup_url), o importa ed esegui il backup tramite open_wallet_manager: una pagina loopback su 127.0.0.1 che si chiude dopo 15 minuti di inattività. I segreti appaiono solo in quella pagina del browser, mai in chat.

Trasferimenti con stime delle commissioni

estimate_transfer visualizza in anteprima la commissione senza trasmettere; send_transfer firma localmente e invia; get_operation_status interroga il risultato. Il server potrebbe ridurre leggermente l'importo affinché la commissione rientri nel saldo: la risposta indica quando ciò accade.

Swap basati su catalogo

list_swap_networks e list_swap_assets forniscono il catalogo di vendita/acquisto in modo che l'agente non inventi mai indirizzi di token. estimate_swap quota, execute_swap esegue su una nuova quotazione, get_swap_status interroga lo stato.

Codici QR per depositi

get_deposit_qr restituisce un PNG per la chat più un fallback qr_url locale.

Limiti di spesa opzionali

Policy per portafoglio tramite set_wallet_policy: readOnly, maxPerTxUsd e una lista consentita di destinatari. Disabilitati per impostazione predefinita; si applicano sia a invii che a swap. IW_READ_ONLY=true rende l'intero server in sola lettura.

Installazione

Opzione 1: npx (consigliato)

Usa npx per eseguire il server senza installazione globale. Ciò garantisce di utilizzare sempre l'ultima versione.

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

Il primo avvio può richiedere circa 30 secondi durante l'installazione delle dipendenze. Se il client MCP va in timeout, esegui il comando una volta nel terminale per riscaldare la cache, quindi riconnettiti.

Opzione 2: Installazione globale

Installa il pacchetto globalmente per un avvio più rapido, quindi esegui ironwallet-mcp.

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

Guide alla configurazione

Solo per desktop

Ogni client ha un URL statico dedicato (ad esempio /ai/introduction/vscode/). Tutti i comandi di installazione qui sotto sono anche inclusi in questa pagina: niente schede, niente nascosto dietro clic.

Cursor

Il più consigliato

Il più consigliato

Funziona bene con la versione gratuita, installazione facile, esperienza migliore

Apri in Cursor

Installa una volta. Dopodiché, gli strumenti del portafoglio saranno disponibili in ogni chat. Puoi anche incollare questo in ~/.cursor/mcp.json e riavviare Cursor.

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

Riavvia Cursor dopo l'installazione affinché il PATH includa npx.

Pagina standalone per Cursor — una richiesta HTTP restituisce solo questa guida.

Claude Code

Richiede un livello esperto superiore

Funziona bene con la modalità Code, la modalità Chat è molto limitata

Apri in Claude Code

Esegui questi comandi in ordine:

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

Dopo l'installazione del plugin, attendi circa 45 secondi e avvia una nuova chat affinché gli strumenti vengano caricati.

Oppure punta Claude Code direttamente al server stdio:

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

Pagina standalone per Claude Code — una richiesta HTTP restituisce solo questa guida.

VS Code

Livello esperto massimo

Richiede plugin aggiuntivi con la versione a pagamento dei modelli IA

Apri in VS Code

Apre VS Code e registra il server MCP locale. Puoi anche aggiungerlo alle tue impostazioni MCP di VS Code (utente o area di lavoro).

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

Pagina standalone per VS Code — una richiesta HTTP restituisce solo questa guida.

ChatGPT

Configurazione facile - richiede ChatGPT

La versione gratuita è molto limitata, quella a pagamento funziona meglio

Apri in ChatGPT

Esegui questi comandi in ordine, quindi ricarica affinché gli strumenti MCP siano disponibili.

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

Oppure punta ChatGPT direttamente al server stdio:

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

Pagina standalone per ChatGPT — una richiesta HTTP restituisce solo questa guida.

Altri client

Usa il trasporto stdio. Punta il tuo client MCP a:

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

Pagina standalone per Altri client — una richiesta HTTP restituisce solo questa guida.

Primo avvio e configurazione del portafoglio

Non c'è accesso né account. Al primo avvio, il server genera i suoi segreti locali (una chiave API relay, un segreto per il keystore e un ID dispositivo) sotto ~/.ironwallet-mcp/ con permessi di solo proprietario. Non c'è nulla da configurare.

Per iniziare a usare un portafoglio:

1
Consenso. Prima di creare o importare un portafoglio, l'agente mostra il disclaimer MCP in chat e registra la tua accettazione (accept_mcp_consent), oppure premi Continua nel gestore portafogli.
2
Crea o importa. create_wallets restituisce nomi e indirizzi dei portafogli più un backup_url: aprilo nel tuo browser per visualizzare ed eseguire il backup della frase di ripristino. Per importare un portafoglio esistente o eseguire un backup in seguito, usa open_wallet_manager. La frase di ripristino viene digitata o mostrata solo nella pagina del browser locale, mai in chat.
3
Finanzia il portafoglio. Chiedi all'agente un QR code per il deposito (get_deposit_qr) o un indirizzo (list_wallets) e invia una piccola somma. Mantieni il saldo limitato: questo è un hot wallet.

Dati su disco

Il server mantiene il suo stato in ~/.ironwallet-mcp/ (sovrascrivibile con IW_KEYSTORE_DIR):

il keystore crittografato con le tue seed phrase,

il segreto di wrapping, la chiave API relay e l'ID dispositivo,

log diagnostici sotto logs/ (il materiale delle seed phrase non viene mai registrato).

Attenzione: non eliminare questa directory per "resettare" il server.

Contiene le chiavi crittografate dei tuoi fondi. Se la rimuovi senza aver eseguito il backup della frase di ripristino nel gestore portafogli, i fondi andranno persi. Il tuo backup è la frase di ripristino, non questi file.

Chiunque abbia il keystore e il segreto di wrapping controlla i fondi, quindi tratta la directory come sensibile.

Variabili d'ambiente

La maggior parte degli utenti non ha bisogno di impostare variabili d'ambiente. Il server genera e memorizza tutto ciò di cui ha bisogno al primo avvio. Le seguenti sono disponibili per un uso avanzato:

Variabile
Descrizione
Predefinito
IW_READ_ONLY
Rifiuta send_transfer e execute_swap a livello di processo. Distinto dalla policy.readOnly per portafoglio
false
IW_KEYSTORE_DIR
Directory del keystore
~/.ironwallet-mcp
IW_PASSPHRASE
Sovrascrivi il segreto di wrapping del keystore
generated locally
IW_RELAY_API_KEY
Sovrascrivi la chiave API relay
generated UUID
IW_HTTP_TIMEOUT_MS
Timeout HTTP generale
15000
IW_HTTP_FORWARD_TIMEOUT_MS
Timeout per chiamate di tipo broadcast. Un timeout del client non significa sempre che l'operazione sia fallita: controlla lo stato
60000
IW_LOG_ENABLED
Diagnostica JSONL su un file di log (0 per disabilitare)
1
IW_LOG_LEVEL
debug / info / warn / error
info

Sicurezza

Le seed phrase non lasciano mai questa macchina. Sono crittografate a riposo e non appaiono mai nei risultati degli strumenti, nella chat dell'agente, nei log o nelle richieste backend. Nessuno strumento accetta o restituisce una seed phrase: l'importazione e il backup avvengono solo nel browser locale.

L'agente può spostare fondi senza chiedere di nuovo. Non esiste un'interfaccia di conferma per singola transazione; il tuo messaggio in chat è l'autorizzazione. Trasferimenti e swap sono irreversibili una volta trasmessi.

Limiti opzionali. Policy per portafoglio (readOnly, maxPerTxUsd, lista consentita di destinatari) tramite set_wallet_policy e IW_READ_ONLY=true a livello di server. Entrambi sono disabilitati per impostazione predefinita.

Solo hot wallet. Non importare il tuo portafoglio principale o di risparmio. Chiunque abbia il keystore e il segreto di wrapping controlla i fondi; una seed phrase compromessa non può essere revocata.

Il timeout non è un fallimento. Interroga get_operation_status / get_swap_status prima di riprovare un invio o uno swap.

Tutte le richieste backend usano HTTPS; i file segreti locali usano permessi di solo proprietario (Unix 0600, ACL NTFS su Windows).

Divulgazione vulnerabilità: SECURITY.md.

Test

Testa il server direttamente usando l'ispettore MCP. Questo apre un'interfaccia web interattiva dove puoi testare le chiamate agli strumenti senza un assistente IA.

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

Risoluzione dei problemi

Il client MCP va in timeout al primo avvio

npx scarica il pacchetto al primo avvio, il che può richiedere circa 30 secondi.

  • Esegui npx -y @ironwallet/mcp-server una volta nel terminale per riscaldare la cache, quindi riconnettiti.
  • Oppure installa globalmente: npm install -g @ironwallet/mcp-server@latest.

Gli strumenti non appaiono nel client

  • Verifica che Node.js 20+ sia installato: node --version.
  • Riavvia il client dopo l'installazione affinché il PATH includa npx.
  • Dopo l'installazione di un plugin (Claude Code / ChatGPT), avvia una nuova chat affinché gli strumenti vengano caricati.
  • Verifica che il file di configurazione contenga JSON valido e riavvia il client.
  • Testa il server manualmente con l'ispettore MCP (vedi Test).

create_wallets restituisce needs_consent

Il disclaimer MCP non è ancora stato accettato. Chiedi all'agente di mostrare il disclaimer completo e conferma (accept_mcp_consent), oppure apri il gestore portafogli e premi Continua.

Un trasferimento o uno swap è andato in timeout

Un timeout non è un fallimento: la transazione potrebbe essere già stata trasmessa. Interroga get_operation_status (trasferimenti) o get_swap_status (swap) prima di riprovare. Non rispedire mai alla cieca.

Un invio o uno swap viene rifiutato

  • Controlla list_wallets → policy: readOnly o una lista consentita di destinatari potrebbe bloccare l'operazione. { enabled: false } significa nessun limite.
  • maxPerTxUsd fallisce se chiuso: se non è disponibile alcun tasso USD per l'asset, l'operazione viene rifiutata.
  • Controlla se il server è in esecuzione con IW_READ_ONLY=true.