Konfiguracja MCP

Zainstaluj i skonfiguruj serwer IronWallet MCP dla Cursor, Claude Code, ChatGPT oraz innych klientów MCP.

Serwer IronWallet MCP (@ironwallet/mcp-server) zapewnia agentom AI niepowierniczy portfel kryptowalutowy na Twoim komputerze. Frazy seed są generowane i szyfrowane lokalnie — nigdy nie opuszczają tego urządzenia i nie przechodzą przez agenta, model LLM ani backendy IronWallet. Agenci mogą sprawdzać salda, wyświetlać kody QR do wpłat, przesyłać tokeny i wymieniać środki w 12 sieciach: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP oraz TON.

Nie ma interfejsu potwierdzania transakcji — gdy poprosisz agenta o wysłanie lub wymianę środków, może on podpisać i rozesłać transakcję bez ponownego pytania. Używaj dedykowanego portfela typu „hot wallet” z ograniczonym saldem, nigdy swojego głównego portfela.

Wymagania: Node.js 20+ (npx). Tylko wersja desktopowa / stdio.

Funkcje

Niepowiernicze, lokalne podpisywanie

Frazy seed pozostają zaszyfrowane na hoście (uprawnienia plików tylko dla właściciela). Transakcje są podpisywane na tym urządzeniu; żadne narzędzie nie przyjmuje ani nie zwraca frazy seed.

Portfele w lokalnej przeglądarce

Twórz portfele za pomocą create_wallets (zwraca backup_url) lub importuj i twórz kopie zapasowe przez open_wallet_manager — stronę działającą tylko w pętli zwrotnej na 127.0.0.1, która wyłącza się po 15 minutach bezczynności. Sekrety pojawiają się tylko na tej stronie przeglądarki, nigdy na czacie.

Przelewy z szacowaniem opłat

estimate_transfer podgląda opłatę bez rozsyłania; send_transfer podpisuje lokalnie i wysyła; get_operation_status odpytuje o wynik. Serwer może nieznacznie zmniejszyć kwotę, aby opłata zmieściła się w saldzie — odpowiedź informuje, kiedy to nastąpiło.

Wymiany oparte na katalogu

list_swap_networks i list_swap_assets dostarczają katalog sprzedaży/kupna, dzięki czemu agent nigdy nie wymyśla adresów tokenów. estimate_swap wycenia, execute_swap wykonuje na podstawie świeżej wyceny, get_swap_status odpytuje o status.

Kody QR do wpłat

get_deposit_qr zwraca plik PNG dla czatu oraz lokalny fallback qr_url.

Opcjonalne limity wydatków

Polityka dla portfela przez set_wallet_policy: readOnly, maxPerTxUsd oraz lista dozwolonych odbiorców przelewów. Domyślnie wyłączone; dotyczy zarówno wysyłek, jak i wymian. IW_READ_ONLY=true sprawia, że cały serwer jest tylko do odczytu.

Instalacja

Opcja 1: npx (zalecane)

Użyj npx, aby uruchomić serwer bez globalnej instalacji. Zapewnia to, że zawsze używasz najnowszej wersji.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Pierwsze uruchomienie może zająć około 30 sekund podczas instalacji zależności. Jeśli klient MCP przekroczy limit czasu, uruchom polecenie raz w terminalu, aby rozgrzać pamięć podręczną, a następnie połącz się ponownie.

Opcja 2: Instalacja globalna

Zainstaluj pakiet globalnie, aby przyspieszyć uruchamianie, a następnie uruchom ironwallet-mcp.

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

Przewodniki konfiguracji

Tylko dla wersji desktopowej

Każdy klient ma dedykowany statyczny adres URL (na przykład /ai/introduction/vscode/). Wszystkie poniższe polecenia instalacyjne są również zawarte na tej stronie — brak zakładek, nic nie jest ukryte za kliknięciami.

Cursor

Najbardziej zalecane

Otwórz w Cursor

Zainstaluj raz. Po tym narzędzia portfela będą dostępne w każdym czacie. Możesz również wkleić to do ~/.cursor/mcp.json i zrestartować Cursor.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Przeładuj Cursor po instalacji, aby PATH zawierało npx.

Samodzielna strona dla Cursor — jedno zapytanie HTTP zwraca tylko ten przewodnik.

Claude Code

Otwórz w Claude Code

Uruchom te polecenia w kolejności:

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

2claude plugin install ironwallet-mcp@ironwallet

Po instalacji wtyczki odczekaj około 45 sekund i rozpocznij nowy czat, aby narzędzia się załadowały.

