MCP Connection

Apa itu MCP Connection?

MCP Connection memungkinkan AI agent seperti Claude Code, Claude Desktop, atau Cursor mengakses dan mengoperasikan AlurKerja secara langsung — mulai dari mengerjakan task, membuat proses BPMN, mengisi company profile, mengelola org chart, hingga membaca dan mengisi master data — semua cukup dengan instruksi natural language.

Detail Server

Sebelum memulai, berikut detail server yang digunakan pada seluruh client:

Tidak diperlukan OAuth maupun password yang harus dibagikan. Setiap pengguna membuat token miliknya sendiri yang terikat pada akun masing-masing.

Langkah 1: Buka Halaman MCP Connection

1. Login ke AlurKerja
2. Klik nama/avatar kamu di pojok kanan atas
3. Pilih MCP Connection dari dropdown menu

Langkah 2: Salin MCP Server URL

Pada bagian MCP Server URL, klik Copy URL. Nilai inilah yang dipakai sebagai endpoint saat mengonfigurasi MCP client pada langkah berikutnya.

Langkah 3: Generate Token

1. Di bagian "Generate a new token", isi Token label (opsional) — contoh: Claude Desktop — laptop kerja
2. Klik tombol + Generate Token
3. Token akan muncul sekali dalam format awk_live_xxxxxx...
4. Klik Copy token dan simpan di tempat yang aman

Langkah 4: Konfigurasi MCP Client

Pada setiap contoh di bawah, sesuaikan dua nilai berikut:

• <domain-alurkerja-anda> — ganti dengan domain server AlurKerja kamu, atau salin URL lengkapnya dari halaman MCP Connection.
• awk_live_YOUR_TOKEN — ganti dengan token yang sudah kamu generate. Token environment produksi berawalan awk_live_, sedangkan token environment testing berawalan awk_test_.

Claude Code — satu perintah

Metode paling cepat. Jalankan satu perintah berikut:

claude mcp add --transport http alurkerja https://<domain-alurkerja-anda>/api/v1/integration/mcp/server \
  --header "Authorization: Bearer awk_live_YOUR_TOKEN"

Verifikasi koneksi dengan perintah:

claude mcp list

Apabila kamu ingin membagikan konfigurasi kepada seluruh anggota tim, commit file .mcp.json pada root project:

{
  "mcpServers": {
    "alurkerja": {
      "type": "http",
      "url": "https://<domain-alurkerja-anda>/api/v1/integration/mcp/server",
      "headers": { "Authorization": "Bearer awk_live_YOUR_TOKEN" }
    }
  }
}

Claude Desktop / Cursor / VS Code

Client seperti Claude Desktop, Cursor, dan VS Code menjalankan MCP server sebagai proses lokal, sehingga koneksi ke server remote dilakukan lewat bridge mcp-remote — paket npm kecil yang menerjemahkan protokol MCP ke endpoint HTTP remote. URL server dan token dikirim sebagai argumen, bukan lewat field url.

Buka file konfigurasi client kamu — untuk Claude Desktop yaitu claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) — tambahkan konfigurasi berikut sesuai sistem operasi, lalu mulai ulang (restart) aplikasi:

{
  "mcpServers": {
    "alurkerja": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<domain-alurkerja-anda>/api/v1/integration/mcp/server",
        "--header",
        "Authorization: Bearer awk_live_YOUR_TOKEN"
      ]
    }
  }
}

{
  "mcpServers": {
    "alurkerja": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-remote",
        "https://<domain-alurkerja-anda>/api/v1/integration/mcp/server",
        "--header",
        "Authorization: Bearer awk_live_YOUR_TOKEN"
      ]
    }
  }
}

ChatGPT / Perplexity / client lain

Client apa pun yang mendukung remote MCP server dengan custom header dapat digunakan. Isi konfigurasi berikut:

transport: streamable-http
url:        https://<domain-alurkerja-anda>/api/v1/integration/mcp/server
header:     Authorization: Bearer awk_live_YOUR_TOKEN

Mengelola Token

Di bagian "Your tokens" kamu bisa melihat semua token yang sudah dibuat:

