خادم MCP لوكلاء الذكاء الاصطناعي

الاتصال

عنوان الخادم (Streamable HTTP):

https://pay.snapex.pro/mcp

لا حاجة إلى مفتاح للبدء: يستدعي الوكيل create_account ويتابع بمفتاحه الجديد في الجلسة نفسها. إعدادات العملاء الشائعين:

Claude Code

claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp

Cursor — ~/.cursor/mcp.json

{
    "mcpServers": {
        "snapex-pay": {
            "url": "https://pay.snapex.pro/mcp"
        }
    }
}

VS Code — .vscode/mcp.json

{
    "servers": {
        "snapex-pay": {
            "type": "http",
            "url": "https://pay.snapex.pro/mcp"
        }
    }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
    "mcpServers": {
        "snapex-pay": {
            "serverUrl": "https://pay.snapex.pro/mcp"
        }
    }
}

Claude Desktop — claude_desktop_config.json

{
    "mcpServers": {
        "snapex-pay": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://pay.snapex.pro/mcp"
            ]
        }
    }
}

موصّلات claude.ai وChatGPT

أضف موصّلًا مخصصًا بعنوان الخادم. هذه العملاء لا ترسل ترويسات، لذا بعد create_account خذ mcp_personal_url من الرد واستخدمه عنوانًا للموصّل — فتعمل كل محادثة جديدة بالحساب نفسه. احفظ هذا العنوان ككلمة مرور.

إذا كان لديك مفتاح

أضف الترويسة Authorization: Bearer smk_… — مفتاح التاجر من لوحة التحكم (التاجر → للمطورين) أو من رد create_account.

{
    "mcpServers": {
        "snapex-pay": {
            "url": "https://pay.snapex.pro/mcp",
            "headers": {
                "Authorization": "Bearer smk_…"
            }
        }
    }
}

كيف يعمل الوكيل معه

اربط العنوان — لا حاجة إلى مفتاح.
يستدعي الوكيل create_account: دون كابتشا ودون بريد. يحصل على مفتاح بكل الصلاحيات وتستمر الجلسة به.
لاستلام المال: create_invoice ← يفتح الدافع pay_url ← يُظهر get_invoice الحالة paid. تُضاف المدفوعات إلى الرصيد بعملة USDT.
للإرسال: يعرض preview_payout المبلغ والرسوم، ويرسل create_payout — بأي عملة من list_assets.

الأدوات

الأدوات نفسها في الخادم البعيد وفي الحزمة المحلية. كل رد بصيغة JSON، والخطأ يوضّح الخطوة التالية.

الحساب

create_account, get_account

العملات والأسعار والرسوم (دون مفتاح)

list_assets, get_fiat_rates, get_fees, list_static_address_networks

الرصيد والسجل

get_balances, list_transactions

الاستلام: الفواتير والمدفوعات والعناوين الدائمة

create_invoice, get_invoice, list_invoices, get_invoice_payment_methods, select_invoice_payment_method, preview_payment, create_payment, get_payment, list_payments, create_static_address, list_static_addresses, list_static_address_deposits

الإرسال: المدفوعات الصادرة

preview_payout, create_payout, get_payout, list_payouts

التحويل

preview_conversion, create_conversion, get_conversion, list_conversions

خطافات الويب

list_webhooks, create_webhook, update_webhook, rotate_webhook_secret

الأمان

يُعرض المفتاح وكلمة المرور المولّدة مرة واحدة فقط، في رد create_account. باسم المستخدم وكلمة المرور يستطيع شخص الدخول إلى لوحة التحكم.
لا يحرّك الوكيل إلا أموال حسابه. يبدأ الحساب الجديد من الصفر؛ وتأتي الأموال من مدفوعات فواتيره وعناوينه.
الإرسال خطوتان: يعرض preview_payout المبلغ والرسوم، ويرسل create_payout بمفتاح idempotency_key الخاص بالوكيل — إعادة المحاولة لا تدفع مرتين أبدًا.
وضع الاختبار: فاتورة environment test تمر بالمسار كاملًا دون أموال حقيقية.
الحدود: بضعة حسابات جديدة في الساعة لكل عنوان IP؛ المدفوعات الصادرة — 5 في الدقيقة و30 في الساعة لكل مفتاح.
ما يجوز بيعه وما لا يجوز: القواعد

دون MCP

الشيء نفسه يعمل عبر REST API: الحساب بطلب واحد، ثم Merchant API بالمفتاح.

curl -X POST https://pay.snapex.pro/api/v1/merchant/signup -H 'Content-Type: application/json' -d '{"agent":"my-agent"}'

توثيق API · llms.txt · mcp.json