Skip to main content
Koneksi MCP AgencyHandy memungkinkan Anda berbicara dengan Claude atau Cursor dalam bahasa alami dan menjalankan pekerjaan harian di workspace AgencyHandy — tanpa membuka setiap layar sendiri. Anda tetap memegang kendali. Claude dan Cursor hanya bertindak dengan kunci API workspace yang Anda buat, dan meminta konfirmasi saat nama cocok dengan lebih dari satu orang.
Anda memerlukan peran yang dapat membuka Workspace Config dan mengelola API keys (biasanya SuperAdmin atau Admin). Anda juga memerlukan Node.js 20+ di komputer tempat Claude Desktop atau Cursor berjalan.

​
Persyaratan

Paket MCP di npm adalah agencyhandy-mcp. Claude dan Cursor menjalankannya dengan npx -y agencyhandy-mcp@1.

​
Siapkan Claude atau Cursor MCP

1

Buka Workspace Config

Di AgencyHandy, buka Workspace Config (pengaturan perusahaan), lalu buka tab API Key.
2

Buat kunci API workspace

Buat kunci API workspace baru (atau gunakan yang sudah disimpan). Salin kunci saat muncul — AgencyHandy tidak dapat menampilkan kunci lengkap lagi nanti.
3

Salin konfigurasi MCP

Di tab API Key yang sama, gunakan panel setup Claude / Cursor MCP. Klik Copy MCP config agar JSON menyertakan kunci dan URL backend Anda.
4

Tempel ke Cursor atau Claude Desktop

Tempel konfigurasi ke:
  • Cursor: proyek atau pengguna .mcp.json
  • Claude Desktop: claude_desktop_config.json
Pertahankan perintah npx -y agencyhandy-mcp@1 dan kunci API seperti yang dihasilkan.
5

Mulai ulang dan coba prompt

Keluar sepenuhnya lalu buka lagi Cursor atau Claude Desktop. Kemudian minta sesuatu yang sederhana, misalnya briefing pagi untuk workspace.
Jika Claude atau Cursor tidak menemukan server MCP, pastikan Node.js 20+ terpasang dan Anda memulai ulang aplikasi setelah menyimpan konfigurasi.

​
Contoh prompt

Gunakan bahasa alami. Utamakan nama lengkap atau email saat menugaskan pekerjaan agar orang yang tepat dipilih.

​
Ketika dua orang memiliki nama yang sama

Jika dua rekan bernama Sara, Claude akan menanyakan yang mana yang Anda maksud. Ia tidak membuat ID dan tidak menebak diam-diam. Selalu sertakan nama lengkap atau email dalam prompt ketika nama mungkin bertabrakan.

​
Yang berfungsi sekarang vs belum

MCP mendukung membaca workspace dan tindakan (buat, tugaskan, kirim, perbarui) dengan kunci API Anda. Balasan chat klien belum diekspos melalui MCP — gunakan AgencyHandy untuk percakapan tersebut.

​
Terkait

  • Buat kunci dan salin konfigurasi di aplikasi pada Workspace Config → API Key
Latest package on the 1 tag is 1.7.2+. Claude can read ah://api-context (also inside ah://full-context) for API path gotchas: leads, projects/orders, tasks, comments, labels, clients, invoices, vouchers, and forms.