Klik Revoke untuk menonaktifkan token yang tidak dipakai atau dicurigai bocor. Token yang di-revoke tidak bisa diaktifkan kembali — buat token baru jika dibutuhkan.

Catatan Keamanan

• Jangan share token ke orang lain
• Buat token terpisah per perangkat/aplikasi agar mudah di-revoke
• Live token (awk_live_) berlaku untuk environment production, test token (awk_test_) untuk environment test
• Segera revoke token jika perangkat hilang atau token bocor

Daftar MCP Tools

Berikut semua tools yang tersedia saat AlurKerja terhubung sebagai MCP server:

🔧 Infrastructure

🗂️ Tasklist & Process

📄 BPMN Drive

🏢 Company Profile

🌳 Org Chart

📊 Dashboard

🧮 Question & Schema

Question adalah query SQL tersimpan yang menjadi sumber data widget dashboard. Semua tool di kategori ini hanya untuk Admin SOP dan Owner — termasuk membaca daftar question dan tabel.

🗃️ Master Data

Kategori ini memungkinkan AI agent membuat tabel master data dan membaca serta mengisi barisnya. Untuk bekerja dengan satu tabel, mulai dari list_masterdata_tables untuk mendapatkan slug tabel, lalu list_masterdata_records untuk melihat slug tiap kolom.

🕘 Riwayat & Pengajuan

Kategori ini menjawab pertanyaan seperti "pengajuan ini sekarang sampai di mana?" atau "kenapa berhenti?". Alurnya:

1. Jika kamu hanya tahu isi sebuah variable (misalnya nomor invoice), pakai search_instances_by_variable untuk mendapatkan ID instance-nya.
2. Panggil get_process_instance dengan ID tersebut. Hasilnya berupa langkah demi langkah: nama langkah, penanggung jawab, waktu mulai dan selesai, durasi, serta SLA untuk user task. Langkah berstatus open adalah tempat pengajuan sedang menunggu.
3. Jika langkah memanggil sub-proses, panggil get_process_instance lagi dengan ID instance anak yang tertera.
4. Untuk lampiran, minta get_process_instance menyertakan variable agar attachment_id muncul, lalu unduh dengan download_task_attachment.

💬 Diskusi & Notifikasi

📈 Metric & KPI

Metric adalah angka bernama yang dihitung dari sebuah question atau dari metric lain. KPI adalah metric yang dilengkapi target dan cara penilaiannya, seperti pada halaman Metrics & KPI. Untuk membuat KPI baru, buat metric-nya lebih dulu, lalu create_kpi di atasnya.

🧾 Log Aktivitas

Cari ID instance lebih dulu dengan get_process_instance, search_instances_by_variable, atau list_my_tasks. Konfigurasi addon (yang bisa memuat kredensial) tidak pernah ditampilkan.

Sample Prompts

Setelah MCP terhubung, kamu bisa langsung menggunakan natural language di Claude Desktop / Cursor. Berikut contoh prompt per fitur:

🗂️ Tasklist & Process

Tampilkan semua task yang sedang aku kerjakan di workspace javan.

Ada task apa saja di group task workspace javan yang belum diklaim?

Klaim task "Review Dokumen Pengadaan" dan selesaikan dengan mengisi form-nya.

Tampilkan daftar proses yang bisa aku mulai di workspace javan,
lalu bantu aku memulai proses "Pengajuan Cuti".

Delegasikan task #1749772 ke budi@javan.co.id.

Selesaikan semua task yang ada di my-task workspace javan
yang sudah lewat 3 hari tanpa progress.

📄 BPMN Drive

Tampilkan daftar file BPMN yang ada di Drive workspace javan.

Baca file BPMN "Proses Rekrutmen" dan jelaskan alur prosesnya.

Buat file BPMN baru bernama "Proses Onboarding Karyawan"
dengan start event, satu user task "Pengisian Data Diri", dan end event.

Update file BPMN "Proses Pengadaan" — tambahkan approval step
dari manajer sebelum proses selesai.

Hapus file BPMN "Draft Lama" dari Drive workspace javan.

Unduh file BPMN "Proses Rekrutmen" dan ringkas langkah-langkahnya.

Tampilkan semua node di file BPMN "Proses Pengadaan" beserta
field form di setiap user task.