Lub skieruj Claude Code bezpośrednio na serwer stdio:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Samodzielna strona dla Claude Code — jedno zapytanie HTTP zwraca tylko ten przewodnik.

VS Code

Otwórz w VS Code

Otwiera VS Code i rejestruje lokalny serwer MCP. Możesz również dodać to do swoich ustawień MCP w VS Code (użytkownika lub obszaru roboczego).

2 "mcp": {

3 "servers": {

4 "ironwallet": {

5 "type": "stdio",

6 "command": "npx",

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

8 }

9 }

10 }

11}

Samodzielna strona dla VS Code — jedno zapytanie HTTP zwraca tylko ten przewodnik.

ChatGPT

Otwórz w ChatGPT

Uruchom te polecenia w kolejności, a następnie przeładuj, aby narzędzia MCP były dostępne.

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

2codex plugin add ironwallet-mcp@ironwallet

Lub skieruj ChatGPT bezpośrednio na serwer stdio:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Samodzielna strona dla ChatGPT — jedno zapytanie HTTP zwraca tylko ten przewodnik.

Inni klienci

Użyj transportu stdio. Skieruj swojego klienta MCP na:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Samodzielna strona dla Inni klienci — jedno zapytanie HTTP zwraca tylko ten przewodnik.

Pierwsze uruchomienie i konfiguracja portfela

Nie ma logowania ani konta. Przy pierwszym uruchomieniu serwer generuje swoje lokalne sekrety — klucz API przekaźnika, sekret szyfrujący keystore oraz identyfikator urządzenia — w katalogu ~/.ironwallet-mcp/ z uprawnieniami tylko dla właściciela. Nie ma nic do skonfigurowania.

Aby rozpocząć korzystanie z portfela:

Zgoda. Przed utworzeniem lub zaimportowaniem portfela agent wyświetla zastrzeżenie MCP na czacie i rejestruje Twoją akceptację (accept_mcp_consent), lub klikasz Kontynuuj w menedżerze portfela.

Utwórz lub zaimportuj. create_wallets zwraca nazwy portfeli i adresy oraz backup_url — otwórz go w przeglądarce, aby wyświetlić i wykonać kopię zapasową frazy odzyskiwania. Aby zaimportować istniejący portfel lub wykonać kopię zapasową później, użyj open_wallet_manager. Fraza odzyskiwania jest wpisywana lub wyświetlana tylko na stronie lokalnej przeglądarki, nigdy na czacie.

Zasil portfel. Poproś agenta o kod QR do wpłaty (get_deposit_qr) lub adres (list_wallets) i wyślij niewielką kwotę. Ogranicz saldo — to jest portfel typu „hot wallet”.

Dane na dysku

Serwer przechowuje swój stan w ~/.ironwallet-mcp/ (można nadpisać za pomocą IW_KEYSTORE_DIR):

zaszyfrowany keystore z Twoimi frazami portfela,

sekret szyfrujący, klucz API przekaźnika oraz identyfikator urządzenia,

dzienniki diagnostyczne w logs/ (materiały seed nigdy nie są logowane).

Ostrzeżenie: nie usuwaj tego katalogu, aby „zresetować” serwer.

Zawiera on zaszyfrowane klucze do Twoich środków. Jeśli usuniesz go bez wykonania kopii zapasowej frazy odzyskiwania w menedżerze portfela, środki zostaną utracone. Twoją kopią zapasową jest fraza odzyskiwania, a nie te pliki.

Każdy, kto posiada keystore oraz sekret szyfrujący, kontroluje środki, więc traktuj ten katalog jako poufny.

Zmienne środowiskowe

Większość użytkowników nie musi ustawiać żadnych zmiennych środowiskowych. Serwer generuje i przechowuje wszystko, czego potrzebuje, przy pierwszym uruchomieniu. Poniższe zmienne są dostępne do zaawansowanego użytku:

Zmienna

Opis

Domyślnie

IW_READ_ONLY

Odrzuć send_transfer i execute_swap w całym procesie. Różni się od policy.readOnly dla poszczególnych portfeli

false

IW_KEYSTORE_DIR

Katalog keystore

~/.ironwallet-mcp

IW_PASSPHRASE

Nadpisz sekret szyfrujący keystore

generated locally

IW_RELAY_API_KEY

Nadpisz klucz API przekaźnika

generated UUID

IW_HTTP_TIMEOUT_MS

Ogólny limit czasu HTTP

15000

IW_HTTP_FORWARD_TIMEOUT_MS

Limit czasu dla wywołań typu broadcast. Limit czasu klienta nie zawsze oznacza, że operacja się nie powiodła — sprawdź status

