Hubungkan Liqaa ke asisten AI Anda

Apa itu Liqaa MCP?

MCP adalah standar terbuka yang membuat model AI bisa memanggil "tools" pada layanan eksternal. Liqaa MCP mengekspos data customer-service Anda sebagai tools, sehingga asisten AI dapat menjawab pertanyaan seperti "ada berapa tiket open prioritas tinggi?" atau menjalankan aksi seperti "balas percakapan ini" — langsung terikat pada tenant dan akun Anda.

Endpoint: POST https://api.liqaa.id/mcp — JSON-RPC 2.0 (Streamable HTTP, stateless). Autentikasi: OAuth 2.1 (PKCE) atau header Authorization: Bearer lqa_live_….

Yang bisa dilakukan

• Baca & balas percakapan customer, klaim/lepas, tandai selesai/buka kembali
• Kelola tiket helpdesk — buat, ubah status, tambah komentar
• Baca & tambah dokumen knowledge base, cari isinya
• Lihat & tambah domain widget, lihat analitik widget
• Lihat status billing, penggunaan vs limit plan, ringkasan dashboard

Setiap panggilan bertindak sebagai staf pemilik API key — perlu jadi anggota percakapan (klaim dulu) sebelum bisa membalas.

Contoh pemakaian

1. Menutup celah knowledge base secara berkala

AI Anda mencatat sendiri pertanyaan yang tidak bisa dijawabnya — setiap kali percakapan dialihkan ke manusia, sistem menyimpan ringkasan singkat berisi apa yang ditanyakan dan apa yang sudah dicoba. Minta asisten Anda: "lihat celah KB 7 hari terakhir, kelompokkan yang berulang, lalu buatkan draf artikel untuk tiga teratas." Kegagalan AI hari ini menjadi artikel yang mencegahnya gagal besok.

Tools: liqaa_kb_gaps → liqaa_kb_search → liqaa_create_kb_document

2. Bekerja lintas sistem dalam satu sesi

Ini yang tidak bisa dilakukan dashboard mana pun. Dalam satu sesi, asisten Anda bisa memegang Liqaa bersamaan dengan repositori kode, pelacak isu, atau spreadsheet Anda: membaca laporan bug dari percakapan pelanggan, membuka issue lengkap dengan konteksnya, lalu membalas pelanggan dengan nomor tiketnya — tanpa menyalin-tempel antar tab.

3. Bertanya pada data, bukan mencarinya

"Berapa percakapan yang belum ditangani sekarang?" · "Keluhan apa yang paling sering muncul minggu ini?" · "Apakah pemakaian bulan ini akan melewati limit paket?" — dijawab dari data nyata, tanpa membuka dashboard atau menyusun laporan manual.

4. Triase dan draf balasan

Asisten membaca antrean yang belum ditangani, merangkum tiap percakapan, dan menyusun draf balasan dengan gaya bahasa Anda. Anda yang memutuskan mana yang dikirim — klaim dan pengiriman tetap butuh persetujuan Anda.

5. Menyiapkan akun baru

Mengisi knowledge base dari situs dan dokumen yang sudah ada, mendaftarkan domain, memeriksa status verifikasi — pekerjaan setup yang biasanya berjam-jam mengklik menjadi satu instruksi.

6. Audit mutu layanan

Minta asisten membaca percakapan yang sudah selesai dan menandai mana yang jawabannya keliru, nadanya kurang tepat, atau responsnya terlalu lama — evaluasi yang biasanya tidak sempat dikerjakan siapa pun.

Cara tercepat: hubungkan sekali klik

Untuk Claude (termasuk Cowork), Claude Desktop, dan klien lain yang punya UI konektor: Anda tidak perlu API key sama sekali.

1. Buka Pengaturan → Konektor → Tambahkan konektor kustom.
2. Isi URL: https://api.liqaa.id/mcp
3. Kosongkan kolom OAuth Client ID & Secret. Server akan mendaftarkan klien Anda otomatis.
4. Klik Hubungkan → Anda diarahkan ke halaman persetujuan Liqaa → setujui → selesai.

Anda perlu sudah masuk di member.liqaa.id pada browser yang sama. Bila belum, halaman itu akan meminta Anda masuk lalu kembali sendiri. Akses bisa dicabut kapan saja lewat tombol "Putuskan sambungan" di klien.

