Menu dokumentasi

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.

  1. Buka Settings → Developer → Edit Config. Berkas claude_desktop_config.json akan terbuka.
  2. Tambahkan aulaa di dalam mcpServers:
{
  "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"
      }
    }
  }
}
  1. 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 nilai Bearer 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.

  1. Tambahkan node AI Agent, lalu di bagian Tool pilih MCP Client Tool.
  2. 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
  1. 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