سرور 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_…"
            }
        }
    }
}

عامل چگونه با آن کار می‌کند

1. نشانی را وصل کنید — کلید لازم نیست.
2. عامل create_account را صدا می‌زند: بدون کپچا و بدون ایمیل. کلیدی با همهٔ دسترسی‌ها می‌گیرد و نشست با آن ادامه می‌یابد.
3. دریافت پول: create_invoice ← پرداخت‌کننده pay_url را باز می‌کند ← get_invoice وضعیت paid را نشان می‌دهد. پرداخت‌ها به‌صورت USDT به موجودی واریز می‌شوند.
4. پرداخت: 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؛ پرداخت‌ها — ۵ در دقیقه و ۳۰ در ساعت برای هر کلید.
• چه چیزی را می‌توان و چه چیزی را نمی‌توان فروخت: قوانین

بدون 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