Rujukan tool MCP

MCP server BCL di https://bcl.my/mcp memberi AI agent 62 tool: 30 untuk membaca dan 32 untuk menulis. Setiap tool melakukan kerja yang sama seperti satu endpoint API BCL, dengan semakan yang sama. Page ini menyenaraikan kesemuanya, dengan kebenaran yang diperlukan oleh setiap tool dan rate limit-nya.

Untuk menyambungkan agent, lihat Sambungkan Claude atau ChatGPT kepada BCL atau Sediakan aplikasi AI lain. BCL memaparkan senarai yang sama di Platform Setup → Connect AI Agent, pada tab Capabilities.

Kebenaran

Token atau sambungan OAuth memerlukan sekurang-kurangnya satu kebenaran MCP. Agent hanya nampak tool yang dibenarkan oleh kebenarannya:

Kebenaran	Kotak semak token	Memberi akses kepada
mcp:read	MCP Read	Setiap tool baca di bawah
mcp:write	MCP Write	Setiap tool tulis di bawah. Ia tidak termasuk tool baca.
Akses penuh (*)	(token lama sahaja)	Semua tool

Token dengan API Read atau API Write sahaja ditolak dengan “Token needs at least one of: mcp:read, mcp:write”. Tool tulis yang dipanggil tanpa mcp:write memulangkan “Tool ‘…’ requires the ‘mcp:write’ ability”.

Agent nampak data yang sama seperti pengguna BCL yang mencipta token atau meluluskan sambungan itu. Admin nampak data seluruh team. Ahli Team hanya nampak data mereka sendiri, melainkan Show data for all team members di-on-kan. Lihat Peranan & kebenaran team.

Transaksi & bayaran

Tool ini meliputi bayaran dan Direct Debit. list_transactions, get_transaction_stats dan tool pelanggan hanya mengira bayaran live; bayaran Test Mode tidak dikira.

Tool	Apa yang ia buat	Jenis	Had
list_transactions	Senaraikan transaksi. Filter: tarikh, status, saluran bayaran, jumlah, jenis form, cari melalui nombor pesanan, nama, e-mel atau nombor telefon	Read	read
get_transaction_stats	Untuk julat tarikh (default 30 hari lepas): hasil dan bilangan yang dibayar, semua transaksi mengikut status, transaksi yang dibayar mengikut saluran bayaran dan jenis form	Read	read
get_transaction	Satu transaksi melalui nombor pesanan, seperti LINK-00123: item, pembayar, saluran, status	Read	read
get_transaction_by_order	Carian yang sama dengan butiran lebih lengkap	Read	read
get_mandate	Satu mandate Direct Debit melalui nombor pesanan	Read	read
create_payment_link	Cipta payment link. Memerlukan jumlah, nama pembayar, e-mel, nombor telefon dan portal key	Write	sensitive
create_payment_mandate	Cipta pendaftaran mandate Direct Debit	Write	sensitive

Pelanggan

Tool pelanggan mencari orang yang sudah membayar anda:

Tool	Apa yang ia buat	Jenis	Had
list_customers	Senaraikan pelanggan, cari melalui e-mel atau nombor telefon, susun mengikut jumlah bayaran atau bilangan transaksi	Read	read
get_customer	Satu pelanggan dengan transaksi terkininya	Read	read

Payment form

Kebanyakan tool form menukar satu tetapan pada satu masa, supaya agent boleh membuat satu perubahan dengan berhati-hati:

