Setup ng MCP

I-install at i-configure ang IronWallet MCP server para sa Cursor, Claude Code, ChatGPT, at iba pang MCP client.

Ang IronWallet MCP server (@ironwallet/mcp-server) ay nagbibigay sa mga AI agent ng non-custodial na crypto wallet sa iyong computer. Ang mga seed phrase ay ginagawa at ine-encrypt nang lokal — hindi kailanman lumalabas sa makinang ito at hindi dumadaan sa agent, LLM, o mga backend ng IronWallet. Kayang mag-check ng mga agent ng balanse, magpakita ng deposit QR code, maglipat ng mga token, at mag-swap sa 12 network: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP, at TON.

Walang UI para sa kumpirmasyon bawat transaksyon — kapag inutusan mo ang agent na magpadala o mag-swap, kaya nitong mag-sign at mag-broadcast nang hindi na nagtatanong ulit. Gumamit ng nakalaang hot wallet na may limitadong balanse, huwag na huwag ang iyong main wallet.

Mga kinakailangan: Node.js 20+ (npx). Desktop / stdio lamang.

Mga Tampok

Non-custodial, lokal na pag-sign

Ang mga seed phrase ay nananatiling naka-encrypt sa host (mga file permission na para sa may-ari lamang). Ang mga transaksyon ay sini-sign sa makinang ito; walang tool na tumatanggap o nagbabalik ng seed.

Mga wallet sa lokal na browser

Gumawa ng mga wallet gamit ang create_wallets (nagbabalik ng backup_url), o mag-import at mag-backup sa pamamagitan ng open_wallet_manager — isang loopback-only na pahina sa 127.0.0.1 na namamatay pagkatapos ng 15 minutong hindi paggamit. Ang mga secret ay lumalabas lamang sa pahinang iyon ng browser, hindi kailanman sa chat.

Mga transfer na may pagtatantya ng fee

Ang estimate_transfer ay nagpapakita ng preview ng fee nang hindi nag-o-broadcast; ang send_transfer ay nag-o-sign nang lokal at nagpapadala; ang get_operation_status ay nag-po-poll ng resulta. Maaaring bawasan nang kaunti ng server ang halaga para magkasya ang fee sa balanse — sinasabi ng response kung kailan ito nangyari.

Mga swap na base sa catalog

Ang list_swap_networks at list_swap_assets ay nagbibigay ng catalog ng sell/buy para hindi mag-imbento ang agent ng mga token address. Ang estimate_swap ay nagbibigay ng quote, ang execute_swap ay nag-e-execute sa isang bagong quote, ang get_swap_status ay nag-po-poll.

Mga deposit QR code

Ang get_deposit_qr ay nagbabalik ng PNG para sa chat at may fallback na lokal na qr_url.

Opsyonal na mga limitasyon sa paggastos

Policy bawat wallet sa pamamagitan ng set_wallet_policy: readOnly, maxPerTxUsd, at allow-list ng recipient ng transfer. Naka-off bilang default; nalalapat sa parehong mga send at swap. Ang IW_READ_ONLY=true ay ginagawang read-only ang buong server.

Pag-install

Opsyong 1: npx (inirerekomenda)

Gamitin ang npx para patakbuhin ang server nang hindi na kailangang i-install nang global. Tinitiyak nito na palagi mong ginagamit ang pinakabagong bersyon.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Ang unang pagbukas ay maaaring tumagal ng ~30 segundo habang nag-i-install ng mga dependency. Kung mag-timeout ang iyong MCP client, patakbuhin ang command nang isang beses sa terminal para i-warm ang cache, pagkatapos ay kumonekta muli.

Opsyong 2: Global install

I-install ang package nang global para sa mas mabilis na startup, pagkatapos ay patakbuhin ang ironwallet-mcp.

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

Mga gabay sa pag-setup

Para sa desktop lamang

Ang bawat client ay may nakalaang static URL (halimbawa, /ai/introduction/vscode/). Ang lahat ng command sa pag-install sa ibaba ay naka-inline din sa pahinang ito — walang mga tab, walang nakatago sa likod ng mga click.

Cursor

Pinaka-inirerekomenda

Buksan sa Cursor

I-install nang isang beses. Pagkatapos noon, ang mga wallet tool ay magagamit na sa bawat chat. Maaari mo ring i-paste ito sa ~/.cursor/mcp.json at i-restart ang Cursor.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

I-reload ang Cursor pagkatapos ng install para maisama ang npx sa PATH.

Standalone na pahina para sa Cursor — ang isang HTTP fetch ay nagbabalik lamang ng gabay na ito.

Claude Code

Buksan sa Claude Code

Patakbuhin ang mga command na ito nang sunod-sunod:

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

