MCP 集成指南

UQPAY 开发者文档站支持模型上下文协议（MCP），这是一项开放标准，允许 AI 助手直接访问外部数据源。将你的 AI 编码工具接入 UQPAY MCP 服务后，无需离开开发环境即可搜索和读取文档内容。

使用 MCP 能做什么

接入之后，你的 AI 助手可以：

在所有 UQPAY 文档中搜索指南、API 参考和代码示例
获取任意文档页的完整内容
基于最新文档回答关于 UQPAY 产品、API 和集成模式的问题

前置条件

一款支持 MCP 的 AI 工具，例如：

你无需准备UQPAY账户或API凭证，因为此MCP服务只访问公开文档站。使用mcp-remote桥接的配置还需要Node.js 18或更高版本以及npx。

接入

UQPAY MCP 服务端点：

https://developers.uqpay.com/mcp

Claude Desktop
Claude Code
Cursor
Windsurf
VS Code (Copilot)

打开 Claude Desktop 配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

在 mcpServers 对象中加入以下内容：

{
  "mcpServers": {
    "uqpay-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://developers.uqpay.com/mcp"
      ]
    }
  }
}

重启 Claude Desktop 使配置生效。

在终端运行：

claude mcp add --transport http uqpay-docs https://developers.uqpay.com/mcp

打开 Cursor 设置，进入 MCP 区域，添加一个新的 MCP 服务：

Name：uqpay-docs
Type：command
Command：npx -y mcp-remote https://developers.uqpay.com/mcp

或者在项目的 .cursor/mcp.json 中加入：

{
  "mcpServers": {
    "uqpay-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://developers.uqpay.com/mcp"
      ]
    }
  }
}

打开 Windsurf 设置，进入 Cascade > MCP，添加一个新服务：

{
  "mcpServers": {
    "uqpay-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://developers.uqpay.com/mcp"
      ]
    }
  }
}

在项目的.vscode/mcp.json中加入：

{
  "servers": {
    "uqpay-docs": {
      "type": "http",
      "url": "https://developers.uqpay.com/mcp"
    }
  }
}

可用工具

MCP服务提供三个工具：

工具	说明
`search_uqpay_developer_docs`	在文档中搜索相关指南、API 参考和代码示例，返回带页面标题和直达链接的上下文片段。
`query_docs_filesystem_uqpay_developer_docs`	浏览并读取文档文件。当你需要完整页面或相关文件而不仅是搜索片段时使用。
`submit_feedback`	提交文档反馈。此操作会创建反馈记录，因此调用前应先征得用户同意。

典型只读流程：先用search找到目标页面，再用query_docs_filesystem读取完整内容。

示例提示词

接入成功后，可以在AI助手中试试这些提示词：

提示词	作用
”如何用 UQPAY Global Account API 创建一笔出款？“	搜索出款指南并返回分步说明
”展示卡交易事件的 webhook 通知体。“	查找并读取卡交易 webhook 文档
”创建虚拟卡需要哪些参数？“	查找建卡 API 参考
”列出所有支持跨币种出款的币种。“	读取支持币种对参考
”如何为支付开启 3DS 验证？“	查找 3DS 集成指南

llms.txt

如果你的AI工具不支持MCP，可以使用llms.txt索引将UQPAY文档作为上下文提供给模型。索引地址：

https://developers.uqpay.com/llms.txt

该文件遵循 llms.txt 标准，列出所有可用文档页面及其描述。你可以将它直接交给任何基于 LLM 的工具，帮助它发现并读取 UQPAY 文档。

排障

无法连接 MCP 服务

如果配置使用mcp-remote，请确认本机已安装Node.js 18或更高版本，因为运行桥接需要npx。执行node --version检查版本。原生HTTP配置不需要此桥接。

AI 助手中看不到工具

添加 MCP 配置后，完全重启 AI 工具。有些工具只重新加载不够，需要整体退出再打开。

搜索没有结果

换不同关键词重新提问。搜索对具体词汇（比如产品名 Card Issuance、Global Account，功能名 payout、webhook，或 API 操作名）效果最好。

MCP

CLI

SDKs

使用 MCP 能做什么

前置条件

接入

可用工具

示例提示词

llms.txt

排障

​使用 MCP 能做什么

​前置条件

​接入

​可用工具

​示例提示词

​llms.txt

​排障

使用 MCP 能做什么

前置条件

接入

可用工具

示例提示词

llms.txt

排障