# Sambungkan Claude atau ChatGPT kepada BCL

> Benarkan pembantu AI seperti Claude atau ChatGPT membaca jualan, pelanggan dan form BCL anda, dan membuat perubahan yang anda luluskan, melalui MCP.
>
> Source: https://docs.bcl.my/ms/connect-ai-agent/

Anda boleh menyambungkan pembantu AI seperti Claude atau ChatGPT kepada akaun BCL anda. Selepas itu, anda bertanya dalam bahasa biasa, contohnya "Berapa jualan saya bulan ini?", dan pembantu AI itu mencari jawapannya dalam BCL untuk anda. Ia juga boleh mencipta payment link dan kupon atau mengemas kini form anda, tetapi hanya jika anda benarkan.

BCL melakukannya melalui **MCP server**. MCP (Model Context Protocol) ialah standard terbuka yang membolehkan aplikasi AI menggunakan servis lain dengan selamat. Anda tidak perlu install apa-apa: anda hanya beri aplikasi AI anda satu alamat web dan log masuk dengan akaun BCL anda.

## Apa yang pembantu AI boleh buat

Selepas disambungkan, pembantu AI bekerja dengan data yang sama yang anda nampak dalam dashboard BCL:

| Bahagian | Contoh |
|---|---|
| Jualan dan transaksi | Jumlah untuk hari ini atau bulan ini, bayaran yang gagal atau pending, butiran satu pesanan |
| Pelanggan | Cari pelanggan melalui e-mel atau nombor telefon, pelanggan teratas mengikut jumlah bayaran |
| Payment form dan event | Senaraikan form anda, tukar harga, stok, tajuk atau status, duplicate form |
| Payment link dan kupon | Cipta payment link atau kupon diskaun |
| Kandungan dilindungi | Lihat siapa yang ada akses, tukar peraturan akses, on-kan atau off-kan kandungan |
| Automasi | Lihat automasi anda dan sama ada ia berjaya dijalankan (baca sahaja) |

Pembantu AI tidak boleh menukar tetapan bayaran, keys Bayarcash, tetapan syarikat atau tetapan team anda. Ia tidak boleh delete apa-apa. Untuk senarai penuh, lihat [Rujukan tool MCP](/ms/mcp-tools/). Untuk contoh soalan yang sedia digunakan, lihat [Apa yang boleh anda minta daripada pembantu AI](/ms/ai-agent-examples/).

> **Note**
> Tool jualan dan pelanggan hanya mengira bayaran **live**. Bayaran yang dibuat dalam **Test Mode** tidak dipaparkan dalam jumlah.

## Sebelum anda mula

Anda memerlukan tiga perkara:

- Akaun **Admin** dalam BCL. Page **Connect AI Agent** tidak dipaparkan kepada peranan **Team** dan **Crew Event**. Lihat [Peranan & kebenaran team](/ms/team-roles/).
- Claude (claude.ai atau aplikasi Claude Desktop) atau ChatGPT dengan pelan berbayar. Untuk aplikasi AI lain, seperti Cursor atau VS Code, lihat [Sediakan aplikasi AI lain](/ms/ai-agent-setup/).
- Beberapa minit untuk membaca apa yang anda benarkan. Pembantu AI menghantar data BCL anda, termasuk nama, e-mel dan nombor telefon pelanggan anda, kepada penyedia AI itu apabila ia menjawab anda.

## Cari alamat server BCL anda

Setiap aplikasi AI memerlukan alamat yang sama, yang dipaparkan dalam BCL:

1. Di sidebar, pergi ke **Platform Setup** → **Connect AI Agent**.

   *(Screenshot: Menu Platform Setup di sidebar BCL, dengan Connect AI Agent ditanda)*

2. Buka tab **OAuth connector**.

   *(Screenshot: Page Connect AI Agent dengan tab OAuth connector ditanda)*

3. Di bawah **2. Paste the MCP URL**, klik **Copy**. Alamatnya ialah `https://bcl.my/mcp`.

   *(Screenshot: Tab OAuth connector, dengan butang Copy di sebelah MCP URL ditanda)*

## Sambungkan Claude

Claude menggunakan connector yang sama di claude.ai dan dalam aplikasi Claude Desktop. BCL memaparkan langkah-langkah ini pada tab **Quick start** apabila anda memilih **Claude Desktop / claude.ai**:

1. Dalam Claude, buka **Settings** → **Connectors**. Untuk pelan Team dan Enterprise, owner melakukannya di **Organization settings** → **Connectors**.
2. Klik **Add custom connector**.
3. Paste `https://bcl.my/mcp` sebagai URL remote MCP server.
4. Klik **Add**. Claude membuka BCL dalam browser anda. Log masuk jika BCL meminta.

   *(Screenshot: Arahan Claude Desktop / claude.ai pada tab Quick start, dengan laluan Settings, Connectors, Add custom connector ditanda)*

