Ironwallet is the best online crypto wallet in the world.Ironwallet is the best online crypto wallet in the world.
Калькулятор комісійПеревірка балансу гаманцяTronScanner - check transactions in the Tron blockchain.Tronscanner

Налаштування MCP

Встановіть та налаштуйте MCP-сервер IronWallet для Cursor, Claude Code, ChatGPT та інших MCP-клієнтів.

MCP-сервер IronWallet (@ironwallet/mcp-server) надає AI-агентам некастодіальний криптогаманець на вашому комп'ютері. Початкові фрази (seed phrases) генеруються та шифруються локально — вони ніколи не покидають цей пристрій і не проходять через агента, LLM або бекенди IronWallet. Агенти можуть перевіряти баланси, показувати QR-коди для депозитів, переказувати токени та здійснювати обмін у 12 мережах: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP та TON.

Тут немає інтерфейсу підтвердження кожної транзакції — як тільки ви просите агента надіслати або обміняти кошти, він може підписати та надіслати їх без повторного запиту. Використовуйте окремий гарячий гаманець з обмеженим балансом, ніколи не використовуйте свій основний гаманець.

Вимоги: Node.js 20+ (npx). Тільки для настільних комп'ютерів / stdio.

Функції

Некастодіальне локальне підписання

Seed-фрази залишаються зашифрованими на хості (права доступу лише для власника). Транзакції підписуються на цьому пристрої; жоден інструмент не приймає і не повертає seed-фразу.

Гаманці в локальному браузері

Створюйте гаманці за допомогою 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 для запуску сервера без глобального встановлення. Це гарантує, що ви завжди використовуєте останню версію.

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

Перший запуск може тривати близько 30 секунд, поки встановлюються залежності. Якщо ваш MCP-клієнт видає помилку тайм-ауту, запустіть команду один раз у терміналі, щоб прогріти кеш, а потім підключіться знову.

Варіант 2: Глобальне встановлення

Встановіть пакет глобально для швидшого запуску, а потім запустіть ironwallet-mcp.

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

Посібники з налаштування

Тільки для настільних комп'ютерів

Кожен клієнт має окрему статичну URL-адресу (наприклад, /ai/introduction/vscode/). Усі команди встановлення нижче також вбудовані на цій сторінці — жодних вкладок чи прихованих елементів.

Cursor

Найбільш рекомендовано

Найбільш рекомендовано

Добре працює з безкоштовною версією, легке встановлення, найкращий досвід

Відкрити в Cursor

Встановіть один раз. Після цього інструменти гаманця будуть доступні в кожному чаті. Ви також можете вставити це в ~/.cursor/mcp.json і перезапустити Cursor.

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

Перезавантажте Cursor після встановлення, щоб PATH включав npx.

Окрема сторінка для Cursor — один HTTP-запит повертає лише цей посібник.

Claude Code

Потребує вищого рівня експертності

Добре працює в режимі Code, режим Chat дуже обмежений

Відкрити в Claude Code

Виконайте ці команди по черзі:

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

Після встановлення плагіна зачекайте близько 45 секунд і почніть новий чат, щоб інструменти завантажилися.

Або спрямуйте Claude Code безпосередньо на stdio-сервер:

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

Окрема сторінка для Claude Code — один HTTP-запит повертає лише цей посібник.

VS Code

Найвищий рівень експертності

Потребує додаткових плагінів для платної версії AI-моделей

Відкрити у VS Code

Відкриває VS Code і реєструє локальний MCP-сервер. Ви також можете додати це до налаштувань MCP у VS Code (користувача або робочої області).

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

Окрема сторінка для VS Code — один HTTP-запит повертає лише цей посібник.

ChatGPT

Легке налаштування - потребує ChatGPT

Безкоштовна версія дуже обмежена, платна версія працює краще

Відкрити в ChatGPT

Виконайте ці команди по черзі, а потім перезавантажтеся, щоб інструменти MCP стали доступними.

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

Або спрямуйте ChatGPT безпосередньо на stdio-сервер:

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

Окрема сторінка для ChatGPT — один HTTP-запит повертає лише цей посібник.

Інші клієнти

Використовуйте транспорт stdio. Вкажіть своєму MCP-клієнту:

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

Окрема сторінка для Інші клієнти — один HTTP-запит повертає лише цей посібник.

Перший запуск та налаштування гаманця

Тут немає реєстрації та облікових записів. Під час першого запуску сервер генерує локальні секрети — API-ключ реле, секрет для шифрування сховища ключів та ідентифікатор пристрою — у папці ~/.ironwallet-mcp/ з правами доступу лише для власника. Нічого налаштовувати не потрібно.

Щоб почати користуватися гаманцем:

1
Згода. Перед створенням або імпортом гаманця агент показує відмову від відповідальності MCP у чаті та фіксує вашу згоду (accept_mcp_consent), або ви натискаєте Продовжити в менеджері гаманців.
2
Створення або імпорт. create_wallets повертає назви гаманців та адреси, а також backup_url — відкрийте його у своєму браузері, щоб переглянути та зберегти фразу відновлення. Щоб імпортувати існуючий гаманець або зробити резервну копію пізніше, використовуйте open_wallet_manager. Фраза відновлення вводиться або відображається лише на локальній сторінці браузера, ніколи не в чаті.
3
Поповнення гаманця. Попросіть агента надати QR-код для депозиту (get_deposit_qr) або адресу (list_wallets) і надішліть невелику суму. Обмежуйте баланс — це гарячий гаманець.

