MCP Kurulumu

Cursor, Claude Code, ChatGPT ve diğer MCP istemcileri için IronWallet MCP sunucusunu kurun ve yapılandırın.

IronWallet MCP sunucusu (@ironwallet/mcp-server), yapay zeka aracılarına bilgisayarınızda saklama hizmeti gerektirmeyen (non-custodial) bir kripto cüzdanı sağlar. Kurtarma ifadeleri yerel olarak oluşturulur ve şifrelenir; bu ifadeler asla makinenizden çıkmaz ve aracıya, LLM'e veya IronWallet arka uçlarına iletilmez. Aracılar bakiyeleri kontrol edebilir, para yatırma QR kodlarını gösterebilir, token transfer edebilir ve 12 ağda takas yapabilir: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP ve TON.

İşlem başına onay kullanıcı arayüzü yoktur; aracıya gönderim veya takas yapmasını söylediğinizde, tekrar sormadan imzalayabilir ve yayınlayabilir. Sınırlı bakiyeye sahip özel bir sıcak cüzdan kullanın, asla ana cüzdanınızı kullanmayın.

Gereksinimler: Node.js 20+ (npx). Yalnızca masaüstü / stdio.

Özellikler

Saklama hizmeti gerektirmeyen, yerel imzalama

Kurtarma ifadeleri ana bilgisayarda şifreli kalır (yalnızca sahibine özel dosya izinleri). İşlemler bu makinede imzalanır; hiçbir araç kurtarma ifadesi kabul etmez veya döndürmez.

Yerel tarayıcıda cüzdanlar

create_wallets ile cüzdanlar oluşturun (backup_url döndürür) veya open_wallet_manager aracılığıyla içe aktarıp yedekleyin — bu, 127.0.0.1 üzerinde çalışan ve 15 dakika hareketsizlikten sonra kapanan, sadece yerel bağlantıya izin veren bir sayfadır. Sırlar yalnızca o tarayıcı sayfasında görünür, sohbette asla görünmez.

Ücret tahminleriyle transferler

estimate_transfer yayınlamadan önce ücreti önizler; send_transfer yerel olarak imzalar ve gönderir; get_operation_status sonucu sorgular. Sunucu, ücretin bakiyeye sığması için miktarı biraz azaltabilir — yanıt, bunun ne zaman gerçekleştiğini belirtir.

Katalog tabanlı takaslar

list_swap_networks ve list_swap_assets, aracının asla token adresleri uydurmaması için satış/alış kataloğunu sağlar. estimate_swap fiyat teklifi verir, execute_swap yeni bir teklif üzerinde yürütür, get_swap_status sorgular.

Para yatırma QR kodları

get_deposit_qr, sohbet için bir PNG ve yerel bir qr_url yedeği döndürür.

İsteğe bağlı harcama limitleri

set_wallet_policy aracılığıyla cüzdan başına politika: readOnly, maxPerTxUsd ve transfer alıcısı izin listesi. Varsayılan olarak kapalıdır; hem gönderimler hem de takaslar için geçerlidir. IW_READ_ONLY=true tüm sunucuyu salt okunur yapar.

Kurulum

Seçenek 1: npx (önerilen)

Sunucuyu küresel kurulum yapmadan çalıştırmak için npx kullanın. Bu, her zaman en son sürümü kullanmanızı sağlar.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

İlk başlatma, bağımlılıklar yüklenirken ~30 saniye sürebilir. MCP istemciniz zaman aşımına uğrarsa, önbelleği ısıtmak için komutu bir terminalde bir kez çalıştırın ve ardından yeniden bağlanın.

Seçenek 2: Küresel kurulum

Daha hızlı başlatma için paketi küresel olarak yükleyin, ardından ironwallet-mcp komutunu çalıştırın.

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

Kurulum kılavuzları

Yalnızca masaüstü için

Her istemcinin özel bir statik URL'si vardır (örneğin /ai/introduction/vscode/). Aşağıdaki tüm kurulum komutları bu sayfada satır içi olarak verilmiştir; sekme yoktur, tıklamaların arkasında gizli hiçbir şey yoktur.

Cursor

En çok önerilen

Cursor'da Aç

Bir kez yükleyin. Bundan sonra, cüzdan araçları her sohbette kullanılabilir olur. Ayrıca bunu ~/.cursor/mcp.json dosyasına yapıştırıp Cursor'ı yeniden başlatabilirsiniz.

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

PATH değişkeninin npx içermesi için kurulumdan sonra Cursor'ı yeniden yükleyin.

Şunun için bağımsız sayfa: Cursor — tek bir HTTP isteği yalnızca bu kılavuzu döndürür.

Claude Code

Claude Code'da Aç

Bu komutları sırasıyla çalıştırın:

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

2claude plugin install ironwallet-mcp@ironwallet

Eklenti kurulumundan sonra ~45 saniye bekleyin ve araçların yüklenmesi için yeni bir sohbet başlatın.

