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

# 通过 MCP 连接 AI 工具

> 查看 HaiPay 文档 MCP 的连接方式，以及在 Claude、Codex、Cursor、Qoder 和 VS Code 中的配置步骤。

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

**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)了解更多详情。

**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)了解更多详情。

**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)了解更多详情。

**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) 了解更多详情。

**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)了解更多详情。

**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/agent-customization/mcp-servers)了解更多详情。

## 相关主题

* [AI Skills 助力 HaiPay 集成](https://doc.haipay.net/zh/history/V20260801/resources/ai/haipay-skills.md)
* [HaiPay 集成步骤指南](https://doc.haipay.net/zh/history/V20260801/get-started/integration-steps.md)
* [HaiPay 商户指南](https://doc.haipay.net/zh/history/V20260801/overview.md)


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