60000

IW_LOG_ENABLED

Diagnostyka JSONL do pliku dziennika (0 aby wyłączyć)

IW_LOG_LEVEL

debug / info / warn / error

info

Bezpieczeństwo

Frazy seed nigdy nie opuszczają tego urządzenia. Są szyfrowane w spoczynku i nigdy nie pojawiają się w wynikach narzędzi, na czacie agenta, w logach ani w żądaniach backendu. Żadne narzędzie nie przyjmuje ani nie zwraca frazy seed — import i tworzenie kopii zapasowych odbywają się tylko w lokalnej przeglądarce.

Agent może przesuwać środki bez ponownego pytania. Brak interfejsu potwierdzania transakcji; Twoja wiadomość na czacie jest autoryzacją. Przelewy i wymiany są nieodwracalne po rozesłaniu.

Opcjonalne limity. Polityka dla portfela (readOnly, maxPerTxUsd, lista dozwolonych odbiorców) przez set_wallet_policy oraz globalne ustawienie serwera IW_READ_ONLY=true. Obie opcje są domyślnie wyłączone.

Tylko portfel typu „hot wallet”. Nie importuj swojego głównego portfela ani portfela oszczędnościowego. Każdy, kto posiada keystore i sekret szyfrujący, kontroluje środki; wyciek frazy seed nie może zostać cofnięty.

Limit czasu to nie awaria. Odpytaj get_operation_status / get_swap_status przed ponowieniem wysyłki lub wymiany.

Wszystkie żądania backendu używają HTTPS; lokalne pliki z sekretami używają uprawnień tylko dla właściciela (Unix 0600, NTFS ACL w systemie Windows).

Ujawnienie podatności: SECURITY.md.

Testowanie

Przetestuj serwer bezpośrednio za pomocą inspektora MCP. Otwiera to interaktywny interfejs internetowy, w którym możesz testować wywołania narzędzi bez asystenta AI.

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

Rozwiązywanie problemów

Klient MCP przekracza limit czasu przy pierwszym uruchomieniu

npx pobiera pakiet przy pierwszym uruchomieniu, co może zająć około 30 sekund.

Uruchom npx -y @ironwallet/mcp-server raz w terminalu, aby rozgrzać pamięć podręczną, a następnie połącz się ponownie.
Lub zainstaluj globalnie: npm install -g @ironwallet/mcp-server@latest.

Narzędzia nie pojawiają się u klienta

Sprawdź, czy zainstalowano Node.js 20+: node --version.
Przeładuj klienta po instalacji, aby PATH zawierało npx.
Po instalacji wtyczki (Claude Code / ChatGPT) rozpocznij nowy czat, aby narzędzia się załadowały.
Sprawdź, czy plik konfiguracyjny zawiera poprawny JSON i zrestartuj klienta.
Przetestuj serwer ręcznie za pomocą inspektora MCP (zobacz Testowanie).

`create_wallets` zwraca `needs_consent`

Zastrzeżenie MCP nie zostało jeszcze zaakceptowane. Poproś agenta o wyświetlenie pełnego zastrzeżenia i potwierdź (accept_mcp_consent), lub otwórz menedżer portfela i kliknij Kontynuuj.

Przelew lub wymiana przekroczyły limit czasu

Limit czasu nie oznacza awarii — transakcja mogła już zostać rozesłana. Odpytaj get_operation_status (przelewy) lub get_swap_status (wymiany) przed ponowieniem próby. Nigdy nie wysyłaj ponownie bez sprawdzenia.

Wysłanie lub wymiana zostały odrzucone

Sprawdź list_wallets → policy: readOnly lub lista dozwolonych odbiorców może blokować operację. { enabled: false } oznacza brak limitów.
maxPerTxUsd kończy się niepowodzeniem, jeśli dla zasobu nie jest dostępny kurs USD, operacja jest odrzucana.
Sprawdź, czy serwer działa z IW_READ_ONLY=true.

Konfiguracja MCP

Funkcje

Instalacja

Przewodniki konfiguracji

Cursor

Claude Code

VS Code

ChatGPT

Inni klienci

Pierwsze uruchomienie i konfiguracja portfela

Dane na dysku

Zmienne środowiskowe

Bezpieczeństwo

Testowanie

Rozwiązywanie problemów

Klient MCP przekracza limit czasu przy pierwszym uruchomieniu

Narzędzia nie pojawiają się u klienta

create_wallets zwraca needs_consent

Przelew lub wymiana przekroczyły limit czasu

Wysłanie lub wymiana zostały odrzucone

Powiązane

`create_wallets` zwraca `needs_consent`