Veya Claude Code'u doğrudan stdio sunucusuna yönlendirin:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Şunun için bağımsız sayfa: Claude Code — tek bir HTTP isteği yalnızca bu kılavuzu döndürür.

VS Code

VS Code'da Aç

VS Code'u açar ve yerel MCP sunucusunu kaydeder. Bunu VS Code MCP ayarlarınıza (kullanıcı veya çalışma alanı) da ekleyebilirsiniz.

2 "mcp": {

3 "servers": {

4 "ironwallet": {

5 "type": "stdio",

6 "command": "npx",

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

8 }

9 }

10 }

11}

Şunun için bağımsız sayfa: VS Code — tek bir HTTP isteği yalnızca bu kılavuzu döndürür.

ChatGPT

ChatGPT'de Aç

Bu komutları sırasıyla çalıştırın, ardından MCP araçlarının kullanılabilir olması için yeniden yükleyin.

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

2codex plugin add ironwallet-mcp@ironwallet

Veya ChatGPT'yi doğrudan stdio sunucusuna yönlendirin:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Şunun için bağımsız sayfa: ChatGPT — tek bir HTTP isteği yalnızca bu kılavuzu döndürür.

Diğer istemciler

stdio aktarımını kullanın. MCP istemcinizi şuraya yönlendirin:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

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

6 }

7 }

Şunun için bağımsız sayfa: Diğer istemciler — tek bir HTTP isteği yalnızca bu kılavuzu döndürür.

İlk çalıştırma ve cüzdan kurulumu

Giriş veya hesap yoktur. İlk başlatmada sunucu, yerel sırlarını — bir aktarma API anahtarı, anahtar deposu sarmalama sırrı ve cihaz kimliği — ~/.ironwallet-mcp/ altında, yalnızca sahibine özel izinlerle oluşturur. Yapılandırılacak hiçbir şey yoktur.

Cüzdan kullanmaya başlamak için:

Onay. Bir cüzdan oluşturmadan veya içe aktarmadan önce, aracı sohbette MCP sorumluluk reddini gösterir ve kabulünüzü kaydeder (accept_mcp_consent) veya cüzdan yöneticisinde Devam'a basarsınız.

Oluşturma veya içe aktarma. create_wallets, cüzdan adlarını ve adreslerini artı bir backup_url döndürür — kurtarma ifadesini görüntülemek ve yedeklemek için tarayıcınızda açın. Mevcut bir cüzdanı içe aktarmak veya daha sonra yedeklemek için open_wallet_manager kullanın. Kurtarma ifadesi yalnızca yerel tarayıcı sayfasında yazılır veya gösterilir, sohbette asla görünmez.

Cüzdana fon sağlama. Aracıdan bir para yatırma QR'ı (get_deposit_qr) veya bir adres (list_wallets) isteyin ve küçük bir miktar gönderin. Bakiyeyi sınırlı tutun — bu bir sıcak cüzdandır.

Disk üzerindeki veriler

Sunucu durumunu ~/.ironwallet-mcp/ içinde tutar (IW_KEYSTORE_DIR ile geçersiz kılınabilir):

cüzdan kurtarma ifadelerinizin bulunduğu şifreli anahtar deposu,

sarmalama sırrı, aktarma API anahtarı ve cihaz kimliği,

logs/ altındaki tanılama günlükleri (kurtarma ifadesi materyalleri asla günlüğe kaydedilmez).

Uyarı: Sunucuyu "sıfırlamak" için bu dizini silmeyin.

Fonlarınıza ait şifreli anahtarları içerir. Cüzdan yöneticisinde kurtarma ifadesini yedeklemeden silerseniz, fonlar kaybolur. Yedeklemeniz bu dosyalar değil, kurtarma ifadesidir.

Anahtar deposuna ve sarmalama sırrına sahip olan herkes fonları kontrol edebilir, bu nedenle dizini hassas olarak değerlendirin.

Ortam değişkenleri

Çoğu kullanıcının herhangi bir ortam değişkeni ayarlamasına gerek yoktur. Sunucu, ilk başlatmada ihtiyaç duyduğu her şeyi oluşturur ve saklar. İleri düzey kullanım için şunlar mevcuttur:

Değişken

Açıklama

Varsayılan

IW_READ_ONLY

send_transfer ve execute_swap işlemlerini süreç genelinde reddeder. Cüzdan başına policy.readOnly ayarından farklıdır.

false

IW_KEYSTORE_DIR

Anahtar deposu dizini

~/.ironwallet-mcp

IW_PASSPHRASE

Anahtar deposu sarmalama sırrını geçersiz kıl

generated locally

IW_RELAY_API_KEY

Aktarma API anahtarını geçersiz kıl

generated UUID

IW_HTTP_TIMEOUT_MS

Genel HTTP zaman aşımı

15000

IW_HTTP_FORWARD_TIMEOUT_MS

