Guna Bayarcash dengan Claude & AI assistant lain (MCP)

Dikemas kini 21 Oktober 2026

Dengan MCP server Bayarcash, AI assistant boleh berhubung dengan akaun Bayarcash anda. MCP (Model Context Protocol) ialah standard yang Claude, Cursor dan app AI lain gunakan untuk berhubung dengan sistem lain. Anda hanya minta dalam bahasa biasa, contohnya “Create a payment for RM 100”, dan assistant itu menggunakan Bayarcash API v3 untuk anda.

Server ini open source: webimpianteam/bayarcash-mcp-server di GitHub. Server ini juga tersenarai di Smithery. Server ini berjalan pada komputer anda sendiri.

Fungsi server ini

Server ini memberi assistant tool berikut:

Tool	Fungsinya
`create_payment_intent`	Mencipta bayaran dan memulangkan ID payment intent dan payment link bayaran itu.
`get_payment_intent`	Mendapatkan status bayaran mengikut ID payment intent.
`get_transaction`	Mendapatkan satu transaksi mengikut ID transaksi.
`get_transaction_by_order`	Mendapatkan satu transaksi mengikut nombor pesanan.
`list_transactions`	Menyenaraikan transaksi. Filter: status, saluran bayaran, e-mel pembayar, nombor pesanan dan nombor rujukan.
`get_portals`	Menyenaraikan portal anda.
`get_payment_channels`	Menyenaraikan saluran bayaran.
`get_fpx_banks`	Menyenaraikan bank FPX.

Untuk mencipta bayaran, assistant memerlukan nombor pesanan, amaun, e-mel pembayar, nama pembayar, keterangan dan portal key. Jika anda tidak memberikannya, assistant akan bertanya. Assistant juga boleh memaparkan portal anda supaya anda boleh pilih satu.

Sebelum anda mula

Sediakan perkara ini sebelum anda install server itu:

Node.js pada komputer anda, untuk menjalankan server itu.
App AI yang menyokong MCP, contohnya Claude Desktop, Claude Code atau Cursor.
Personal Access Token (PAT) dan API Secret Key anda. Lihat Cari API keys anda.

Install server

Server ini berjalan dari salinan repository GitHub-nya. Untuk install server ini:

Clone repository itu: git clone https://github.com/webimpianteam/bayarcash-mcp-server.git
Dalam folder baru bayarcash-mcp-server, jalankan npm install.
Jalankan npm run build. Langkah ini membuat fail build/index.js.
Catat path penuh ke build/index.js. App AI anda memerlukannya.

Sambungkan app AI anda

Server ini membaca tetapannya dari environment variable ini:

Variable	Apa yang perlu dimasukkan
`BAYARCASH_API_TOKEN`	Personal Access Token (PAT) anda. Wajib.
`BAYARCASH_API_SECRET_KEY`	API Secret Key anda. Wajib.
`BAYARCASH_SANDBOX`	`true` untuk sandbox, `false` untuk production. Nilainya `true` sehingga anda menukarnya.

Untuk Claude Desktop, tambah server ini dalam claude_desktop_config.json. Guna path penuh dari langkah 4, dan masukkan keys anda sendiri:

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

Kemudian mulakan semula Claude Desktop. App AI lain menggunakan command, path dan variable yang sama dalam tetapan MCP masing-masing. Untuk Claude Code, jalankan 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.

Tips

Mula dengan sandbox. Server ini menggunakan sandbox sehingga anda menetapkan BAYARCASH_SANDBOX kepada false. Tukar kepada production, dengan keys live, hanya selepas satu bayaran ujian berjaya.
Semak setiap bayaran sebelum assistant menciptanya. Semak amaun, pembayar dan portal. Payment link akan sampai kepada pelanggan sebenar.
Jangan letak keys anda dalam fail yang dikongsi. Fail tetapan itu menyimpan token dan secret key anda. Jangan commit fail itu ke Git, dan jangan kongsi fail itu dalam chat atau screenshot.

Isu-isu biasa

Kenapa server berhenti dengan ralat "Error: BAYARCASH_API_TOKEN and BAYARCASH_API_SECRET_KEY environment variables are required"?

App AI anda tidak menghantar kedua-dua keys itu kepada server. Tambah BAYARCASH_API_TOKEN dan BAYARCASH_API_SECRET_KEY pada bahagian env bagi entri server itu dalam tetapan MCP app anda, kemudian mulakan semula app itu.

Kenapa assistant memaparkan "Authentication failed. Check your API token and secret key."?

Keys anda tidak sepadan dengan environment. Server ini menggunakan sandbox sehingga anda menetapkan BAYARCASH_SANDBOX kepada false. Guna keys sandbox dengan sandbox, dan keys live dengan production. Lihat Cari API keys anda.

Kenapa assistant mencipta bayaran dengan saluran bayaran yang salah?

Senarai saluran dalam server ini tidak sepadan dengan nombor saluran Bayarcash bagi semua saluran. Biarkan saluran itu kosong supaya pelanggan anda memilih sendiri di page Bayarcash, atau semak saluran itu di page bayaran sebelum anda menghantar link.

Adakah artikel ini membantu?