The @blockchain0x/mcp sunucusu, bir MCP ana bilgisayarına beş ajan-cüzdan aracı verir: bir cüzdanı oku, cüzdanları listele, bir işlemi kontrol et, bir USDC ödemesi gönder ve bir x402 faturasını kesin. Bunu npx @blockchain0x/mcp ile çalıştırın (anahtarınız makinenizde kalır) veya barındırılan URL'ye işaret edin. Ayrı olarak, paket requirePayment'i dışa aktarır, böylece kendi MCP araçlarınıza bir x402 402 zorluğu ile bir fiyat koyabilirsiniz.

İkisini çalıştırmanın iki yolu. Barındırılan için kurulum yok.

Bunu yerel olarak stdio üzerinden npx ile çalıştırın (anahtarınız makinenizde kalır), veya herhangi bir MCP sunucusunu barındırılan Streamable HTTP URL'sine yönlendirin ve anahtarı Bearer token olarak geçirin. Her ikisi de sunucunun MCP yapılandırmasına doğrudan düşer. Yerel yol için Node 20+.

{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["-y", "@blockchain0x/mcp"],
      "env": {
        "BLOCKCHAIN0X_API_KEY": "sk_live_...",
        "BLOCKCHAIN0X_API_BASE_URL": "https://api.blockchain0x.com"
      }
    }
  }
}

{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

BLOCKCHAIN0X_API_KEY, kontrol panelinizden alınan bir sk_test_ testnet veya sk_live_ mainnet anahtarıdır; BLOCKCHAIN0X_API_BASE_URL varsayılan olarak https://api.blockchain0x.com'dur. Sunucu anahtarınızı arka uca iletir ve hiçbir şey saklamaz, bu nedenle bu anahtar üzerindeki kapsam ve limitler tam olarak ajanın yapabileceği şeylerdir. Beş aracı şunlardır: get_wallet, list_wallets, get_transaction, send_payment ve settle_payment_request.

Webhook geldiğinde çağrıyı ödenmiş olarak işaretleyin.

Bir ödeme yerleştiğinde, Blockchain0x imzalı bir payment.received olayını webhook URL'nize POST eder. Bunu Node SDK'dan webhooks.verify ile doğrulayın, ardından arayanın ödeme yaptığını zaten çalıştığınız herhangi bir mağazada kaydedin. Yapılandırılacak gönderilmiş bir makbuz önbelleği yoktur - o kısmın sahibi sizsiniz, bu da sürpriz bir altyapı olmadığı anlamına gelir.

import express from "express";
import { webhooks } from "@blockchain0x/node";

const app = express();
// Capture the RAW body. The HMAC is over the exact bytes on the wire.
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/payment", (req, res) => {
  const result = webhooks.verify({
    headers: req.headers,
    rawBody: req.body, // Buffer, raw bytes
    secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
  });
  if (!result.ok) return res.status(400).json({ code: result.code });

  if (result.eventType === "payment.received") {
    // Mark this payer paid however you like - a DB row, a Redis key, your call.
    markPaid(result.eventId);
  }
  res.status(200).send("ok");
});

webhooks.verify, sabit zamanda HMAC-SHA256 yapar ve ayrıştırılmış bir birleşim döndürür, bu nedenle result.ok üzerinde try/catch olmadan dallanırsınız. Ham gövdeyi okuyun, ayrıştırılmış bir kopyayı değil, çünkü imza tam baytları kapsar. Gönderilen olaylar payment.received, payment.sent, wallet.deployed ve webhook.test'tir; cüzdanınıza yapılan bir ödeme payment.received'dır. 'Bu çağrıcı ödedi' ifadesini nerede saklayacağınız - bir veritabanı satırı, bir Redis anahtarı, tek bir işlem için bir bellek içi harita - sizin çağrınızdır.

Beş MCP'ye özgü kaçınılması gereken tuzak.

Bunlar, üretimde ücretli MCP sunucuları çalıştıran operatörlerden gelmektedir. Çoğu, önbellek mimarisi ve MCP protokolünün belirli hata formatıyla ilgilidir.