MCP 接入

只想在 Cursor / WorkBuddy 里说话估价？用 Skill 即可，不必配置 MCP。

本页面向已经在用 MCP 连接器的接入方。底层仍是开放 API（API Key 鉴权、按次计费），由托管的 Streamable HTTP 网关转发。

公网地址：

https://assetai.qiongyuantech.com/mcp

健康检查：GET https://assetai.qiongyuantech.com/mcp/health 应返回 {"ok":true,...}。

连接配置

每个调用方使用自己的开放平台 API Key（aai_ 开头），写在请求头。也可以先不配 Key，用 ensure_guest（随机账号密码注册）或 send_login_code + login_asset_ai + create_api_key 生成后再写入请求头。试用额度用尽后：send_login_code（purpose=BIND）→ bind_phone。

{
  "mcpServers": {
    "asset-ai": {
      "type": "streamableHttp",
      "url": "https://assetai.qiongyuantech.com/mcp",
      "timeout": 300000,
      "headers": {
        "X-Api-Key": "aai_你的密钥"
      }
    }
  }
}

也可用 Authorization: Bearer aai_...。Key 可用 MCP 工具创建，或在 开放平台 创建。

远程 OCR / 银行流水请传 fileBase64 + fileName，不要传调用方电脑上的路径。

工具

工具	说明	扣估值费
ensure_guest	随机账号密码注册（与网页同一通路；stdio 会写入本机）	否
send_login_code	发送短信验证码（LOGIN 登录 / BIND 绑手机）	否
bind_phone	试用账号绑定手机（须先 purpose=BIND 发码）	否
login_asset_ai	短信验证码登录（主路径）	否
login_asset_ai_password	账号密码登录（备用）	否
create_api_key	用登录 JWT 创建 aai_ Key	否
export_valuation_report	导出报告（默认完整版 PDF，scope=all）	否
valuate_property	房产估值（创建 + 轮询）	是
valuate_vehicle	车辆估值	是
valuate_land	土地估值	是
valuate_equipment	设备残值	是
valuate_bank_statement	银行流水	是
get_valuation	查询任务	否
ocr_material	材料 OCR	否
get_wallet	余额与免费额度	否
get_usage	用量统计	否
list_bills	钱包流水	否
list_recharge_orders	充值订单列表	否
create_recharge	创建微信支付订单（返回 qrContent）	否
get_payment_status	查询充值是否到账	否
ping_asset_ai	检查 Key（会请求钱包）	否

创建估值即扣费（默认 ¥1.50 / 次，每账户前 10 次免费），与 HTTP 开放 API 同一账户。详见 产品定价。

create_recharge 只下微信支付单，不能代用户付款，也不提供模拟入账。请把 qrContent 做成二维码扫码，再轮询 get_payment_status 直到 PAID。试用账号充值若返回 40201，先 bind_phone。

与 HTTP API 的关系

MCP 工具对应开放 API /api/open/v1/...。需要批处理、流式 SSE 或 Webhook 时，直接调 HTTP，见 轮询、流式、Webhook。

钱包 HTTP 接口见 产品定价（GET /api/open/v1/wallet 等）。网页控制台走的是登录态 /api/v1/open-platform/**，与 MCP / 开放 API 不是同一条路径。