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

# 连接 HaiPay MCP

export const PreviewButton = ({children, href}) => {
  return <a href={href} className="text-sm font-medium text-white dark:!text-zinc-950 bg-zinc-900 hover:bg-zinc-700 dark:bg-zinc-100 hover:dark:bg-zinc-300 rounded-full px-3.5 py-1.5 not-prose">
        {children}
    </a>;
};

HaiPay MCP（Model Context Protocol） 是一项开放标准的 AI 工具集成协议，让 AI 助手能够直接访问 HaiPay 的支付知识库、API 文档和技术资料。
当您需要反复查阅文档才能完成集成时，连接 MCP 可让 AI 直接理解并应用 HaiPay 的支付能力，帮助您快速集成 HaiPay API。

## MCP 能帮您做什么

连接 HaiPay MCP 后，您可以向 AI 助手发出以下请求：

* **快速接入支付功能**
  示例：根据 HaiPay 文档，帮我实现一个巴西 PIX 代收接口，包含签名逻辑和回调处理。

* **查询 API 参数规范**
  示例：查看菲律宾代收接口的必填字段和签名规则，生成一份参数对照表。

* **排查对接问题**
  示例：订单状态一直是 PENDING，帮我查看回调通知的签名验证逻辑的描述。

* **生成对接代码**
  示例：根据 HaiPay 的代收代付流程，用 Java/PHP/Python 写一个完整的支付请求示例。

* **理解业务流程**
  示例：解释 HaiPay 的异步通知机制，商户需要如何响应才能确保订单状态同步。

## 开始使用

HaiPay MCP 会将以下内容实时传递给 AI 助手：

* API 文档
* 签名规则
* 错误码说明
* 支持的地区币种

这样可以让您的集成过程更加高效、准确。以下是一些连接到 HaiPay MCP 的示例：

<Tabs>
  <Tab title="Cursor">
    <PreviewButton href="cursor://anysphere.cursor-deeplink/mcp/install?name=HaiPay&config=eyJuYW1lIjoiSGFpUGF5IiwidXJsIjoiaHR0cHM6Ly9kb2MuaGFpcGF5Lm5ldC9tY3AifQ%3D%3D">在 Cursor 中安装</PreviewButton>

    要将 Haipay MCP 服务器连接到 Cursor，点击 **在 Cursor 中安装** 按钮。若需手动连接 MCP 服务器，请按以下步骤操作：

    <Steps>
      <Step title="打开 MCP 设置">
        1. 使用 <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows 上为 <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>) 打开命令面板。
        2. 搜索 “Open MCP settings”。
        3. 选择 **Add custom MCP**。这会打开 `mcp.json` 文件。
      </Step>

      <Step title="配置 Haipay MCP 服务器">
        在 `mcp.json` 中添加：

        ```json theme={null} theme={null}
        {
            "mcpServers": {
                "Haipay": {
                    "url": "https://doc.haipay.net/mcp"
                }
            }
        }
        ```
      </Step>

      <Step title="测试连接">
        在 Cursor 的聊天中，输入 “What tools do you have available?”。Cursor 应显示 Haipay MCP 服务器为可用工具。
      </Step>
    </Steps>

    查看 Cursor 文档中的 [Installing MCP servers](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) 了解更多详情。
  </Tab>

  <Tab title="Qoder">
    <PreviewButton href="qoder://aicoding.aicoding-deeplink/mcp/add?name=HaiPay&config=JTdCJTIydXJsJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZkb2MuaGFpcGF5Lm5ldCUyRm1jcCUyMiU3RA%3D%3D">在 Qoder IDE 中安装</PreviewButton>

    要将 Haipay MCP 服务器连接到 Qoder，在安装本地 Qoder IDE 后，在Qoder设置中将下方Json字段添加到您的ide中：

    ```json theme={null} theme={null}
    {
        "mcpServers": {
            "Haipay": {
                "url": "https://doc.haipay.net/mcp"
            }
        }
    }
    ```

    查看 [Qoder文档](https://docs.qoder.com/zh/user-guide/chat/model-context-protocol)了解更多详情。
  </Tab>

  <Tab title="VS Code">
    <PreviewButton href="vscode:mcp/install?%7B%22name%22%3A%22HaiPay%22%2C%22url%22%3A%22https%3A%2F%2Fdoc.haipay.net%2Fmcp%22%7D">在 VS Code 中安装</PreviewButton>

    要将 Haipay MCP 服务器连接到 VS Code，在安装本地 VS Code IDE 后，创建 `.vscode/mcp.json` 文件并添加：

    ```json theme={null} theme={null}
    {
        "servers": {
            "Haipay": {
                "type": "http",
                "url": "https://doc.haipay.net/mcp"
            }
        }
    }
    ```

    查看 [VS Code 文档](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)了解更多详情。
  </Tab>
</Tabs>

## 相关主题

* [AI Skills 助力 HaiPay 集成](/docs/zh/ai/haipay_skills)
* [HaiPay 集成步骤指南](/docs/zh/guide/integration_guide)
* [HaiPay 商户指南](/docs/zh/guide/README)