How to set up MetaMask Agent Wallet and make your first trade

MetaMask Agent Wallet kurulumu üç adımda tamamlanır: mm CLI'yi yükleyin, AI ajanınıza beceriler ekleyin ve tek bir komut yapıştırın. Ajanınız sizi oturum açma ve güvenlik ayarlarını seçme konusunda yönlendirir. Cüzdanı fonladıktan sonra, düz dil kullanarak token takas taleplerini gerçekleştirebilir. Perps ve tahmin piyasaları kendi kılavuzlarında ele alınan ayrı bir fonlama adımı içerir. Bu kılavuz, kurulumdan ilk işleme kadar resmi hızlı başlangıç rehberini takip eder.

Bu bir kurulum kılavuzudur, açıklayıcı bir rehber değildir. Agentic cüzdanın ne olduğunu öğrenmek için agentic cüzdan nedir sayfasına bakın. İşlem yaşam döngüsü ve güvenlik sürecinin nasıl çalıştığını öğrenmek için agentic cüzdanlar nasıl çalışır ve agentic cüzdan güvenliği sayfalarına bakın.

Başlamadan önce

İhtiyacınız olanlar:

• Node.js 22.18 veya üzeri. node --version komutuyla kontrol edin.

• Claude Code, Codex, Cursor, OpenClaw veya Hermes Agent gibi becerileri destekleyen bir AI ajanı. (Beceri yok mu? 3. adım yalnızca terminal üzerinden çalışan bir yolu kapsar.)

• Başka bir cüzdandan veya bir borsadan gönderebileceğiniz fonlar.

Adım 1: CLI'yi yükleyin

mm CLI, ajanınızın oturum açmasını, bakiyeleri kontrol etmesini ve işlem göndermesini sağlar.

npm install -g @metamask/agent-wallet@latest

Yarn, pnpm ve Bun da çalışır (yarn global add, pnpm add -g veya bun add --global, aynı paket ile). CLI sürümünü ve beceri uyumluluğunu doğrulamak için ardından mm doctor komutunu çalıştırın. 2. adıma kadar eksik becerilerle ilgili ipuçları görmeniz normaldir.

Adım 2: Ajanınıza beceriler ekleyin

Beceriler, ajanınıza hangi mm komutlarını çalıştıracağını ve fon taşımadan önce ne zaman onayınızı istemesi gerektiğini öğretir.

npx skills add MetaMask/agent-skills

Adım 3: Tek bir komutla kurulumu başlatın

Ajanınızı açın ve şunu yapıştırın:

Set up MetaMask Agent Wallet: help me pick a sign-in method, wallet mode, and trading mode, then show my address.

Ajanınız hangi oturum açma yöntemini istediğinizi sorar, ardından kurulum komutlarını çalıştırır. Sonraki iki adım, sizden yapmanızı istediği seçimleri kapsar.

Terminali mi tercih ediyorsunuz ya da beceriler olmadan bir ajan mı çalıştırıyorsunuz? Sırasıyla mm doctor, mm login, mm init ve ardından tekrar mm doctor komutlarını çalıştırın. CLI kurulum kılavuzu her komutu ayrıntılı olarak ele alır.

Adım 4: Tek bir yöntemle oturum açın ve buna sadık kalın

Google, e-posta ve MetaMask Mobile QR, e-posta ve Google girişi için aynı adresi kullansanız bile farklı sunucu cüzdan adresleri yükler (Mobile QR seçtiğinizde e-posta adresi kullanılmaz). Bir yöntem seçin, her seferinde aynı yöntemi kullanın ve fonladığınız adresi doğrulamak için her oturum açışından sonra mm wallet address komutunu çalıştırın.

Google veya e-posta için ajanınız, tarayıcınızda Agent Wallet panosunu açar. Oturum açın, Authorize (Yetkilendir) düğmesine tıklayın, ardından istenirse CLI token'ını tarayıcıdan kopyalayıp terminalinize yapıştırın. E-posta ile oturum açma, gelen kutunuzdan bir doğrulama kodu ekler: Authorize düğmesine tıklamadan önce bu kodu tarayıcıya girin. Bu kod CLI token'ı değildir; terminale yapıştırmayın.

