התקן והגדר את שרת ה-MCP של IronWallet עבור Cursor, Claude Code, ChatGPT ולקוחות MCP אחרים.
שרת ה-MCP של IronWallet (@ironwallet/mcp-server) מעניק לסוכני AI ארנק קריפטו שאינו משמורני (non-custodial) על המחשב שלך. ביטויי הגיבוי (seed phrases) נוצרים ומוצפנים מקומית — הם לעולם לא עוזבים את המכשיר הזה ולעולם לא עוברים דרך הסוכן, ה-LLM או השרתים של IronWallet. סוכנים יכולים לבדוק יתרות, להציג קודי QR להפקדה, להעביר אסימונים ולבצע המרות (swaps) ב-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 כדי להריץ את השרת ללא התקנה גלובלית. זה מבטיח שתמיד תשתמש בגרסה העדכנית ביותר.
ההרצה הראשונה עשויה לקחת כ-30 שניות בזמן שהתלויות מותקנות. אם לקוח ה-MCP שלך מגיע לזמן קצוב (timeout), הרץ את הפקודה פעם אחת בטרמינל כדי לחמם את המטמון, ואז התחבר מחדש.
אפשרות 2: התקנה גלובלית
התקן את החבילה גלובלית להפעלה מהירה יותר, ואז הרץ את ironwallet-mcp.
לכל לקוח יש כתובת URL סטטית ייעודית (למשל /ai/introduction/vscode/). כל פקודות ההתקנה להלן מוטמעות גם בדף זה — ללא טאבים, ללא שום דבר מוסתר מאחורי לחיצות.
הכי מומלץ
עובד היטב עם הגרסה החינמית, התקנה קלה, החוויה הטובה ביותר
התקן פעם אחת. לאחר מכן, כלי הארנק יהיו זמינים בכל צ'אט. ניתן גם להדביק זאת ב-~/.cursor/mcp.json ולהפעיל מחדש את Cursor.
טען מחדש את Cursor לאחר ההתקנה כדי ש-PATH יכלול את npx.
דף עצמאי עבור Cursor — בקשת HTTP אחת מחזירה רק מדריך זה.
דורש רמת מומחיות גבוהה יותר
עובד היטב עם מצב Code, מצב Chat מוגבל מאוד
הרץ פקודות אלו לפי הסדר:
לאחר התקנת התוסף, המתן כ-45 שניות והתחל צ'אט חדש כדי שהכלים ייטענו.
או כוון את Claude Code ישירות לשרת ה-stdio:
דף עצמאי עבור Claude Code — בקשת HTTP אחת מחזירה רק מדריך זה.
רמת מומחיות הגבוהה ביותר
דורש תוספים נוספים עם גרסה בתשלום של מודלי AI
פותח את VS Code ורושם את שרת ה-MCP המקומי. ניתן גם להוסיף זאת להגדרות ה-MCP של VS Code (משתמש או סביבת עבודה).
דף עצמאי עבור VS Code — בקשת HTTP אחת מחזירה רק מדריך זה.
הגדרה קלה - דורש ChatGPT
הגרסה החינמית מוגבלת מאוד, גרסה בתשלום עובדת טוב יותר
הרץ פקודות אלו לפי הסדר, ואז טען מחדש כדי שכלי ה-MCP יהיו זמינים.
או כוון את ChatGPT ישירות לשרת ה-stdio:
דף עצמאי עבור ChatGPT — בקשת HTTP אחת מחזירה רק מדריך זה.
השתמש ב-stdio transport. כוון את לקוח ה-MCP שלך אל:
דף עצמאי עבור לקוחות אחרים — בקשת HTTP אחת מחזירה רק מדריך זה.
אין התחברות ואין חשבון. בהרצה הראשונה השרת מייצר את הסודות המקומיים שלו — מפתח API לממסר (relay), סוד להצפנת מאגר המפתחות (keystore) ומזהה מכשיר — תחת ~/.ironwallet-mcp/ עם הרשאות לבעלים בלבד. אין מה להגדיר.
כדי להתחיל להשתמש בארנק:
Tronscanneraccept_mcp_consent), או שאתה לוחץ על המשך במנהל הארנקים.create_wallets מחזיר שמות ארנקים וכתובות בתוספת backup_url — פתח אותו בדפדפן כדי לצפות ולגבות את ביטוי השחזור. כדי לייבא ארנק קיים או לבצע גיבוי מאוחר יותר, השתמש ב-open_wallet_manager. ביטוי השחזור מוקלד או מוצג רק בדף הדפדפן המקומי, לעולם לא בצ'אט.get_deposit_qr) או כתובת (list_wallets) ושלח סכום קטן. שמור על יתרה מוגבלת — זהו ארנק חם.השרת שומר את המצב שלו ב-~/.ironwallet-mcp/ (ניתן לעקוף עם IW_KEYSTORE_DIR):
מאגר המפתחות המוצפן עם ביטויי הארנק שלך,
סוד ההצפנה, מפתח ה-API לממסר ומזהה המכשיר,
יומני אבחון תחת logs/ (חומר ה-seed לעולם לא מתועד).
אזהרה: אל תמחק את התיקייה הזו כדי "לאפס" את השרת.
היא מכילה את המפתחות המוצפנים לכספים שלך. אם תסיר אותה מבלי לגבות את ביטוי השחזור במנהל הארנקים, הכספים יאבדו. הגיבוי שלך הוא ביטוי השחזור, לא הקבצים האלה.
לכל מי שיש גישה למאגר המפתחות ולסוד ההצפנה יש שליטה על הכספים, לכן התייחס לתיקייה כאל מידע רגיש.
רוב המשתמשים אינם צריכים להגדיר משתני סביבה כלשהם. השרת מייצר ושומר את כל מה שהוא צריך בהרצה הראשונה. הבאים זמינים לשימוש מתקדם:
send_transfer ו-execute_swap ברמת התהליך. נפרד מ-policy.readOnly של כל ארנק0 לביטול)debug / info / warn / errorביטויים לעולם לא עוזבים את המכונה הזו. הם מוצפנים במנוחה ולעולם לא מופיעים בתוצאות כלים, בצ'אט של הסוכן, ביומנים או בבקשות לשרתים. אף כלי לא מקבל או מחזיר ביטוי גיבוי — ייבוא וגיבוי קורים רק בדפדפן המקומי.
הסוכן יכול להעביר כספים ללא בקשת אישור נוספת. אין ממשק אישור לכל עסקה; הודעת הצ'אט שלך היא האישור. העברות והמרות הן בלתי הפיכות ברגע ששודרו.
מגבלות אופציונליות. מדיניות לכל ארנק (readOnly, maxPerTxUsd, רשימת מאושרים למקבלי העברות) דרך set_wallet_policy, ו-IW_READ_ONLY=true ברמת השרת. שניהם כבויים כברירת מחדל.
ארנק חם בלבד. אל תייבא את הארנק הראשי או ארנק החיסכון שלך. לכל מי שיש גישה למאגר המפתחות ולסוד ההצפנה יש שליטה על הכספים; לא ניתן לבטל ביטוי גיבוי שדלף.
זמן קצוב אינו כישלון. בדוק get_operation_status / get_swap_status לפני ניסיון חוזר של שליחה או המרה.
כל הבקשות לשרתים משתמשות ב-HTTPS; קבצי סודות מקומיים משתמשים בהרשאות לבעלים בלבד (Unix 0600, NTFS ACL ב-Windows).
חשיפת פגיעויות: SECURITY.md.
בדוק את השרת ישירות באמצעות ה-MCP inspector. זה פותח ממשק אינטראקטיבי שבו ניתן לבדוק קריאות לכלים ללא עוזר AI.
npx מוריד את החבילה בהרצה הראשונה, מה שיכול לקחת כ-30 שניות.
npx -y @ironwallet/mcp-server פעם אחת בטרמינל כדי לחמם את המטמון, ואז התחבר מחדש.npm install -g @ironwallet/mcp-server@latest.node --version.PATH יכלול את npx.create_wallets מחזיר needs_consentהצהרת ה-MCP טרם אושרה. בקש מהסוכן להציג את ההצהרה המלאה ולאשר (accept_mcp_consent), או פתח את מנהל הארנקים ולחץ על המשך.
זמן קצוב אינו כישלון — העסקה עשויה כבר להיות משודרת. בדוק get_operation_status (העברות) או get_swap_status (המירות) לפני ניסיון חוזר. לעולם אל תגיש שוב בצורה עיוורת.
list_wallets → policy: readOnly או רשימת מאושרים למקבלי העברות עשויים לחסום את הפעולה. { enabled: false } אומר שאין מגבלות.maxPerTxUsd נכשל במצב סגור: אם אין שער דולרי זמין לנכס, הפעולה נדחית.IW_READ_ONLY=true.