1. 使用 Prompt 安装
在你希望配置的 Host 中,将下面的 Prompt 发给 Agent:https://api.clinkbill.com/mcp。沙盒接入使用如何对接 MCP中的 UAT 地址;配置和测试全程保持所选环境一致。
2. 完成连接
1
安装 Skill 并注册 MCP
Agent 使用当前 Host 的安装机制和 MCP 设置,连接名称为
clink,传输方式为 Streamable HTTP。Host 无法自行修改设置时,可能需要你手动添加连接。2
授权钱包
在面向用户的授权流程中完成登录和同意。Host 必须确认 OAuth 成功;仅写入 MCP 配置不代表已经连接成功。
3
确认工具可见
Host 应展示
get_skill_manifest、get_account_state、get_credential 等工具。如果需要重新加载,重新加载一次后再检查连接。
连接配置不需要 API Key,也不需要粘贴 Bearer Token。Host 通过 OAuth 获取用户 Token。
连接成功后,购买仍需有效授权。需要 Passkey 验证时,在自己的设备上打开 Agent 提供的链接完成确认,详见 Passkey 与购买授权。
3. 读取当前业务规则
连接后,MCP 服务端会发布工具 schema 与业务规则。读取clink://skill/rules 资源;Host 不支持读取 MCP 资源时,调用:
tools/call 的参数对象,不是独立 HTTP 接口。业务操作遵循返回的 rules;规则更新不要求重新安装连接 Skill。
4. 检查钱包
可以向 Agent 发送:get_account_state 查询。卡列表为空时,MCP 连接仍可能已经正常,只是尚未添加支付卡。需要添加时,让 Agent 调用 start_payment_method_action 并传入 action: "add",再在自己的设备上打开返回的设置链接完成操作。详见 Wallet Service。
查询支付卡适合首次设置或选卡,不是每次 Browser Pay 购买的必经前置调用。
5. 完成一次 Browser Pay 购买
选择商户网站上希望购买的商品,Agent 需要具备浏览器操作能力。将下面的商品 URL 占位符替换为实际地址,并调整数量和预算:1
读取最终结账总额
Agent 操作到商户卡表单,读取含运费和税费的最终总额,再申请支付凭证。预算是你批准的上限,不是实际扣款金额。
2
完成需要的用户授权
需要绑卡或购买授权时,Agent 会给你一个 Clink 操作链接。在自己的设备上打开,完成页面要求的步骤,包括需要时的 Passkey 验证,然后回到同一段对话。Agent 查询 Clink 的状态后再继续;已有授权覆盖本次购买时,可能无需这一步。
3
查看购买结果
Agent 填写卡字段、提交支付、读取商户结果,并向 Clink 上报。确认商户付款成功后,应向你展示商户名称、实际付款金额和币种,以及商户页面显示的订单号(如有)。
orderId 替代。如果无法确认支付结果,Agent 应明确说明结果未知,并继续核对同一次购买,不能再次付款。支付步骤与恢复方式见 Browser Pay。
收到加密凭证时
收到加密凭证时
默认本地 Agent 路径直接返回可用卡字段。如果当前连接返回
key 和 payload,则先按加密凭证接入说明处理,再填写商户表单。常见问题
Skill 已经安装了,为什么看不到 Clink 工具?
Skill 已经安装了,为什么看不到 Clink 工具?
只安装 Skill 文件不会连接 MCP。检查 Host 中是否已注册名为
clink 的 MCP 连接,以及 Host 是否需要重新加载;重新加载一次后再检查工具列表。OAuth 授权一直在等待或失败怎么办?
OAuth 授权一直在等待或失败怎么办?
先完成当前的授权流程。授权失败后,使用 Host 提供的重新连接操作重新发起授权。
工具提示权限不足怎么办?
工具提示权限不足怎么办?
让 Host 申请平台已配置的 OAuth Scope。Host 无法自动处理时,联系 Clink 确认平台的 Scope 配置后重新连接。
没有可用的卡或购买授权怎么办?
没有可用的卡或购买授权怎么办?
按钱包或支付工具返回的下一步操作处理,例如打开 Agent 提供的绑卡或授权链接。重新安装 Skill 不会完成绑卡。
Skill 版本过旧怎么更新?
Skill 版本过旧怎么更新?
重新读取官方 Skill,并更新当前 Host 中的安装,保留所选环境和已有连接。