云端 Agent 平台接入

npm install @modelcontextprotocol/client@2

import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";

const token = process.env.CLINK_USER_ACCESS_TOKEN;
if (!token) throw new Error("Set CLINK_USER_ACCESS_TOKEN for the connected user.");

const client = new Client({ name: "clink-wallet-check", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL(process.env.CLINK_MCP_URL ?? "https://uat-api.clinkbill.com/mcp"),
  { authProvider: { token: async () => token } }
);

try {
  await client.connect(transport);
  const { tools } = await client.listTools();
  if (!tools.some(tool => tool.name === "get_account_state")) {
    throw new Error("get_account_state is unavailable; check the MCP environment.");
  }

  const result = await client.callTool({ name: "get_account_state", arguments: {} });
  if (result.isError) throw new Error("Wallet read failed; check the token and scopes.");
  const account = result.structuredContent;
  if (!account || !Array.isArray(account.paymentMethods)) {
    throw new Error("Unexpected wallet response.");
  }
  console.log({ connected: true, walletReadable: true, cardCount: account.paymentMethods.length });
} finally {
  try {
    await transport.terminateSession();
  } finally {
    await client.close();
  }
}

node check-wallet.mjs

checkout = { merchantUrl, merchantName, amount, currency, paymentInstrumentId? }

if resuming a saved setup operation:
  setup = callTool("get_operation", { operationId: setupOperationId, maxWaitSeconds: 15 })
  if setup.status != "SUCCEEDED":
    follow setup.next_action, or stop if the operation failed or expired
    return

issued = callTool("get_credential", checkout)
if issued.credential is absent:
  save checkout and issued.operation_id for recovery
  present issued.next_action to the user; do not open USER_DEVICE_ONLY links
  return

reportIds = {
  operationId: issued.operation_id,
  orderId: issued.resources.payment_order_id,
  paymentExecutionDetailId: issued.resources.payment_execution_detail_id
}
save reportIds before filling the merchant form
card = issued.credential.card, or decrypt issued.credential.key + payload
if decryption fails or the final total changes:
  callTool("confirm_result", { ...reportIds, outcome: "NOT_SUBMITTED" })
  stop before submission

fill the card fields, submit once, and inspect the merchant result
outcome = "SUCCEEDED" | "FAILED" | "UNKNOWN", based on what was observed
save the report arguments for retry
callTool("confirm_result", { ...reportIds, outcome })
if reporting fails: retry the saved report; do not submit payment again
if outcome is "UNKNOWN": reconcile the existing payment before report_deadline