Menghubungkan Chatbot
Pasang Aulaa MCP Server di Claude, Cursor, VS Code, n8n, Claude API, OpenAI API, atau kode Anda sendiri.
Semua klien memakai dua isian yang sama:
| Isian | Nilai |
|---|---|
| Alamat (URL) | https://mcp.aulaa.co/mcp |
| Transport | Streamable HTTP |
| Header | Authorization: Bearer pgw_id_xxxxxxxxxxxxxxxx (API Key project Anda) |
Ganti pgw_id_xxxxxxxxxxxxxxxx dengan API Key project bertipe API. Belum punya? Lihat Sebelum mulai.
API Key bisa membuat dan membatalkan tagihan atas nama Anda. Simpan di berkas konfigurasi di komputer Anda atau di variabel lingkungan server. Jangan tempel di repositori publik, di dalam percakapan, atau di kode yang berjalan di browser.
Claude Code
Jalankan sekali di terminal:
claude mcp add --transport http aulaa https://mcp.aulaa.co/mcp --header "Authorization: Bearer pgw_id_xxxxxxxxxxxxxxxx"
Cek dengan claude mcp list. Status aulaa harus Connected. Setelah itu tulis permintaan biasa, misalnya "Buat tagihan Rp250.000 untuk Budi, servis AC 2 unit".
Claude Desktop
Claude Desktop menyambung ke server jarak jauh lewat jembatan mcp-remote, jadi komputer Anda perlu Node.js 18 atau lebih baru.
- Buka Settings → Developer → Edit Config. Berkas
claude_desktop_config.jsonakan terbuka. - Tambahkan
aulaadi dalammcpServers:
{
"mcpServers": {
"aulaa": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.aulaa.co/mcp",
"--header",
"Authorization:${AULAA_AUTH_HEADER}"
],
"env": {
"AULAA_AUTH_HEADER": "Bearer pgw_id_xxxxxxxxxxxxxxxx"
}
}
}
}
- Tutup Claude Desktop sepenuhnya, lalu buka lagi. Tool Aulaa muncul di menu alat pada kotak chat.
Tulis
Authorization:${AULAA_AUTH_HEADER}tanpa spasi setelah titik dua. Spasinya sudah ada di nilaiBearer pgw_id_.... Cara ini menghindari masalah tanda kutip di Windows.
Menu Connectors → Add custom connector di claude.ai dan Claude Desktop belum bisa dipakai, karena menu itu tidak menyediakan isian API Key.
Cursor
Tambahkan ke ~/.cursor/mcp.json (untuk semua project) atau .cursor/mcp.json (untuk satu project):
{
"mcpServers": {
"aulaa": {
"url": "https://mcp.aulaa.co/mcp",
"headers": {
"Authorization": "Bearer pgw_id_xxxxxxxxxxxxxxxx"
}
}
}
}
Buka Settings → MCP dan pastikan aulaa menyala hijau.
VS Code
Buat .vscode/mcp.json. Dengan inputs, VS Code menanyakan API Key sekali lalu menyimpannya dengan aman, jadi key tidak tertulis di berkas:
{
"inputs": [
{
"type": "promptString",
"id": "aulaa-api-key",
"description": "API Key Aulaa (pgw_id_...)",
"password": true
}
],
"servers": {
"aulaa": {
"type": "http",
"url": "https://mcp.aulaa.co/mcp",
"headers": {
"Authorization": "Bearer ${input:aulaa-api-key}"
}
}
}
}
Klik Start di atas aulaa di berkas itu, lalu pakai tool-nya dari Chat dalam mode Agent.
n8n
Cocok untuk bot WhatsApp, Telegram, atau formulir yang dijalankan workflow n8n.
- Tambahkan node AI Agent, lalu di bagian Tool pilih MCP Client Tool.
- Isi:
| Isian | Nilai |
|---|---|
| Endpoint | https://mcp.aulaa.co/mcp |
| Server Transport | HTTP Streamable |
| Authentication | Bearer Auth, token = API Key Aulaa Anda |
| Tools to Include | All |
- Di prompt sistem AI Agent, jelaskan kapan agen boleh membuat tagihan, misalnya "Buat tagihan hanya setelah pelanggan setuju dengan nominalnya".
Claude API (MCP connector)
Untuk chatbot buatan sendiri di server. Claude menyambung langsung ke Aulaa MCP Server, jadi Anda tidak perlu menulis kode untuk menjalankan tool.
import os
import anthropic
client = anthropic.Anthropic() # membaca ANTHROPIC_API_KEY
response = client.beta.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
betas=["mcp-client-2025-11-20", "server-side-fallback-2026-07-01"],
fallbacks="default",
mcp_servers=[
{
"type": "url",
"url": "https://mcp.aulaa.co/mcp",
"name": "aulaa",
"authorization_token": os.environ["AULAA_API_KEY"],
}
],
tools=[{"type": "mcp_toolset", "mcp_server_name": "aulaa"}],
messages=[
{"role": "user", "content": "Tolong tagih Andi Rp150.000 untuk DP katering 50 porsi"}
],
)
for block in response.content:
if block.type == "text":
print(block.text)
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // membaca ANTHROPIC_API_KEY
const response = await client.beta.messages.create({
model: "claude-opus-5-5",
max_tokens: 16000,
betas: ["mcp-client-2025-11-20", "server-side-fallback-2026-07-01"],
fallbacks: "default",
mcp_servers: [
{
type: "url",
url: "https://mcp.aulaa.co/mcp",
name: "aulaa",
authorization_token: process.env.AULAA_API_KEY,
},
],
tools: [{ type: "mcp_toolset", mcp_server_name: "aulaa" }],
messages: [
{ role: "user", content: "Tolong tagih Andi Rp150.000 untuk DP katering 50 porsi" },
],
});
for (const block of response.content) {
if (block.type === "text") console.log(block.text);
}
authorization_token dikirim Claude sebagai Authorization: Bearer <token>, jadi isi dengan API Key Aulaa apa adanya (tanpa kata Bearer). fallbacks: "default" membuat permintaan dilanjutkan model cadangan bila model utama menolak; hapus bila tidak diperlukan.
OpenAI API
Responses API OpenAI juga bisa memakai MCP server jarak jauh:
import os
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-5", # ganti dengan model OpenAI yang Anda pakai
tools=[
{
"type": "mcp",
"server_label": "aulaa",
"server_url": "https://mcp.aulaa.co/mcp",
"headers": {"Authorization": f"Bearer {os.environ['AULAA_API_KEY']}"},
"require_approval": "never",
}
],
input="Tolong tagih Andi Rp150.000 untuk DP katering 50 porsi",
)
print(response.output_text)
Dengan require_approval: "never" model boleh memanggil semua tool tanpa persetujuan. Bila ingin cancel_payment selalu disetujui manusia, atur persetujuan per tool sesuai dokumentasi OpenAI.
Kode sendiri (MCP SDK)
Bila aplikasi Anda memanggil tool secara langsung, tanpa model AI di tengah:
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const transport = new StreamableHTTPClientTransport(new URL("https://mcp.aulaa.co/mcp"), {
requestInit: { headers: { Authorization: `Bearer ${process.env.AULAA_API_KEY}` } },
});
const client = new Client({ name: "bot-toko-saya", version: "1.0.0" });
await client.connect(transport);
const result = await client.callTool({
name: "create_payment_link",
arguments: { order_id: "INV-20261117-ANDI", amount: 150000, customer_name: "Andi" },
});
console.log(result.structuredContent); // payment_link, customer_message, tracking, ...
await client.close();
Kalau tidak ada model AI yang memilih tool, API Call biasa sering lebih sederhana. MCP Server berguna bila Anda ingin pesan tagihan dan pengingat yang sudah jadi.
Cek koneksi dengan cURL
Server bisa dites langsung tanpa klien MCP. Kedua jenis Accept wajib dikirim:
curl -s https://mcp.aulaa.co/mcp \
-H "Authorization: Bearer pgw_id_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_payment_methods","arguments":{}}}'
Bila berhasil, hasilnya berisi daftar metode pembayaran project Anda. Bila API Key salah, hasilnya 401 Unauthorized. Penjelasan error lain ada di Keamanan, Batasan & Error.
Petunjuk untuk chatbot
Server sudah membawa petunjuk dasar untuk model AI. Untuk chatbot yang melayani pelanggan, tambahkan aturan bisnis Anda di prompt sistem, misalnya:
Kamu admin toko Katering Bu Sari. Saat pelanggan setuju memesan:
1. Konfirmasi nominal dan isi pesanan sebelum membuat tagihan.
2. Buat tagihan dengan create_payment_link. order_id: KTR-<tanggal>-<nama>-<nomor urut>.
3. Kirim customer_message apa adanya. Jangan mengubah atau mengarang link.
4. Simpan tracking dari setiap tagihan.
5. Bila pelanggan bilang sudah bayar, cek dengan get_payment_status. Anggap lunas hanya bila status = paid.
6. Jangan membatalkan tagihan kecuali pelanggan atau admin memintanya.
Terakhir diperbarui 17 November 2026