MCP

Apa itu MCP Helpdesk?

AlurKerja Support menyediakan MCP server yang memungkinkan AI agent seperti Claude Code, Claude Desktop, atau ChatGPT untuk membuat dan memantau tiket helpdesk Anda langsung dari percakapan — cukup melalui instruksi natural language, tanpa perlu membuka halaman Support Center.

Server ini di-hosting oleh backend helpdesk sehingga Anda tidak perlu melakukan instalasi maupun menjalankan server sendiri. Anda hanya perlu membuat personal access token satu kali, kemudian menyalinnya ke konfigurasi AI client.

Informasi Koneksi

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 helpdesk masing-masing.

Langkah 1: Membuat Token

1. Masuk (login) ke AlurKerja Support.
2. Buka menu pengguna di pojok kanan atas → API Tokens, atau akses langsung https://support.alurkerja.com/settings/api-tokens.
3. Berikan label (contoh: Claude Desktop — laptop kerja), tentukan masa berlaku (atau No expiry), lalu klik Generate token.
4. Salin token saat ini juga — token memiliki format hlp_xxxxxx... dan hanya ditampilkan satu kali.

Langkah 2: Konfigurasi MCP Client

MCP Helpdesk dapat digunakan pada berbagai AI agent yang mendukung Model Context Protocol. AlurKerja menyediakan panduan konfigurasi untuk Claude Code, Claude Desktop, serta client lain seperti ChatGPT/Perplexity. Pilih metode konfigurasi yang sesuai dengan agent yang Anda gunakan — pada setiap contoh, ganti hlp_YOUR_TOKEN dengan token yang telah Anda buat.

Claude Code — satu perintah

Metode paling cepat. Jalankan satu perintah berikut:

claude mcp add --transport http helpdesk https://support.alurkerja.com/api/mcp \
  --header "Authorization: Bearer hlp_YOUR_TOKEN"

Verifikasi koneksi dengan perintah:

claude mcp list        # "helpdesk" akan menampilkan ✔ Connected

Selanjutnya, Anda dapat menanyakan "Am I logged in to the helpdesk?" kepada Claude — Claude akan memanggil tool helpdesk_whoami.

Claude Code — project-scoped (dibagikan ke tim)

Apabila Anda ingin membagikan konfigurasi kepada seluruh anggota tim, commit file berikut sebagai .mcp.json pada root project. Setiap anggota tim mengisi token miliknya sendiri (jangan meng-commit token asli ke git — gunakan environment variable atau file .mcp.json personal):

{
  "mcpServers": {
    "helpdesk": {
      "type": "http",
      "url": "https://support.alurkerja.com/api/mcp",
      "headers": { "Authorization": "Bearer hlp_YOUR_TOKEN" }
    }
  }
}

Claude Desktop

Claude Desktop mengakses remote server melalui bridge mcp-remote. Buka file claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), tambahkan konfigurasi berikut, kemudian mulai ulang (restart) aplikasi:

{
  "mcpServers": {
    "helpdesk": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://support.alurkerja.com/api/mcp",
        "--header",
        "Authorization: Bearer hlp_YOUR_TOKEN"
      ]
    }
  }
}

ChatGPT / Perplexity / client lain

Client apa pun yang mendukung remote MCP server dengan custom header dapat digunakan. Masukkan konfigurasi berikut pada pengaturan MCP client tersebut:

transport: streamable-http
url:        https://support.alurkerja.com/api/mcp
header:     Authorization: Bearer hlp_YOUR_TOKEN

Daftar MCP Tools

Berikut daftar tools yang tersedia ketika AI agent terhubung ke AlurKerja Support:

Arti status: open = menunggu review, in_progress = sedang dikerjakan, awaiting_confirmation = telah diselesaikan dan menunggu konfirmasi Anda, closed = selesai.

Sample Prompts

Setelah MCP terhubung, Anda dapat langsung menggunakan instruksi natural language di Claude Code / Claude Desktop. Berikut beberapa contoh prompt untuk setiap tool.

Membuat Tiket

Buatkan tiket helpdesk — laptop saya tidak bisa terhubung ke VPN kantor.

Claude akan memanggil helpdesk_submit_ticket, kemudian membalas dengan nomor tiket.

Buatkan tiket dengan subject "Aplikasi error saat login",
kategori Software, prioritas High, dan jelaskan bahwa halaman login
menampilkan blank screen setelah memasukkan kredensial.

Saya butuh akses ke folder Finance di shared drive.
Tolong ajukan tiket permintaan aksesnya.

Melihat Tiket Saya

Tampilkan semua tiket saya yang masih open.

Claude akan memanggil helpdesk_list_my_tickets dengan status: "open".

Tiket saya mana saja yang sedang dikerjakan (in progress)?

Apakah ada tiket saya yang menunggu konfirmasi dari saya?

Cari tiket saya yang berkaitan dengan "VPN".

Tampilkan 10 tiket terakhir saya, termasuk yang sudah closed.

Kategori & Prioritas

Kategori dan prioritas apa saja yang tersedia di helpdesk?

Claude akan memanggil helpdesk_list_categories sebelum Anda membuat tiket dengan field kategori/prioritas.

Sebelum membuat tiket, tampilkan dulu subkategori yang tersedia
untuk kategori Hardware.

Akun

Saya login sebagai akun helpdesk yang mana?

Claude akan memanggil helpdesk_whoami.

Alur Lengkap (Multi-step)

Rekap status semua tiket saya — kelompokkan berdasarkan status,
lalu beri tahu tiket mana yang perlu saya tindak lanjuti.

Mengelola Token

Halaman Settings → API Tokens menampilkan seluruh token Anda beserta detailnya:

Klik Revoke pada token yang tidak lagi digunakan. Client yang masih menggunakan token tersebut akan langsung menerima error autentikasi. Anda cukup membuat token baru dan memperbarui konfigurasi client.

Troubleshooting