🏢 Company Profile

Tampilkan company profile workspace javan saat ini.

Update vision perusahaan di workspace javan menjadi:
"Menjadi platform BPM terdepan di Asia Tenggara pada 2030."

Isi purpose, vision, dan culture perusahaan di workspace javan
berdasarkan informasi berikut: [paste deskripsi perusahaan]

Update informasi perusahaan: nama PT Javan Cipta Solusi,
alamat Bandung, website javan.co.id, industri Technology.

🌳 Org Chart

Tampilkan struktur org chart workspace javan.

Tambahkan divisi baru bernama "Divisi AI & Automation"
sebagai child dari node "Engineering".

Pindahkan node "Tim QA" ke bawah "Divisi Engineering".

Tambahkan user budi@javan.co.id ke node "Divisi Engineering".

Tampilkan siapa saja yang ada di node "Product Team".

Hapus node "Tim Sementara" beserta semua sub-node di dalamnya.

📊 Dashboard

Tampilkan daftar dashboard yang ada di workspace javan.

Buat dashboard baru bernama "KPI Operasional Q3 2026".

Duplikasi dashboard "Monitoring Proses" menjadi
"Monitoring Proses — Backup".

Hapus dashboard "Dashboard Test" di workspace javan.

👤 Akun

Saya sedang login sebagai siapa, dan apa role saya di workspace javan?

🧮 Question & Schema

Tool pada kategori ini memerlukan role Admin SOP atau Owner.

Tabel apa saja yang bisa di-query di workspace javan?

Buat question "Jumlah Instance per Proses" di workspace javan
dengan visualisasi bar chart, lalu tampilkan hasilnya.

🗃️ Master Data

Tool Master Data mengacu ke tabel lewat slug. Jika kamu hanya tahu namanya, agent akan memanggil list_masterdata_tables lebih dulu untuk mencari slug. Pembacaan tersedia untuk semua role; menambah dan mengubah baris memerlukan role Admin SOP atau Owner.

Baca baris

Tampilkan semua baris di tabel master data <nama>.

Tambah baris

Tambahkan baris baru ke tabel <slug>: kolom A = ..., kolom B = ...

Ubah satu kolom

Ubah kolom <kolom> di baris <id> tabel <slug> menjadi ...

Alur lengkap

Buat tabel master data <nama> dengan kolom ..., isi 3 baris
contoh, lalu tampilkan hasilnya.

🕘 Riwayat & Pengajuan

Cari pengajuan dengan nomor invoice INV-2026-0042 di workspace javan,
lalu jelaskan sekarang sedang menunggu di langkah mana.

Tampilkan riwayat instance <id> beserta variable-nya,
lalu unduh lampiran yang ada di sana.

💬 Diskusi & Notifikasi

Diskusi mana saja yang punya pesan belum dibaca?

Tampilkan notifikasi yang belum aku baca.

Kirim komentar di diskusi instance <id>: "Dokumen sudah dilengkapi."
Tunjukkan drafnya dulu sebelum dikirim.

📈 Metric & KPI

Tampilkan semua metric di workspace javan,
lalu berapa nilai metric "Waktu Penyelesaian" bulan ini?

Buat metric "Jumlah Pengajuan Selesai" dari question <id>,
lalu buat KPI di atasnya dengan target minimal 100 per bulan.

Ubah target KPI "Kepatuhan SLA" menjadi minimal 95%.

🧾 Log Aktivitas

Kenapa langkah Odoo di instance <id> gagal?
Tampilkan log aktivitas service-nya.

🔁 Flow Lengkap (Multi-step)

Aku ingin mengajukan cuti di workspace javan.
Cari proses pengajuan cuti, tampilkan form-nya,
lalu bantu aku mengisinya.

Di workspace javan, buat struktur org chart baru untuk
divisi Engineering dengan 3 sub-tim:
Backend, Frontend, dan QA. Masing-masing tim tambahkan
deskripsi singkat.

Audit company profile workspace javan — cek field mana
yang masih kosong dan bantu aku mengisinya satu per satu.

Lihat semua task di my-task workspace javan,
lalu prioritaskan mana yang harus diselesaikan hari ini
berdasarkan deadline dan prioritas.