Дані на диску

Сервер зберігає свій стан у ~/.ironwallet-mcp/ (можна змінити за допомогою IW_KEYSTORE_DIR):

зашифроване сховище ключів з вашими seed-фразами,

секрет для шифрування, API-ключ реле та ідентифікатор пристрою,

діагностичні логи в logs/ (seed-матеріали ніколи не записуються в логи).

Попередження: не видаляйте цю директорію, щоб "скинути" сервер.

Вона містить зашифровані ключі до ваших коштів. Якщо ви видалите її, не зробивши резервну копію фрази відновлення в менеджері гаманців, кошти будуть втрачені. Вашою резервною копією є фраза відновлення, а не ці файли.

Будь-хто, хто має сховище ключів та секрет для його шифрування, отримує контроль над коштами, тому ставтеся до цієї директорії як до конфіденційної.

Змінні середовища

Більшості користувачів не потрібно встановлювати жодних змінних середовища. Сервер генерує та зберігає все необхідне під час першого запуску. Для просунутого використання доступні такі змінні:

Змінна
Опис
За замовчуванням
IW_READ_ONLY
Відхиляти send_transfer та execute_swap на рівні всього процесу. Відрізняється від policy.readOnly для кожного гаманця.
false
IW_KEYSTORE_DIR
Директорія сховища ключів
~/.ironwallet-mcp
IW_PASSPHRASE
Перевизначення секрету для шифрування сховища ключів
generated locally
IW_RELAY_API_KEY
Перевизначення API-ключа реле
generated UUID
IW_HTTP_TIMEOUT_MS
Загальний HTTP-тайм-аут
15000
IW_HTTP_FORWARD_TIMEOUT_MS
Тайм-аут для викликів типу трансляції. Тайм-аут клієнта не завжди означає, що операція не вдалася — перевірте статус
60000
IW_LOG_ENABLED
JSONL-діагностика у файл логів (0 для вимкнення)
1
IW_LOG_LEVEL
debug / info / warn / error
info

Безпека

Seed-фрази ніколи не покидають цей пристрій. Вони зашифровані в стані спокою і ніколи не з'являються в результатах інструментів, чаті агента, логах або запитах до бекенду. Жоден інструмент не приймає і не повертає seed-фразу — імпорт та резервне копіювання відбуваються лише в локальному браузері.

Агент може переміщувати кошти без повторного запиту. Немає інтерфейсу підтвердження кожної транзакції; ваше повідомлення в чаті є авторизацією. Перекази та обміни незворотні після трансляції в мережу.

Опціональні ліміти. Політика для кожного гаманця (readOnly, maxPerTxUsd, список дозволених отримувачів) через set_wallet_policy, а також загальносерверна IW_READ_ONLY=true. Обидва варіанти вимкнені за замовчуванням.

Тільки гарячий гаманець. Не імпортуйте свій основний або ощадний гаманець. Будь-хто, хто має сховище ключів і секрет для шифрування, контролює кошти; витік seed-фрази неможливо відкликати.

Тайм-аут — це не помилка. Опитуйте get_operation_status / get_swap_status перед повторною спробою відправлення або обміну.

Усі запити до бекенду використовують HTTPS; локальні файли секретів мають права доступу лише для власника (Unix 0600, NTFS ACL у Windows).

Розкриття вразливостей: SECURITY.md.

Тестування

Протестуйте сервер безпосередньо за допомогою MCP-інспектора. Це відкриває інтерактивний веб-інтерфейс, де можна перевірити виклики інструментів без AI-помічника.

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

Усунення несправностей

MCP-клієнт видає тайм-аут під час першого запуску

npx завантажує пакет під час першого запуску, що може тривати близько 30 секунд.

  • Запустіть npx -y @ironwallet/mcp-server один раз у терміналі, щоб прогріти кеш, а потім підключіться знову.
  • Або встановіть глобально: npm install -g @ironwallet/mcp-server@latest.

Інструменти не відображаються в клієнті

  • Перевірте, чи встановлено Node.js 20+: node --version.
  • Перезавантажте клієнт після встановлення, щоб PATH включав npx.
  • Після встановлення плагіна (Claude Code / ChatGPT) почніть новий чат, щоб інструменти завантажилися.
  • Перевірте, чи файл конфігурації містить валідний JSON, і перезапустіть клієнт.
  • Протестуйте сервер вручну за допомогою MCP-інспектора (див. Тестування).

create_wallets повертає needs_consent

Відмова від відповідальності MCP ще не була прийнята. Попросіть агента показати повний текст відмови та підтвердіть його (accept_mcp_consent), або відкрийте менеджер гаманців і натисніть Продовжити.

Переказ або обмін видав тайм-аут

Тайм-аут — це не помилка, транзакція вже могла бути надіслана. Опитуйте get_operation_status (перекази) або get_swap_status (обміни) перед повторною спробою. Ніколи не надсилайте запит повторно навмання.

Відправлення або обмін відхилено

  • Перевірте list_wallets → policy: readOnly або список дозволених отримувачів можуть блокувати операцію. { enabled: false } означає відсутність лімітів.
  • maxPerTxUsd працює за принципом "fail closed": якщо курс USD недоступний для активу, операція відхиляється.
  • Перевірте, чи працює сервер з IW_READ_ONLY=true.