2claude plugin install ironwallet-mcp@ironwallet

Pagkatapos ng plugin install, maghintay ng ~45 segundo at magsimula ng bagong chat para mag-load ang mga tool.

O ituro ang Claude Code sa stdio server nang direkta:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Standalone na pahina para sa Claude Code — ang isang HTTP fetch ay nagbabalik lamang ng gabay na ito.

VS Code

Buksan sa VS Code

Binubuksan ang VS Code at nirerehistro ang lokal na MCP server. Maaari mo ring idagdag ito sa iyong mga setting ng VS Code MCP (user o workspace).

2 "mcp": {

3 "servers": {

4 "ironwallet": {

5 "type": "stdio",

6 "command": "npx",

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

8 }

9 }

10 }

11}

Standalone na pahina para sa VS Code — ang isang HTTP fetch ay nagbabalik lamang ng gabay na ito.

ChatGPT

Buksan sa ChatGPT

Patakbuhin ang mga command na ito nang sunod-sunod, pagkatapos ay i-reload para maging available ang mga MCP tool.

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

2codex plugin add ironwallet-mcp@ironwallet

O ituro ang ChatGPT sa stdio server nang direkta:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Standalone na pahina para sa ChatGPT — ang isang HTTP fetch ay nagbabalik lamang ng gabay na ito.

Iba pang mga client

Gamitin ang stdio transport. Ituro ang iyong MCP client sa:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Standalone na pahina para sa Iba pang mga client — ang isang HTTP fetch ay nagbabalik lamang ng gabay na ito.

Unang pagtakbo at pag-setup ng wallet

Walang sign-in at walang account. Sa unang pagbukas, gagawa ang server ng mga lokal na secret nito — isang relay API key, isang keystore wrapping secret, at isang device id — sa ilalim ng ~/.ironwallet-mcp/ na may mga permission na para sa may-ari lamang. Wala nang kailangang i-configure.

Para magsimulang gumamit ng wallet:

Pahintulot. Bago gumawa o mag-import ng wallet, ipapakita ng agent ang MCP disclaimer sa chat at itatala ang iyong pagtanggap (accept_mcp_consent), o pindutin ang Continue sa wallet manager.

Gumawa o mag-import. Ang create_wallets ay nagbabalik ng mga pangalan at address ng wallet kasama ang isang backup_url — buksan ito sa iyong browser para makita at ma-backup ang recovery phrase. Para mag-import ng umiiral na wallet o gumawa ng backup mamaya, gamitin ang open_wallet_manager. Ang recovery phrase ay tina-type o ipinapakita lamang sa pahina ng lokal na browser, hindi kailanman sa chat.

Pondohan ang wallet. Humingi sa agent ng deposit QR (get_deposit_qr) o address (list_wallets) at magpadala ng maliit na halaga. Panatilihing limitado ang balanse — ito ay isang hot wallet.

Data sa disk

Itinatago ng server ang state nito sa ~/.ironwallet-mcp/ (i-override gamit ang IW_KEYSTORE_DIR):

ang naka-encrypt na keystore na may mga seed ng iyong wallet,

ang wrapping secret, relay API key, at device id,

mga diagnostic log sa ilalim ng logs/ (ang seed material ay hindi kailanman nilo-log).

Babala: huwag burahin ang directory na ito para "i-reset" ang server.

Naglalaman ito ng mga naka-encrypt na key para sa iyong mga pondo. Kung tatanggalin mo ito nang hindi na-backup ang recovery phrase sa wallet manager, mawawala ang mga pondo. Ang iyong backup ay ang recovery phrase, hindi ang mga file na ito.

Sinumang may hawak ng keystore at ng wrapping secret ay may kontrol sa mga pondo, kaya ituring ang directory na ito bilang sensitibo.

Environment variables

Karamihan sa mga user ay hindi kailangang mag-set ng anumang environment variable. Ang server ay gumagawa at nagtatago ng lahat ng kailangan nito sa unang pagbukas. Ang mga sumusunod ay magagamit para sa advanced na paggamit:

Variable

Paglalarawan

Default

IW_READ_ONLY

I-reject ang send_transfer at execute_swap sa buong proseso. Iba ito sa policy.readOnly bawat wallet

false

IW_KEYSTORE_DIR

Keystore directory

~/.ironwallet-mcp

IW_PASSPHRASE

I-override ang keystore wrapping secret

generated locally

IW_RELAY_API_KEY

I-override ang relay API key

generated UUID

IW_HTTP_TIMEOUT_MS

Pangkalahatang HTTP timeout

15000

IW_HTTP_FORWARD_TIMEOUT_MS

