跳转到主要内容
Agent Platform 可以把 Clink 作为自己 Portal 背后的账户和支付数据源。平台后端先以自身身份认证，再为单个用户获取只读 token，通过 Clink REST API 展示该用户的数据。 Portal API 不提供任何写操作：不创建订单、不发起退款、不修改支付方式，也不修改购买授权。

​
工作方式

平台 client 与 Agent Platform MCP 登录 使用的是同一个预注册 client。Portal token 是独立的用户 token，只能用于 Portal 只读 API。

​
可以构建的内容

​
Token 类型

Portal 用户 token 不能调 /mcp，MCP token 也不能调 /agent/platform/**。平台 client token 只保存在服务端，不要发给平台浏览器或 Agent。

​
数据范围

Portal token 的 sub 是 Clink customer_id。Clink 只从这个经过验证的 token 解析用户；没有通过请求参数指定其他 customer_id 或邮箱的入口。 Portal 数据按用户隔离，而不是按 Agent 过滤：
  • 订单、退款和授权包含该用户下任意 Agent 创建的数据；
  • 响应不按 agent_client_id 或 agentInfo.clientId 过滤；
  • 用户不能读取其他用户的记录；单条记录不属于当前用户时返回 404；
  • 订单过滤使用有界扫描；达到扫描上限时订单列表返回 truncated。

​
前置条件

Clink 需要在目标环境预注册平台 client：
  • 平台 client_id 和 client_secret；
  • 首次用户授权使用的精确 OAuth redirect_uri；
  • 环境 MCP resource 和 MCP scopes；
  • Portal audience 和 portal:read scope。
平台必须先验证用户邮箱，再请求 token。平台 client 不能通过 Dynamic Client Registration 自行创建。

​
环境地址

​
API 列表

Portal token

用平台 client token 换取一个用户的只读 token。

只读接口

账户、支付方式、订单、退款和授权。