在Claude和其他AI助手中使用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。它也列在Smithery上。它在你自己的电脑上运行。

它能做什么

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

工具	作用
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。

安装服务器

服务器从它的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：

{
  "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。

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

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

相关文章

• 找到你的Bayarcash API key、PAT和portal key
• Bayarcash API文档和sandbox
• 在n8n中使用Bayarcash
• 你可以用Bayarcash接受的付款渠道