独立 Agent 快速接入

此路径适用于个人 Agent，例如运行在 Codex 中的 Agent，或 Host 支持远程 MCP 与 OAuth 的 Bot。面向多用户提供服务时，从 Agent 平台接入开始。

使用 Prompt 安装

在你希望配置的 Host 中，将下面的 Prompt 发给 Agent：

请在当前 Agent Host 中读取并安装 https://www.clinkbill.com/SKILL.md。
按照 Skill 完成 Clink MCP 注册与用户 OAuth 授权。
复用同环境的已有连接，保留其他配置。
完成后确认 Clink 工具可用，并报告：
当前 Host、Skill 安装状态、MCP 地址、OAuth 状态，以及是否需要重新加载。
仅完成接入，不发起支付。

官方 Clink Skill 是用于安装与连接配置的单文件 Skill，连接 Production 地址 https://api.clinkbill.com/mcp。沙盒接入使用 MCP 连接与 OAuth中的 UAT 地址；配置和测试全程保持所选环境一致。

完成连接

安装 Skill 并注册 MCP

Agent 使用当前 Host 的安装机制和 MCP 设置，连接名称为 clink，传输方式为 Streamable HTTP。Host 无法自行修改设置时，可能需要你手动添加连接。

授权钱包

在面向用户的授权流程中完成登录和同意。Host 必须确认 OAuth 成功；仅写入 MCP 配置不代表已经连接成功。

确认工具可见

Host 应展示 get_skill_manifest、get_account_state、get_credential 等工具。如果需要重新加载，重新加载一次后再检查连接。

手动配置时，使用 Host 支持的配置格式，填入以下连接信息：

配置项	值
连接名称	`clink`
传输方式	Streamable HTTP
Production MCP 地址	`https://api.clinkbill.com/mcp`
认证方式	由 Host 管理的用户 OAuth

连接配置不需要 API Key，也不需要粘贴 Bearer Token。Host 通过 OAuth 获取用户 Token。连接成功后，购买仍需有效授权。需要 Passkey 验证时，在自己的设备上打开 Agent 提供的链接完成确认，详见 Passkey 与购买授权。

读取当前业务规则

连接后，MCP 服务端会发布工具 schema 与业务规则。读取 clink://skill/rules 资源；Host 不支持读取 MCP 资源时，调用：

{
  "name": "get_skill_manifest",
  "arguments": {
    "include_rules": true
  }
}

这是 tools/call 的参数对象，不是独立 HTTP 接口。业务操作遵循返回的 rules；规则更新不要求重新安装连接 Skill。

检查钱包

可以向 Agent 发送：

查看我当前 Clink 钱包可用的支付卡，并告诉我哪张是默认卡。

Agent 使用 get_account_state 查询。卡列表为空时，MCP 连接仍可能已经正常，只是尚未添加支付卡。需要添加时，让 Agent 调用 start_payment_method_action 并传入 action: "add"，再在自己的设备上打开返回的设置链接完成操作。详见 Wallet Service。查询支付卡适合首次设置或选卡，不是每次 Browser Pay 购买的必经前置调用。

完成一次 Browser Pay 购买

选择商户网站上希望购买的商品，Agent 需要具备浏览器操作能力。将下面的商品 URL 占位符替换为实际地址，并调整数量和预算：

用 Browser Pay 和我的 Clink 卡购买以下链接中的商品，数量为 1：
https://shop.example.com/products/item
含运费和税费的最终总额不要超过 25 美元。
如果超出这个金额，先问我再继续。
结账需要的地址或联系方式不齐全时，先向我询问。
支付后告诉我商户名称、实际付款金额和币种，
以及商户页面显示的订单号（如有）。

读取最终结账总额

Agent 操作到商户卡表单，读取含运费和税费的最终总额，再申请支付凭证。预算是你批准的上限，不是实际扣款金额。

完成需要的用户授权

需要绑卡或购买授权时，Agent 会给你一个 Clink 操作链接。在自己的设备上打开，完成页面要求的步骤，包括需要时的 Passkey 验证，然后回到同一段对话。Agent 查询 Clink 的状态后再继续；已有授权覆盖本次购买时，可能无需这一步。

查看购买结果

Agent 填写卡字段、提交支付、读取商户结果，并向 Clink 上报。确认商户付款成功后，应向你展示商户名称、实际付款金额和币种，以及商户页面显示的订单号（如有）。

成功购买后的结果摘要应类似下面这样，各项取自实际商户页面：

商户：<商户名称>
结果：商户已确认付款成功
实付：<实际金额> <币种>
商户订单号：<页面显示的订单号；未显示时注明“未显示”>

商户订单号来自商户，不能用 Clink 支付 orderId 替代。如果无法确认支付结果，Agent 应明确说明结果未知，并继续核对同一次购买，不能再次付款。支付步骤与恢复方式见 Browser Pay。

收到加密凭证时

默认独立 Agent 路径直接返回可用卡字段。如果当前连接返回 key 和 payload，则先按加密凭证接入说明处理，再填写商户表单。

处理接入问题

现象	下一步
Skill 已安装，但看不到 Clink 工具	检查 MCP 注册和 Host 的重新加载要求。仅安装文件不会连接 MCP。
OAuth 等待中或失败	完成当前授权流程；失败后使用 Host 的重新连接操作。
工具提示权限不足	让 Host 申请所需 OAuth Scope；Host 无法处理时，按 OAuth 指南中的 Scope 重新连接。
没有可用卡或购买授权	按钱包或支付工具返回的下一步操作处理。重新安装 Skill 不会完成绑卡。
Skill 版本过旧	重新读取官方 Skill 并更新当前 Host 的安装，保留所选环境和已有连接。

开始使用

接入

Agent 解决方案

配置与上线

介绍

财务信息

使用 Prompt 安装

完成连接

读取当前业务规则

检查钱包

完成一次 Browser Pay 购买

处理接入问题

​使用 Prompt 安装

​完成连接

​读取当前业务规则

​检查钱包

​完成一次 Browser Pay 购买

​处理接入问题

使用 Prompt 安装

完成连接

读取当前业务规则

检查钱包

完成一次 Browser Pay 购买

处理接入问题