MetaMask Mobile QR için ajanınız terminalde bir QR kodu gösterir. MetaMask Mobile'ı açın, kodu tarayın ve uygulamada bağlantıyı onaylayın.

Adım 5: Cüzdan modunuzu ve işlem modunuzu seçin

Ajanınız fonları nasıl tutması gerektiğini sorar:

Kendi cüzdanınızı getiriyorsanız, ifadeyi komut satırına yazmak yerine MM_MNEMONIC ortam değişkenini ayarlayın:

export MM_MNEMONIC = ""

Sunucu cüzdanıyla ajanınız ayrıca bir işlem modu sorar:

Guard Mode, çoğu kullanıcı için önerilen seçimdir. Modları daha sonra mm wallet trading-mode set guard veya mm wallet trading-mode set beast komutlarıyla değiştirebilirsiniz. Tüm güvenlik önlemlerinin karşılaştırması için işlem modları sayfasına bakın.

Adım 6: Cüzdanınızı fonlayın

Kurulum tamamlandığında ajanınız cüzdan adresinizi gösterir. Beklediğinizle eşleştiğini doğrulayın, ardından başka bir cüzdandan veya bir borsadan fon gönderin. Ajanınıza istediğiniz zaman sorabilirsiniz:

Show my wallet address and balance.

Göndermeden önce bilmeniz gereken iki şey:

• Bakiyeler zincir bazındadır. İşlem yapmayı planladığınız zinciri fonlayın. Desteklenen ağları ve her birinin hangi özellikleri (swap, predict, perps) desteklediğini görmek için mm chains list komutunu çalıştırın.

• Zincirin kapsamını kontrol edin. Desteklenen zincirler listesindeki Transaction Shield sütununda "No" olarak işaretlenen zincirlerde tehdit taraması kullanılamaz. Ethereum, Base, Arbitrum, Optimism ve Polygon kapsanan zincirler arasındadır.

İlk işleminizden önce mm doctor komutunu çalıştırın ve hem authenticated hem de initialized değerlerinin true gösterdiğini doğrulayın. Herhangi biri false ise çıktıdaki ipuçlarını takip edin ve komutu tekrar çalıştırın.

Adım 7: İlk işleminizi yapın

Ajanınızdan küçük bir takas isteyin:

Swap 0.01 ETH to USDC on Base.

Ajanınız bir fiyat teklifi alır, rotayı ve çıktıyı gösterir, ardından onaylamanızın ardından işlemi gerçekleştirir. Önce daha düşük riskli bir ısınma yapmak istiyorsanız "What's my USDC balance?" veya "What's the current price of ETH?" diye sorabilirsiniz. Salt okunur istekler onay istemi olmadan çalışır.

Guard Mode, başlangıçta iki noktada sizden giriş ister. İlk işleminizde 24 saatlik kayan çıkış limitinizi belirlemeniz istenir; izin listelerinizin veya bu limitin dışındaki her şey iki faktörlü onay için duraklatılır. Ajanınız, işaretlenmiş bir işlemde siz yanıt verene kadar devam edemez. Onaylar; Google veya e-posta ile oturum açtıysanız e-posta bağlantısı olarak, QR kullandıysanız MetaMask Mobile'da anlık bildirim olarak gelir (bildirim gelmezse bildirimler menüsünü kontrol edin).

Kurulum takılırsa

mm doctor ile başlayın. Oturum açıp açmadığınızı ve başlatılıp başlatılmadığınızı raporlar; ipuçları neyi düzeltmeniz gerektiğini söyler. Yaygın hata kodları için:

Sorun giderme sayfası daha fazla durumu kapsar.

Sırada ne var

İlk işleminiz tamamlandıktan sonra bir varlık sınıfı seçin. Hyperliquid'de kaldıraçlı pozisyonlar için MetaMask Agent Wallet ile perps nasıl işlem yapılır sayfasına bakın. Aynı zincir takasları ve zincirler arası köprüler için token nasıl takas edilir ve köprülenir sayfasına bakın. Polymarket için tahmin piyasalarında nasıl işlem yapılır sayfasına bakın. Belgeler ayrıca yield vault'ları ve x402 ödemelerini de kapsar.