> ## 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

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 的示例：

> [tab] Claude
>
> 要将 HaiPay MCP 服务器连接到 Claude Desktop，请按以下步骤操作：
>
> **1. 添加自定义连接器**
>
> 1. 打开 Claude Desktop，进入 **Settings**（设置）。
> 2. 导航到 [Connectors](https://claude.ai/settings/connectors) 页面。
> 3. 点击 **Add custom connector**（添加自定义连接器）。
> 4. 填写以下信息：
>    * **Name**：`HaiPay`
>    * **URL**：`https://doc.haipay.net/mcp`
> 5. 点击 **Add**（添加）。
>
> **2. 在聊天中使用 MCP**
>
> 1. 在 Claude 聊天界面，点击附件按钮（加号图标）。
> 2. 选择 HaiPay MCP 服务器。
> 3. 现在可以向 Claude 提问关于 HaiPay 的问题，Claude 将通过 MCP 搜索文档并回答。
>
> 查看 [Model Context Protocol 文档](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server)了解更多详情。

> [tab] Claude Code
>
> 要将 HaiPay MCP 服务器连接到 Claude Code，请在终端中运行以下命令：
>
> ```bash theme={null} theme={null}
> claude mcp add --transport http HaiPay https://doc.haipay.net/mcp
> ```
>
> 运行以下命令验证连接是否成功：
>
> ```bash theme={null} theme={null}
> claude mcp list
> ```
>
> HaiPay MCP 服务器应显示在可用服务器列表中。您还可以在 Claude Code 会话中输入 `/mcp` 查看实时连接状态。
>
> 查看 [Claude Code MCP 文档](https://docs.anthropic.com/en/docs/claude-code/mcp#installing-mcp-servers)了解更多详情。

> [tab] Codex
>
> 要将 HaiPay MCP 服务器连接到 Codex CLI，请编辑配置文件 `~/.codex/config.toml`，添加以下内容：
>
> ```toml theme={null} theme={null}
> [mcp_servers.HaiPay]
> url = "https://doc.haipay.net/mcp"
> ```
>
> 保存文件后，启动 Codex 会话并输入以下问题测试连接：
>
> ```text theme={null} theme={null}
> What tools do you have available?
> ```
>
> Codex 应将 HaiPay MCP 服务器列为可用工具。
>
> 查看 [Codex MCP 文档](https://developers.openai.com/codex/mcp)了解更多详情。

> [tab] Cursor
>
> [在 Cursor 中安装](cursor://anysphere.cursor-deeplink/mcp/install?name=HaiPay\&config=eyJuYW1lIjoiSGFpUGF5IiwidXJsIjoiaHR0cHM6Ly9kb2MuaGFpcGF5Lm5ldC9tY3AifQ%3D%3D)
>
> 要将 Haipay MCP 服务器连接到 Cursor，点击 **在 Cursor 中安装** 按钮。若需手动连接 MCP 服务器，请按以下步骤操作：
>
> **1. 打开 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` 文件。
>
> **2. 配置 Haipay MCP 服务器**
>
> 在 `mcp.json` 中添加：
>
> ```json theme={null} theme={null}
> {
>     "mcpServers": {
>         "Haipay": {
>             "url": "https://doc.haipay.net/mcp"
>         }
>     }
> }
> ```
>
> **3. 测试连接**
>
> 在 Cursor 的聊天中，输入 “What tools do you have available?”。Cursor 应显示 Haipay MCP 服务器为可用工具。
>
> 查看 Cursor 文档中的 [Installing MCP servers](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) 了解更多详情。

> [tab] Qoder
>
> [在 Qoder IDE 中安装](qoder://aicoding.aicoding-deeplink/mcp/add?name=HaiPay\&config=JTdCJTIydXJsJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZkb2MuaGFpcGF5Lm5ldCUyRm1jcCUyMiU3RA%3D%3D)
>
> 要将 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] VS Code
>
> [在 VS Code 中安装](vscode:mcp/install?%7B%22name%22%3A%22HaiPay%22%2C%22url%22%3A%22https%3A%2F%2Fdoc.haipay.net%2Fmcp%22%7D)
>
> 要将 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)了解更多详情。

## 相关主题

* [AI Skills 助力 HaiPay 集成](https://doc.haipay.net/docs/zh/V20260623/ai/haipay_skills.md)
* [HaiPay 集成步骤指南](https://doc.haipay.net/docs/zh/V20260623/guide/integration_guide.md)
* [HaiPay 商户指南](https://doc.haipay.net/docs/zh/V20260623/guide/README.md)


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