Tool	Apa yang ia buat	Jenis	Had
list_forms	Senaraikan payment form	Read	read
get_form	Satu form secara penuh: produk, variasi, kupon, tetapan webhook dan affiliate	Read	read
list_showcase_forms	Form yang dipaparkan di homepage anda	Read	read
duplicate_form	Copy form dengan tajuk dan slug baru. Salinan itu terus live	Write	write
update_form_status	On-kan atau off-kan form	Write	write
update_form_title	Tukar nama form	Write	write
update_form_slug	Tukar alamat web form	Write	write
update_form_content	Tukar penerangan form	Write	write
update_form_prices	Tukar harga produk atau variasi, termasuk tier diskaun kuantiti	Write	write
update_form_stock	Tukar stok produk	Write	write
update_form_coupon	Tambah atau buang kupon pada form	Write	write
update_form_affiliate	On-kan atau off-kan affiliate untuk form itu, paparkan maklumat affiliate, override komisen	Write	write
update_form_redirect_urls	Tetapkan page yang dibuka selepas bayaran berjaya atau gagal	Write	write
update_form_webhook	Tetapkan URL webhook form	Write	write
update_form_facebook_pixel	Tetapkan Facebook Pixel ID	Write	write
update_form_tiktok_pixel	Tetapkan TikTok Pixel ID	Write	write
update_form_homepage	Paparkan atau sembunyikan form di homepage anda	Write	write

Event form & tiket

Tool event berfungsi pada event form dan form tiket anda:

Tool	Apa yang ia buat	Jenis	Had
list_event_forms	Senaraikan event form	Read	read
get_event_form	Satu event dengan tier tiket dan tetapannya	Read	read
update_event_form_status	Terbitkan event atau tetapkan kepada draf	Write	write
update_event_form_slug	Tukar alamat web event	Write	write
update_event_form_venue_name	Tukar nama tempat	Write	write
update_event_form_content	Tukar penerangan event	Write	write
update_event_form_tickets	Tukar tier tiket dan stok	Write	write
update_event_form_ticket_prices	Tukar harga tiket	Write	write
update_event_form_affiliate	Tetapan affiliate untuk event itu	Write	write
update_event_form_facebook_pixel	Tetapkan Facebook Pixel ID	Write	write
update_event_form_tiktok_pixel	Tetapkan TikTok Pixel ID	Write	write
update_event_form_homepage	Paparkan atau sembunyikan event di homepage anda	Write	write

Kupon

Tool kupon membaca dan mengurus kod diskaun anda:

Tool	Apa yang ia buat	Jenis	Had
list_coupons	Senaraikan kupon	Read	read
get_coupon	Satu kupon dengan tetapan dan penggunaannya	Read	read
create_coupon	Cipta kupon peratusan atau jumlah tetap, dengan had dan tarikh jika perlu	Write	sensitive
update_coupon	Tukar tetapan kupon	Write	write
update_coupon_status	On-kan atau off-kan kupon	Write	write

Kandungan dilindungi

Tool kandungan dilindungi meliputi video, fail, teks dan link anda yang hanya boleh dibuka oleh orang yang ada akses:

Tool	Apa yang ia buat	Jenis	Had
list_protected_contents	Senaraikan kandungan dilindungi dengan bilangan pelanggan	Read	read
get_protected_content	Satu item dengan tetapan akses dan bilangan tontonan dan muat turunnya	Read	read
get_protected_content_customers	Siapa yang ada akses, dengan penggunaan mereka	Read	read
update_protected_content_status	On-kan atau off-kan kandungan	Write	write
update_protected_content_title	Tukar tajuk page dan subjek e-mel akses	Write	write
update_protected_content_access	Tukar jenis akses, tarikh, tempoh, had peranti dan had muat turun	Write	write

Butiran lanjut: Urus kandungan dilindungi melalui API & tool AI.

Automasi

Automasi hanya boleh dibaca:

Tool	Apa yang ia buat	Jenis	Had
list_automations	Senaraikan automasi dengan trigger dan bilangan larian	Read	read
get_automation	Satu automasi dengan syarat dan langkahnya	Read	read
get_automation_executions	Sejarah larian: larian mana yang berjaya atau gagal	Read	read
get_automation_stats	Bilangan berjaya dan gagal	Read	read

Tool platform (staf BCL sahaja)