Timeout para sa mga call na may istilong broadcast. Ang client timeout ay hindi laging nangangahulugan na nabigo ang operasyon — i-check ang status

60000

IW_LOG_ENABLED

JSONL diagnostics sa isang log file (0 para i-disable)

IW_LOG_LEVEL

debug / info / warn / error

info

Seguridad

Ang mga seed ay hindi kailanman lumalabas sa makinang ito. Ang mga ito ay naka-encrypt at hindi kailanman lumalabas sa mga resulta ng tool, chat ng agent, log, o mga backend request. Walang tool na tumatanggap o nagbabalik ng seed — ang pag-import at pag-backup ay nangyayari lamang sa lokal na browser.

Kayang ilipat ng agent ang mga pondo nang hindi na nagtatanong ulit. Walang UI para sa kumpirmasyon bawat transaksyon; ang iyong chat message ang nagsisilbing awtorisasyon. Ang mga transfer at swap ay hindi na mababawi kapag na-broadcast na.

Opsyonal na mga limitasyon. Policy bawat wallet (readOnly, maxPerTxUsd, allow-list ng recipient) sa pamamagitan ng set_wallet_policy, at IW_READ_ONLY=true sa buong server. Parehong naka-off bilang default.

Hot wallet lamang. Huwag i-import ang iyong main o savings wallet. Sinumang may hawak ng keystore at wrapping secret ay may kontrol sa mga pondo; ang isang leaked na seed ay hindi na mababawi.

Ang timeout ay hindi pagkabigo. I-poll ang get_operation_status / get_swap_status bago subukang muli ang isang send o swap.

Ang lahat ng backend request ay gumagamit ng HTTPS; ang mga lokal na secret file ay gumagamit ng mga permission na para sa may-ari lamang (Unix 0600, NTFS ACL sa Windows).

Pagbubunyag ng kahinaan: SECURITY.md.

Pagsubok

Subukan ang server nang direkta gamit ang MCP inspector. Nagbubukas ito ng interactive na web UI kung saan maaari mong subukan ang mga tool call nang walang AI assistant.

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

Pag-troubleshoot

Nag-timeout ang MCP client sa unang pagbukas

Nagda-download ang npx ng package sa unang pagtakbo, na maaaring tumagal ng ~30 segundo.

Patakbuhin ang npx -y @ironwallet/mcp-server nang isang beses sa terminal para i-warm ang cache, pagkatapos ay kumonekta muli.
O i-install nang global: npm install -g @ironwallet/mcp-server@latest.

Hindi lumalabas ang mga tool sa client

I-check kung naka-install ang Node.js 20+: node --version.
I-reload ang client pagkatapos ng install para maisama ang npx sa PATH.
Pagkatapos ng plugin install (Claude Code / ChatGPT), magsimula ng bagong chat para mag-load ang mga tool.
I-verify na ang config file ay naglalaman ng valid na JSON at i-restart ang client.
Subukan ang server nang manual gamit ang MCP inspector (tingnan ang Pagsubok).

Ang `create_wallets` ay nagbabalik ng `needs_consent`

Hindi pa tinatanggap ang MCP disclaimer. Humingi sa agent na ipakita ang buong disclaimer at kumpirmahin (accept_mcp_consent), o buksan ang wallet manager at pindutin ang Continue.

Nag-timeout ang isang transfer o swap

Ang timeout ay hindi pagkabigo — maaaring na-broadcast na ang transaksyon. I-poll ang get_operation_status (mga transfer) o get_swap_status (mga swap) bago subukang muli. Huwag na huwag mag-resubmit nang hindi sinusuri.

Na-reject ang isang send o swap

I-check ang list_wallets → policy: maaaring hinaharangan ng readOnly o ng allow-list ng recipient ang operasyon. Ang { enabled: false } ay nangangahulugang walang mga limitasyon.
Ang maxPerTxUsd ay nagfe-fail nang sarado: kung walang available na USD rate para sa asset, mare-reject ang operasyon.
I-check kung tumatakbo ang server gamit ang IW_READ_ONLY=true.

Setup ng MCP

Mga Tampok

Pag-install

Mga gabay sa pag-setup

Cursor

Claude Code

VS Code

ChatGPT

Iba pang mga client

Unang pagtakbo at pag-setup ng wallet

Data sa disk

Environment variables

Seguridad

Pagsubok

Pag-troubleshoot

Nag-timeout ang MCP client sa unang pagbukas

Hindi lumalabas ang mga tool sa client

Ang create_wallets ay nagbabalik ng needs_consent

Nag-timeout ang isang transfer o swap

Na-reject ang isang send o swap

Mga kaugnay

Ang `create_wallets` ay nagbabalik ng `needs_consent`