AI / MCP 接入
金牛支付遵循 Model Context Protocol (MCP) 标准，让 AI Agent（如 Claude、GPT、通义千问） 直接调用支付工具。基于 JSON-RPC 2.0 协议，即插即用，无需额外 SDK。
什么是 MCP？MCP 是 Anthropic 发布的开放协议，让 AI 模型安全地调用外部工具。
金牛支付 MCP Server 提供 6 个支付工具，AI 可以直接帮你收款、查单、退款。
端点
| URL | https://pay.jnqj.net/mcp |
| 方法 | POST |
| 协议 | JSON-RPC 2.0 |
| Content-Type | application/json |
| 鉴权 | initialize / tools/list 无需鉴权；tools/call 需 HMAC-SHA256 签名（与 REST API 相同） |
三步接入
1
握手初始化
发送 initialize 请求，获取服务能力声明。
2
发现工具
调用 tools/list 获取所有可用支付工具及参数定义。
3
调用工具
携带 API 密钥签名，调用 tools/call 执行支付操作。
6 个支付工具
get_balance
查询钱包余额
无需参数
create_collection
创建收款订单
amount, merchant_id
query_order
查询订单状态
tx_no
get_order_lifecycle
查询订单生命周期
tx_no
refund_order
发起退款
tx_no, refund_type, reason
list_transactions
查询交易流水
page, per_page, type...
完整示例 · 创建收款
// 1. 握手
POST /mcp
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": {"name": "my-ai-agent", "version": "1.0"}
}
}
// 2. 列出工具
POST /mcp
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}
// 3. 调用工具（需签名认证）
POST /mcp
Headers: X-JNQJ-Key, X-JNQJ-Secret, X-JNQJ-Timestamp,
X-JNQJ-Nonce, X-JNQJ-Signature
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "create_collection",
"arguments": {
"amount": 29.90,
"merchant_id": 1,
"title": "AI 代收 - VIP月卡"
}
}
}
// 响应
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [{
"type": "text",
"text": "收款订单已创建\n订单号: T202607291200001234ABCD\n支付链接: https://pay.jnqj.net/pay/T202607291200001234ABCD"
}]
}
}
Claude Desktop 配置
在 Claude Desktop 的 claude_desktop_config.json 中添加：
{
"mcpServers": {
"jnqj-pay": {
"url": "https://pay.jnqj.net/mcp",
"headers": {
"X-JNQJ-Key": "jk_xxxxxxxxxxxxxxxx",
"X-JNQJ-Secret": "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
安全提示：
tools/call 需要完整的 HMAC-SHA256 签名认证。签名算法与 REST API 完全一致，详见「鉴权方式」章节。