5. Pada skrin BCL yang dibuka, semak kebenaran yang diminta dan klik **Authorize**. Lihat [Luluskan sambungan](#luluskan-sambungan) di bawah.

Anda tidak perlukan token atau fail config untuk Claude.

## Sambungkan ChatGPT

ChatGPT menambah BCL melalui developer mode. Tab **Quick start** BCL memberi langkah-langkah ini untuk **ChatGPT**:

1. Di laman web ChatGPT, buka **Settings** → **Apps & Connectors** → **Advanced** dan on-kan **Developer mode**. Ia hanya ada pada pelan berbayar (Plus, Pro, Business, Enterprise dan Edu). Untuk Business, Enterprise dan Edu, admin workspace mesti membenarkan developer mode dahulu.
2. Klik **Create** dan paste `https://bcl.my/mcp` sebagai MCP URL.
3. Pilih **OAuth** sebagai kaedah pengesahan. ChatGPT tidak menerima token BCL.
4. ChatGPT membuka BCL dalam browser anda. Log masuk dan klik **Authorize**.

   *(Screenshot: Arahan ChatGPT pada tab Quick start, dengan laluan Settings, Apps & Connectors, Advanced, Developer mode, Create ditanda)*

ChatGPT meminta anda mengesahkan setiap tindakan yang mengubah sesuatu dalam BCL.

Menu dalam Claude dan ChatGPT kerap berubah. Jika sesuatu label berbeza, cari "connectors" atau "custom MCP server" dalam tetapan mereka.

## Luluskan sambungan

Apabila aplikasi AI anda membawa anda ke BCL, BCL memaparkan skrin kebenaran. Skrin itu menunjukkan nama aplikasi, akaun BCL yang anda sedang log masuk, dan kebenaran yang diminta oleh aplikasi itu:

| Kebenaran | Apa yang pembantu AI boleh buat |
|---|---|
| `mcp:read` | Membaca payment link, transaksi, pelanggan, form, automasi dan kupon anda |
| `mcp:write` | Mencipta dan mengemas kini payment link, kupon dan form bagi pihak anda |

*(Screenshot: Skrin Authorize connection yang memaparkan nama aplikasi, akaun yang sedang log masuk, kebenaran mcp:read dan mcp:write, dengan butang Authorize ditanda)*

Semak bahawa **Signed in as** memaparkan akaun BCL yang betul, kemudian klik **Authorize**. Klik **Cancel** jika anda tidak kenal aplikasi itu.

Tab **OAuth connector** menerangkan dua kebenaran yang sama:

*(Screenshot: Bahagian Sign in and approve, yang menerangkan mcp:read sebagai akses baca dan mcp:write sebagai akses tulis)*

> **Caution**
> Luluskan hanya permintaan yang anda sendiri mulakan, dari aplikasi AI anda sendiri. Sesiapa sahaja boleh mendaftar aplikasi dengan apa-apa nama, jadi permintaan yang anda tidak jangka mungkin datang daripada orang lain.

Sambungan itu terus berfungsi sehingga anda membatalkannya. Aplikasi AI anda memperbaharui aksesnya di latar belakang, jadi anda tidak perlu log masuk semula setiap jam.

## Putuskan sambungan aplikasi AI

Anda boleh memutuskan akses sesuatu aplikasi pada bila-bila masa. Untuk membatalkannya:

1. Pergi ke **Platform Setup** → **Integrations**.
2. Buka tab **API Token** dan scroll ke **Connected Apps**. Bahagian ini menyenaraikan setiap aplikasi yang anda luluskan, kebenarannya, bila anda meluluskannya dan bila ia terakhir digunakan.

   *(Screenshot: Tab API Token dalam Integrations dengan bahagian Connected Apps ditanda)*

3. Klik ikon **Revoke access** pada baris aplikasi itu.
4. Dalam **Revoke App Access**, klik **Revoke Access**.

Akses aplikasi itu berhenti serta-merta. Untuk menggunakannya semula, sambungkannya sekali lagi dari aplikasi AI anda. Membuang connector dalam Claude atau ChatGPT sahaja tidak membatalkan aksesnya dalam BCL.

**Connected Apps** hanya memaparkan aplikasi yang anda luluskan dengan log masuk anda sendiri. Setiap Admin membatalkan sambungan mereka sendiri.

## Tips

Beberapa tabiat ini memastikan pembantu AI selamat digunakan pada akaun anda:

- **Mula dengan akses baca.** Tanya soalan untuk beberapa waktu dahulu sebelum anda benarkan pembantu AI menukar harga, form atau kupon.
- **Baca sebelum anda sahkan.** Apabila pembantu AI mahu mencipta payment link atau menukar form, semak jumlah, form dan pelanggan sebelum anda luluskan.
- **Semak log sekali-sekala.** **Tools** → **MCP Audit Log** menyenaraikan setiap permintaan yang dibuat oleh aplikasi AI dengan akses team anda. Lihat [Semak apa yang dilakukan oleh AI agent anda](/ms/mcp-audit-log/).

## Isu biasa

### Boleh saya sambungkan BCL kepada AI seperti Claude atau ChatGPT?

Boleh. BCL ada MCP server di https://bcl.my/mcp. Tambahkannya sebagai custom connector dalam Claude atau ChatGPT, log masuk dengan akaun BCL anda dan klik Authorize. Langkah-langkahnya ada di Platform Setup → Connect AI Agent.

### Kenapa AI kata saya tiada jualan, sedangkan dashboard saya menunjukkan test payment?

Tool AI hanya mengira bayaran live. Bayaran yang dibuat dalam Test Mode tidak dipaparkan dalam jumlah jualan, senarai transaksi atau jumlah pelanggan.

### Bagaimana saya menghalang Claude atau ChatGPT daripada mengakses akaun BCL saya?

Pergi ke Platform Setup → Integrations, buka tab API Token dan batalkan akses aplikasi itu di bawah Connected Apps. Aksesnya berhenti serta-merta.