> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clinkbill.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 独立 Agent 快速接入

> 在 Agent Host 中安装 Clink Skill、连接 MCP 并完成钱包授权。

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

## 使用 Prompt 安装

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

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

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

## 完成连接

<Steps>
  <Step title="安装 Skill 并注册 MCP">
    Agent 使用当前 Host 的安装机制和 MCP 设置，连接名称为 `clink`，传输方式为 Streamable HTTP。Host 无法自行修改设置时，可能需要你手动添加连接。
  </Step>

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

  <Step title="确认工具可见">
    Host 应展示 `get_skill_manifest`、`get_account_state`、`get_credential` 等工具。如果需要重新加载，重新加载一次后再检查连接。
  </Step>
</Steps>

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

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

连接配置不需要 API Key，也不需要粘贴 Bearer Token。Host 通过 OAuth 获取用户 Token。

连接成功后，购买仍需有效授权。需要 Passkey 验证时，在自己的设备上打开 Agent 提供的链接完成确认，详见 [Passkey 与购买授权](/cn/guides/agent/wallet_service#passkey-与购买授权)。

## 读取当前业务规则

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

```json theme={null}
{
  "name": "get_skill_manifest",
  "arguments": {
    "include_rules": true
  }
}
```

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

## 检查钱包

可以向 Agent 发送：

```text theme={null}
查看我当前 Clink 钱包可用的支付卡，并告诉我哪张是默认卡。
```

Agent 使用 `get_account_state` 查询。卡列表为空时，MCP 连接仍可能已经正常，只是尚未添加支付卡。需要添加时，让 Agent 调用 `start_payment_method_action` 并传入 `action: "add"`，再在自己的设备上打开返回的设置链接完成操作。详见 [Wallet Service](/cn/guides/agent/wallet_service)。

查询支付卡适合首次设置或选卡，不是每次 Browser Pay 购买的必经前置调用。

## 完成一次 Browser Pay 购买

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

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

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

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

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

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

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

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

<Accordion title="收到加密凭证时">
  默认独立 Agent 路径直接返回可用卡字段。如果当前连接返回 `key` 和 `payload`，则先按[加密凭证接入说明](/cn/guides/agent/browser_pay/decryption)处理，再填写商户表单。
</Accordion>

## 处理接入问题

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.