Alternatif: API key (untuk klien CLI)

Klien berbasis file konfigurasi (Claude Code, Cursor, VS Code, Gemini CLI) memakai header API key. Buka member.liqaa.id/panel/settings/api-keys → buat key baru. Salin key lqa_live_… — hanya ditampilkan sekali.

Claude Code (CLI)

Jalankan perintah ini di terminal:

claude mcp add --transport http liqaa https://api.liqaa.id/mcp \
  --header "Authorization: Bearer lqa_live_XXXXXXXX"

Claude Desktop

Settings → Developer → Edit Config, lalu tambahkan (memakai bridge mcp-remote untuk jembatan ke server remote):

{
  "mcpServers": {
    "liqaa": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.liqaa.id/mcp",
               "--header", "Authorization: Bearer lqa_live_XXXXXXXX"]
    }
  }
}

Cursor

Buat ~/.cursor/mcp.json (global) atau .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "liqaa": {
      "url": "https://api.liqaa.id/mcp",
      "headers": { "Authorization": "Bearer lqa_live_XXXXXXXX" }
    }
  }
}

VS Code (GitHub Copilot)

Buat .vscode/mcp.json di workspace Anda:

{
  "servers": {
    "liqaa": {
      "type": "http",
      "url": "https://api.liqaa.id/mcp",
      "headers": { "Authorization": "Bearer lqa_live_XXXXXXXX" }
    }
  }
}

Ekstensi Cline / Continue juga mendukung MCP — tambahkan URL & header yang sama di setelan MCP-nya.

Google Gemini CLI

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "liqaa": {
      "httpUrl": "https://api.liqaa.id/mcp",
      "headers": { "Authorization": "Bearer lqa_live_XXXXXXXX" }
    }
  }
}

ChatGPT

ChatGPT mendukung MCP lewat Developer Mode / Custom Connectors (Plus/Pro/Enterprise). Masukkan URL https://api.liqaa.id/mcp.

UI connector ChatGPT mengutamakan OAuth dan tidak menyediakan field header API-key statis. Karena Liqaa MCP kini mendukung OAuth, jalur ini semestinya bekerja — namun kami baru menguji end-to-end di Claude/Cowork, belum di ChatGPT. Kabari kami bila Anda menemui kendala.

Klien MCP lain / bridge universal

Klien MCP apa pun yang mendukung Streamable HTTP: pakai URL + header di atas. Untuk klien yang hanya mendukung stdio, jembatani dengan mcp-remote:

npx -y mcp-remote https://api.liqaa.id/mcp \
  --header "Authorization: Bearer lqa_live_XXXXXXXX"

Daftar tools

Keamanan

• Setiap panggilan terikat ke tenant pemilik koneksi — tak ada akses lintas-tenant.
• Aksi berjalan sebagai akun staf pemilik koneksi (bukan akun terpisah), jadi mengikuti hak akses akun itu apa adanya.
• OAuth memakai PKCE; token akses berumur pendek dan bisa dicabut lewat "Putuskan sambungan" di klien. API key bisa dicabut di panel.

Dua batas yang perlu Anda tahu. Pertama, belum ada pemisahan scope baca/tulis di sisi server — setiap koneksi bisa membaca dan mengelola. Sebagai gantinya, klien seperti Claude/Cowork menyediakan izin per-tool (izinkan / tanya dulu / blokir); kami sarankan set tool tulis ke "tanya dulu". Kedua, karena aksi berjalan sebagai akun Anda, di log audit tindakan AI tidak terbedakan dari tindakan Anda sendiri.

FAQ

Apakah gratis? Ya, termasuk dalam langganan Liqaa Anda.

Bisa dipakai banyak AI sekaligus? Bisa — endpoint & key yang sama bekerja di semua klien MCP.

Bagaimana dengan OAuth untuk Claude / Cowork? Sudah tersedia — dan itu jalur yang kami sarankan. Cukup isi URL dan kosongkan kolom OAuth; lihat bagian di atas.

Apakah AI bisa membalas pelanggan tanpa sepengetahuan saya? Tool tulis (membalas, klaim, ubah tiket) tersedia bila koneksi diizinkan memakainya. Di Claude/Cowork Anda bisa mengatur izin per-tool — set tool tulis ke "tanya dulu" agar setiap pengiriman perlu persetujuan Anda.