面向 AI 智能体的 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

Webhook

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