Sembilan tool baca bermula dengan platform_: platform_revenue_overview, platform_revenue_concentration, platform_merchant_performance, platform_growth_and_churn, platform_form_performance, platform_conversion_funnel, platform_traffic_overview, platform_affiliate_overview dan platform_monthly_trend. Tool ini melaporkan tentang keseluruhan platform BCL. Agent anda nampak tool ini dalam senarai tool-nya, tetapi untuk akaun merchant tool ini hanya memulangkan “Platform analytics are available to super admins only.”

Apa yang tool tidak boleh buat

Sesetengah kerja hanya boleh dibuat dalam dashboard BCL. Tool tidak boleh:

• Delete apa-apa.
• Mencipta payment form, event form, booking form atau lead form dari kosong, atau upload fail.
• Membaca booking form, lead form, peserta atau affiliate.
• Menukar tetapan bayaran, keys Bayarcash, caj gateway, tetapan syarikat atau team, atau API token.
• Menghantar e-mel, SMS atau mesej WhatsApp.

Rate limit

Setiap token atau sambungan OAuth ada hadnya sendiri, dikira setiap minit:

Bucket	Had	Digunakan oleh
read	100 seminit	Setiap tool baca
write	10 seminit	Setiap tool tulis kecuali tiga di bawah
sensitive	3 seminit	create_payment_link, create_payment_mandate, create_coupon
meta	60 seminit	Menyambung, menyenaraikan tool dan ping (initialize, tools/list, ping)

Jika melebihi had, panggilan itu gagal dengan “Rate limit exceeded for bucket ‘sensitive’. Retry in 42s.” (dengan bucket dan bilangan saat yang berkenaan) dan kod error -32003. Data respons memberi bucket, limit_per_minute dan retry_after_seconds, jadi agent yang baik akan menunggu dan mencuba semula.

Error

Server ini menggunakan JSON-RPC 2.0 melalui HTTP POST. Ini error yang agent boleh terima:

Kod	Maksud
-32001	Tiada token, atau token tidak sah atau sudah tamat tempoh (HTTP 401)
-32002	Token tiada kebenaran untuk tool ini (HTTP 403 jika token langsung tiada kebenaran MCP)
-32003	Rate limit dicapai
-32601	Nama method atau tool tidak wujud
-32602	tools/call tanpa nama tool
-32700	Body permintaan bukan JSON

Apabila input sesuatu tool salah, contohnya nombor pesanan tiada, tool itu sendiri menjawab dengan isError: true dan mesej “Validation failed” yang menyenaraikan setiap ruangan. Untuk setiap argumen bagi setiap tool, tanya agent anda “Show me the inputs for <tool name>”, atau lihat rujukan API BCL.

Setiap permintaan yang dibuat dengan token yang sah, termasuk panggilan yang ditolak dan gagal, direkodkan dalam Tools → MCP Audit Log. Permintaan tanpa token yang sah tidak direkodkan. Lihat Semak apa yang dilakukan oleh AI agent anda.

Isu-isu biasa

Kenapa agent tidak boleh membaca apa-apa walaupun token saya ada MCP Write?

MCP Write hanya meliputi tool tulis. Tandakan MCP Read juga supaya agent boleh menyemak data sebelum ia membuat perubahan.

Agent kata "Rate limit exceeded". Apa yang perlu saya buat?

Setiap token atau sambungan ada had seminit untuk setiap jenis tool. Tunggu selama bilangan saat yang diberi dalam mesej itu, atau minta agent membuat lebih sedikit perubahan pada satu masa.

Kenapa agent menyenaraikan tool platform_ yang saya tidak boleh guna?

Sembilan tool platform_ melaporkan tentang keseluruhan platform BCL dan hanya berfungsi untuk staf BCL. Untuk merchant, tool ini memulangkan "Platform analytics are available to super admins only." Abaikan sahaja.

Artikel berkaitan

• Sambungkan Claude atau ChatGPT kepada BCL
• Sediakan aplikasi AI lain (Cursor, Claude Code, VS Code & banyak lagi)
• Cipta API token
• Semak apa yang dilakukan oleh AI agent anda