# 在Claude和其他AI助手中使用Bayarcash（MCP）

> 安装Bayarcash MCP服务器，让Claude、Cursor和其他AI助手可以创建付款和读取你的交易。
>
> Source: https://docs.bayarcash.com/zh/bayarcash-mcp/

Bayarcash MCP服务器让AI助手可以操作你的Bayarcash账号。MCP（Model Context Protocol）是Claude、Cursor和其他AI App用来连接其他系统的标准。你只需用日常用语提出要求，例如“Create a payment for RM 100”，助手就会替你调用Bayarcash API v3。

这个服务器是开源的：GitHub上的[webimpianteam/bayarcash-mcp-server](https://github.com/webimpianteam/bayarcash-mcp-server)。它也列在[Smithery](https://smithery.ai/server/@webimpianteam/bayarcash-mcp-server)上。它在你自己的电脑上运行。

## 它能做什么

服务器为助手提供以下工具：

| 工具 | 作用 |
|---|---|
| `create_payment_intent` | 创建付款，并返回它的payment intent ID和付款链接。 |
| `get_payment_intent` | 按payment intent ID获取付款状态。 |
| `get_transaction` | 按交易ID获取一笔交易。 |
| `get_transaction_by_order` | 按订单号码获取一笔交易。 |
| `list_transactions` | 列出交易。筛选条件：状态、付款渠道、付款人电邮、订单号码和参考号码。 |
| `get_portals` | 列出你的portal。 |
| `get_payment_channels` | 列出付款渠道。 |
| `get_fpx_banks` | 列出FPX银行。 |

要创建付款，助手需要订单号码、金额、付款人电邮、付款人姓名、说明和portal key。如果你没有提供，它会问你，也可以列出你的portal让你选择。

## 开始之前

安装服务器前，你需要准备：

- 电脑上的Node.js，用来运行服务器。
- 支持MCP的AI App，例如Claude Desktop、Claude Code或Cursor。
- 你的Personal Access Token（PAT）和API Secret Key。见[找到你的API key](/zh/api-keys/)。

## 安装服务器

服务器从它的GitHub repository副本运行。安装步骤：

1. 克隆这个repository：`git clone https://github.com/webimpianteam/bayarcash-mcp-server.git`
2. 在新的`bayarcash-mcp-server`文件夹中，运行`npm install`。
3. 运行`npm run build`。这会生成`build/index.js`文件。
4. 记下`build/index.js`的完整路径。你的AI App需要用到它。

## 连接你的AI App

服务器从以下环境变量读取设置：

| 变量 | 输入什么 |
|---|---|
| `BAYARCASH_API_TOKEN` | 你的Personal Access Token（PAT）。必填。 |
| `BAYARCASH_API_SECRET_KEY` | 你的API Secret Key。必填。 |
| `BAYARCASH_SANDBOX` | sandbox用`true`，正式环境（production）用`false`。在你修改之前，它都是`true`。 |

使用Claude Desktop时，把服务器加入`claude_desktop_config.json`。使用第4步的完整路径，并填入你自己的key：

```json
{
  "mcpServers": {
    "bayarcash": {
      "command": "node",
      "args": ["/full/path/to/bayarcash-mcp-server/build/index.js"],
      "env": {
        "BAYARCASH_API_TOKEN": "your_token",
        "BAYARCASH_API_SECRET_KEY": "your_secret",
        "BAYARCASH_SANDBOX": "true"
      }
    }
  }
}
```

然后重新启动Claude Desktop。其他AI App在它们的MCP设置中使用相同的命令、路径和变量。使用Claude Code时，运行`claude mcp add bayarcash -e BAYARCASH_API_TOKEN=your_token -e BAYARCASH_API_SECRET_KEY=your_secret -e BAYARCASH_SANDBOX=true -- node /full/path/to/bayarcash-mcp-server/build/index.js`。

## 小贴士

- **从sandbox开始**。在你把`BAYARCASH_SANDBOX`设为`false`之前，服务器会一直使用sandbox。等测试付款成功后，才换成正式环境和正式key。
- **助手创建付款前，先检查每笔付款**。检查金额、付款人和portal。付款链接会发给真实的顾客。
- **不要把key放在共享的文件里**。设置文件里有你的token和secret key。不要把它提交（commit）到Git，也不要在聊天或截图中分享它。

## 常见问题

### 服务器停止运行，并显示“Error: BAYARCASH_API_TOKEN and BAYARCASH_API_SECRET_KEY environment variables are required”。

你的AI App没有把这两个key传给服务器。在App的MCP设置中，把BAYARCASH_API_TOKEN和BAYARCASH_API_SECRET_KEY加入这个服务器条目的env部分，然后重新启动App。

### 助手显示“Authentication failed. Check your API token and secret key.”

key和环境不匹配。在你把BAYARCASH_SANDBOX设为false之前，服务器会一直使用sandbox。sandbox用sandbox key，正式环境用正式key。见找到你的API key (/zh/api-keys/)。

### 助手用错误的付款渠道创建了付款。为什么？

服务器中的渠道列表，并不是每个渠道都和Bayarcash的渠道编号一致。把渠道留空，让你的顾客在Bayarcash页面自己选择；或在发送链接前，先在付款页面检查渠道。