LavoLoopIntegration guide

REMOTE MCP / X402

让 ChatGPT 和其他 Agent 安全使用 LavoLoop

连接一个公开的远程 MCP,不需要安装 LavoLoop CLI,也不需要把 Agent Token 复制给客户端。首次连接会完成 LavoLoop 登录与 OAuth 授权;之后规则内的付款由 Agent 直接发起。

远程 MCP 地址https://mcp.lavoloop.com/mcp

适合哪些客户端

任何支持 Streamable HTTP 与 OAuth 的远程 MCP 客户端都可以接入,包括提供自定义远程 MCP 能力的 ChatGPT、Codex 和其他 Agent 产品。不同产品中的入口名称可能是 Connectors、MCP servers 或 Custom connectors。

连接流程

  1. 01
    在客户端添加自定义 MCP

    将上面的 URL 填入远程服务器地址。不要直接打开 OAuth 授权页,客户端会从 MCP 响应中自动发现授权信息。

  2. 02
    完成一次 LavoLoop 授权

    客户端打开浏览器后,使用邮箱验证码登录并确认授权。首次使用前,需已在 LavoLoop 控制台完成钱包创建与 delegated signing。

  3. 03
    用自然语言调用

    连接完成后,可以先询问余额和最近付款,再让 Agent 调用收费 API。每个外部客户端都会绑定一个独立的 LavoLoop Agent 与支付策略。

可以直接这样问

查看我的 LavoLoop 测试 USDC 余额。列出最近 10 笔 x402 付款。调用这个 x402 API,最多支付 0.20 USDC,并使用一个新的幂等键。

可用工具

get_balance只读

读取可用与预留的 Base Sepolia 测试 USDC。

list_payments只读

读取最多 50 条近期付款、审批状态、服务域名和结算引用。

paid_fetch会执行付款

在预算、域名规则和审批策略内请求 GET/POST x402 资源。

新连接的默认策略

每个 OAuth 客户端首次授权时会创建独立 Agent。当前测试网默认值如下,之后可以在控制台调整:

网络 / 资产
Base Sepolia / 测试 USDC
单笔上限
1 USDC
每日上限
5 USDC
每月上限
25 USDC
允许域名
默认允许公网 HTTPS x402 服务

SECURITY BOUNDARY

OAuth 不是钱包权限的替代品

外部客户端只获得限定作用域的短期 OAuth Token。CDP 登录凭据、钱包密钥和 delegated signing 凭据不会交给客户端。所有付款仍经过 LavoLoop 的域名规则、单笔上限、日/月预算、审批、幂等和审计检查。

如何确认连接正常

  1. 添加 MCP 后,客户端应自动打开 lavoloop.com 的授权页。
  2. 授权成功后,工具列表应出现 get_balance、list_payments 和 paid_fetch。
  3. 先调用 get_balance;它是只读工具,不会产生付款。
  4. 使用 paid_fetch 时先选择你信任的测试网 x402 API,并设置很小的 maxAmountUsdc。
  5. 在 LavoLoop 控制台核对 Agent、付款状态与审计记录。

常见问题

直接访问 MCP URL 返回 401

这是正常的,表示端点要求 OAuth。应让 MCP 客户端发起连接,而不是把 URL 当普通网页打开。

授权页提示先完成钱包设置

先登录 LavoLoop 控制台,创建 Base Sepolia 钱包并完成 delegated signing,再重新连接。

付款进入 awaiting_approval

在控制台审批后,让 Agent 使用完全相同的参数和幂等键重试。

协议与客户端参考

OpenAI:MCP 与 ConnectorsOpenAI:自定义远程 MCP 的认证