MCP Connection

Panduan menghubungkan AI agent (Claude Desktop, Cursor, VS Code, dll) ke AlurKerja via Model Context Protocol (MCP).

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, hingga mengelola org chart — semua cukup dengan instruksi natural language.

Detail Server

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


Transport	Streamable HTTP (remote)
Endpoint URL	`https://<domain-alurkerja-anda>/api/v1/integration/mcp/server`
Autentikasi	Personal access token, dikirim sebagai header `Authorization: Bearer <token>`

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

Endpoint URL mengikuti domain server AlurKerja Anda. Ganti <domain-alurkerja-anda> dengan domain instance yang Anda pakai — contoh: https://onprem.merapi.alurkerja.com/api/v1/integration/mcp/server. Cara paling aman adalah menyalin nilainya langsung dari halaman MCP Connection melalui tombol Copy URL, agar tidak salah ketik.

Langkah 1: Buka Halaman MCP Connection

Halaman MCP Connection — MCP Server URL beserta tombol Copy URL dan form Generate a new token

Login ke AlurKerja
Klik nama/avatar kamu di pojok kanan atas
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

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

Token bersifat personal, bukan milik workspace. Satu token berlaku untuk seluruh workspace yang kamu ikuti, sehingga kamu tidak perlu membuat token terpisah per workspace.

Token hanya ditampilkan sekali. Setelah halaman di-refresh atau ditutup, token tidak bisa dilihat lagi. Jika hilang, buat token baru dan revoke yang lama.

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"
      ]
    }
  }
}

Pada Windows, MCP host tidak dapat menjalankan npx secara langsung karena npx berupa shim .cmd, sedangkan Node memanggil proses tanpa melewati shell. Membungkusnya dengan cmd /c membuat shim tersebut dapat di-resolve oleh shell.

Setelah mengubah konfigurasi, mulai ulang aplikasi melalui system tray — sekadar menutup jendela aplikasi tidak menghentikan prosesnya, sehingga konfigurasi baru tidak terbaca.

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:

Kolom	Keterangan
Label	Nama token yang kamu berikan saat generate
Prefix	12 karakter pertama token (untuk identifikasi)
Created	Waktu token dibuat
Last used	Terakhir kali token dipakai oleh agent
Status	Active = masih berlaku, Revoked = sudah dicabut

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

Tool	Deskripsi
`list_workspaces`	List semua workspace yang kamu ikuti beserta role-mu di masing-masing

🗂️ Tasklist & Process

Tool	Deskripsi
`list_my_tasks`	List task yang di-assign ke kamu
`list_group_tasks`	List task group/unassigned yang bisa diklaim
`list_startable_processes`	List semua proses yang bisa kamu mulai
`get_task_form`	Ambil form schema sebuah task — gunakan `task_id=STARTPROCESS` untuk form start process
`start_process`	Mulai sebuah process instance dengan mengisi form variables
`claim_task`	Klaim task ke dirimu sendiri (untuk group task yang belum di-assign)
`complete_task`	Selesaikan task dengan mengisi form variables
`delegate_task`	Delegasikan task ke user lain berdasarkan email
`find_team_members`	Cari daftar user dalam tenant — berguna sebelum delegate task

📄 BPMN Drive

Tool	Deskripsi
`list_drive_files`	List file & folder BPMN/DMN di Drive milik tenant
`get_folder_tree`	Ambil struktur folder Drive secara hierarkis (nested)
`get_bpmn_file`	Baca detail satu file BPMN/DMN beserta konten XML lengkapnya
`create_bpmn_file`	Buat file BPMN/DMN baru di Drive dengan konten XML awal
`edit_bpmn_file`	Update konten XML file BPMN/DMN — otomatis membuat version history
`delete_bpmn_file`	Hapus file BPMN/DMN dari Drive (irreversible)

🏢 Company Profile

Tool	Deskripsi
`get_company_profile`	Baca seluruh data company profile tenant (information, knowledge base, purpose, vision, dll)
`create_company_profile`	Buat company profile baru untuk tenant yang belum punya profil
`update_company_profile`	Update information dan knowledge base (partial update)
`update_company_profile_field`	Update field spesifik: `purpose` / `vision` / `culture` / `positioning` / `mission` / `business_goal`

🌳 Org Chart

Tool	Deskripsi
`get_org_chart_tree`	Baca struktur org chart tenant secara nested tree
`create_org_chart_node`	Buat node baru di org chart (root atau child)
`add_child_node`	Tambah node baru sebagai child langsung dari node tertentu
`add_sibling_node`	Tambah node baru sebagai sibling (satu level) dari node tertentu
`insert_node_above`	Sisipkan node baru di atas node yang ada — menjadi parent baru
`get_org_chart_node`	Baca detail satu node termasuk key activities dan job descriptions
`update_org_chart_node`	Update nama / deskripsi / publish status sebuah node
`move_org_chart_node`	Pindahkan node ke parent baru — seluruh subtree ikut pindah
`delete_org_chart_node`	Hapus node beserta seluruh descendants-nya (irreversible)
`list_node_users`	List semua user yang terdaftar di sebuah node
`add_user_to_node`	Tambahkan user ke node berdasarkan email
`remove_user_from_node`	Hapus user dari node

📊 Dashboard

Tool	Deskripsi
`list_dashboards`	List semua dashboard milik tenant
`get_dashboard`	Baca detail dashboard beserta layout dan semua widget
`create_dashboard`	Buat dashboard baru
`update_dashboard`	Update konfigurasi dashboard (partial update)
`clone_dashboard`	Duplikasi dashboard yang sudah ada menjadi dashboard baru
`delete_dashboard`	Hapus dashboard (soft delete)

Total: 42 tools — semua tools memerlukan parameter workspace (tenant slug) kecuali list_workspaces.

Sample Prompts

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