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) предоставляет ИИ-агентам некастодиальный криптокошелек на вашем компьютере. Сид-фразы генерируются и шифруются локально — они никогда не покидают это устройство и не передаются агенту, LLM или бэкендам IronWallet. Агенты могут проверять баланс, показывать QR-коды для депозита, переводить токены и выполнять обмен в 12 сетях: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP и TON.

Здесь нет интерфейса подтверждения каждой транзакции — как только вы просите агента отправить или обменять средства, он может подписать и отправить транзакцию без повторного запроса. Используйте отдельный «горячий» кошелек с ограниченным балансом, никогда не используйте свой основной кошелек.

Требования: Node.js 20+ (npx). Только для настольных ПК / stdio.

Функции

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

Сид-фразы остаются зашифрованными на хосте (права доступа к файлам только для владельца). Транзакции подписываются на этом устройстве; ни один инструмент не принимает и не возвращает сид-фразу.

Кошельки в локальном браузере

Создавайте кошельки с помощью 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

Максимальный уровень навыков

Требуются дополнительные плагины для платной версии ИИ-моделей

Открыть в 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):

зашифрованное хранилище ключей с сид-фразами вашего кошелька,

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

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

Внимание: не удаляйте эту папку для «сброса» сервера.

В ней содержатся зашифрованные ключи от ваших средств. Если вы удалите ее, не сделав резервную копию фразы восстановления в менеджере кошельков, средства будут потеряны. Ваша резервная копия — это фраза восстановления, а не эти файлы.

Любой, у кого есть хранилище ключей и секрет для его шифрования, получает контроль над средствами, поэтому относитесь к этой папке как к конфиденциальной.

Переменные окружения

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

Переменная
Описание
По умолчанию
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

Безопасность

Сид-фразы никогда не покидают это устройство. Они зашифрованы в покое и никогда не появляются в результатах инструментов, чате агента, логах или запросах к бэкенду. Ни один инструмент не принимает и не возвращает сид-фразу — импорт и резервное копирование происходят только в локальном браузере.

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

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

Только «горячий» кошелек. Не импортируйте свой основной или сберегательный кошелек. Любой, у кого есть хранилище ключей и секрет шифрования, контролирует средства; скомпрометированную сид-фразу невозможно отозвать.

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

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

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

Тестирование

Протестируйте сервер напрямую с помощью инспектора MCP. Это откроет интерактивный веб-интерфейс, где можно проверить вызовы инструментов без ИИ-ассистента.

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 срабатывает при отсутствии курса USD для актива: операция будет отклонена.
  • Проверьте, запущен ли сервер с параметром IW_READ_ONLY=true.