Yayınlama tarzı çağrılar için zaman aşımı. İstemci zaman aşımı her zaman işlemin başarısız olduğu anlamına gelmez — durumu kontrol edin

60000

IW_LOG_ENABLED

Bir günlük dosyasına JSONL tanılaması (0 devre dışı bırakır)

IW_LOG_LEVEL

debug / info / warn / error

info

Güvenlik

Kurtarma ifadeleri asla bu makineden çıkmaz. Dinlenme halindeyken şifrelenirler ve araç sonuçlarında, aracı sohbetinde, günlüklerde veya arka uç isteklerinde asla görünmezler. Hiçbir araç bir kurtarma ifadesi kabul etmez veya döndürmez — içe aktarma ve yedekleme yalnızca yerel tarayıcıda gerçekleşir.

Aracı, tekrar sormadan fonları taşıyabilir. İşlem başına onay kullanıcı arayüzü yoktur; sohbet mesajınız yetkilendirmedir. Transferler ve takaslar yayınlandıktan sonra geri alınamaz.

İsteğe bağlı limitler. set_wallet_policy aracılığıyla cüzdan başına politika (readOnly, maxPerTxUsd, alıcı izin listesi) ve sunucu genelinde IW_READ_ONLY=true. Her ikisi de varsayılan olarak kapalıdır.

Yalnızca sıcak cüzdan. Ana veya birikim cüzdanınızı içe aktarmayın. Anahtar deposuna ve sarmalama sırrına sahip olan herkes fonları kontrol edebilir; sızdırılmış bir kurtarma ifadesi iptal edilemez.

Zaman aşımı başarısızlık değildir. Bir gönderim veya takası yeniden denemeden önce get_operation_status / get_swap_status ile sorgulayın.

Tüm arka uç istekleri HTTPS kullanır; yerel gizli dosyalar yalnızca sahibine özel izinler kullanır (Unix 0600, Windows'ta NTFS ACL).

Güvenlik açığı bildirimi: SECURITY.md.

Test etme

Sunucuyu doğrudan MCP denetçisini kullanarak test edin. Bu, bir yapay zeka asistanı olmadan araç çağrılarını test edebileceğiniz etkileşimli bir web arayüzü açar.

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

Sorun giderme

MCP istemcisi ilk başlatmada zaman aşımına uğruyor

npx paketi ilk çalıştırmada indirir, bu ~30 saniye sürebilir.

Önbelleği ısıtmak için bir terminalde npx -y @ironwallet/mcp-server komutunu bir kez çalıştırın, ardından yeniden bağlanın.
Veya küresel olarak yükleyin: npm install -g @ironwallet/mcp-server@latest.

Araçlar istemcide görünmüyor

Node.js 20+ sürümünün yüklü olduğunu kontrol edin: node --version.
PATH değişkeninin npx içermesi için kurulumdan sonra istemciyi yeniden yükleyin.
Bir eklenti kurulumundan sonra (Claude Code / ChatGPT), araçların yüklenmesi için yeni bir sohbet başlatın.
Yapılandırma dosyasının geçerli JSON içerdiğini doğrulayın ve istemciyi yeniden başlatın.
Sunucuyu MCP denetçisi ile manuel olarak test edin (Test etme bölümüne bakın).

`create_wallets` `needs_consent` döndürüyor

MCP sorumluluk reddi henüz kabul edilmedi. Aracıdan tam sorumluluk reddini göstermesini isteyin ve onaylayın (accept_mcp_consent) veya cüzdan yöneticisini açıp Devam'a basın.

Bir transfer veya takas zaman aşımına uğradı

Zaman aşımı bir başarısızlık değildir — işlem çoktan yayınlanmış olabilir. Yeniden denemeden önce get_operation_status (transferler) veya get_swap_status (takaslar) ile sorgulayın. Asla körü körüne yeniden göndermeyin.

Bir gönderim veya takas reddedildi

list_wallets → policy kısmını kontrol edin: readOnly veya bir alıcı izin listesi işlemi engelliyor olabilir. { enabled: false } limit olmadığı anlamına gelir.
maxPerTxUsd başarısız olursa işlem durur: varlık için USD kuru mevcut değilse, işlem reddedilir.
Sunucunun IW_READ_ONLY=true ile çalışıp çalışmadığını kontrol edin.

MCP Kurulumu

Özellikler

Kurulum

Kurulum kılavuzları

Cursor

Claude Code

VS Code

ChatGPT

Diğer istemciler

İlk çalıştırma ve cüzdan kurulumu

Disk üzerindeki veriler

Ortam değişkenleri

Güvenlik

Test etme

Sorun giderme

MCP istemcisi ilk başlatmada zaman aşımına uğruyor

Araçlar istemcide görünmüyor

create_wallets needs_consent döndürüyor

Bir transfer veya takas zaman aşımına uğradı

Bir gönderim veya takas reddedildi

İlgili

`create_wallets` `needs_consent` döndürüyor