Hubungkan Claude dan Cursor untuk menjalankan AgencyHandy dengan MCP

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.

Dua cara menghubungkan

Tempat agen Anda berjalan	Cara menghubungkan	Penyiapan
Di komputer Anda — Claude Desktop atau Cursor	Paket `agencyhandy-mcp` yang dijalankan aplikasi	Menyiapkan MCP Claude atau Cursor di bawah — butuh Node.js 20+
Di cloud — Cloudflare Workers, Vercel, n8n, Claude atau Cursor terkelola	Server MCP terkelola kami di `https://mcp.agencyhandy.com/`	Menghubungkan agen cloud di bawah — tidak ada yang perlu dipasang

Keduanya memakai kunci API ruang kerja yang sama dan memberi agen perangkat yang sama.

Anda memerlukan peran yang bisa membuka Workspace Config dan mengelola API keys (biasanya SuperAdmin atau Admin). Untuk penyiapan lokal, Anda juga butuh Node.js 20+ di komputer tempat Claude Desktop atau Cursor berjalan — server terkelola sama sekali tidak perlu dipasang.

Persyaratan

Persyaratan	Detail
Ruang kerja AgencyHandy	Akses ke Workspace Config → API Key
Host MCP	Claude Desktop atau Cursor di komputer Anda, atau agen apa pun yang bisa memanggil server MCP lewat HTTP
Node.js (hanya penyiapan lokal)	Versi 20 atau lebih baru (cek dengan `node -v`)
Paket MCP (hanya penyiapan lokal)	`npx -y agencyhandy-mcp@1` (tag `1` memuat 1.7.2+)

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

Siapkan Claude atau Cursor MCP

Pakai cara ini bila Claude Desktop atau Cursor berjalan di komputer Anda sendiri. Bila agen berjalan di cloud, lompat ke Menghubungkan agen cloud.

Buka Workspace Config

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

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.

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.

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.

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.

Menghubungkan agen cloud (server terkelola)

Bila agen Anda berjalan di tempat yang tidak memungkinkan pemasangan paket — Cloudflare Workers, fungsi Vercel, n8n, atau Claude maupun Cursor terkelola — arahkan saja ke server MCP yang kami jalankan untuk Anda:

https://mcp.agencyhandy.com/

Tidak ada yang perlu dipasang dan tidak ada server yang harus dijaga. Autentikasi setiap permintaan dengan kunci API ruang kerja yang sama sebagai bearer token. Ruang kerja dibaca dari kunci itu, jadi setiap pengguna terhubung dengan kuncinya sendiri. Cursor, Claude Code, dan host mana pun yang bisa mengirim header kustom:

{
  "mcpServers": {
    "agency-handy": {
      "url": "https://mcp.agencyhandy.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop tidak bisa mengirim header kustom, jadi jembatani dengan mcp-remote:

{
  "mcpServers": {
    "agency-handy": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.agencyhandy.com/",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code dari baris perintah:

claude mcp add agency-handy --transport http https://mcp.agencyhandy.com/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Alamatnya adalah jalur root — https://mcp.agencyhandy.com/, bukan /mcp. Untuk memastikan server dapat dijangkau, buka https://mcp.agencyhandy.com/health.

Sedang membangun integrasi sendiri di atas API HTTP? Kirimkan header User-Agent bersama permintaan Anda. Sebagian runtime — termasuk fetch() di Cloudflare Workers — tidak mengirimnya secara bawaan, dan permintaan tanpa header itu ditolak sebelum sampai ke API.

Contoh prompt

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

Tujuan	Contoh prompt
Briefing pagi	“Berikan briefing pagi: tiket terbuka, invoice belum dibayar, dan proposal menunggu klien.”
Tugaskan tiket	“Tugaskan tiket redesign homepage Acme ke Jordan Lee (jordan@agency.com).”
Kirim invoice	“Kirim invoice INV-1042 ke klien melalui email.”
Buat lead	“Buat lead untuk Nora Patel di Bright Studio, email nora@brightstudio.com.”
Tandai invoice sebagai dibayar	“Tandai invoice INV-1042 sebagai paid.”

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

Berfungsi sekarang	Belum tersedia dari MCP
Briefing dan pencarian proposal, proyek, tiket, dan invoice	Membalas di client chat dari MCP
Menugaskan tiket dan pekerjaan tim lainnya	—
Membuat lead	—
Mengirim invoice dan menandai sebagai dibayar	—

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.

Server terkelola untuk agen cloud: https://mcp.agencyhandy.com/ (cek kondisi di /health)
Paket: agencyhandy-mcp di npm (npx -y agencyhandy-mcp@1)

Mulai

Pengaturan Ruang Kerja

CRM

Layanan & Pesanan

Proposal & Faktur

Tim & Tugas

Formulir & Berkas

Akun & Tagihan

Pembayaran

Integrasi

Hubungkan Claude dan Cursor untuk menjalankan AgencyHandy dengan MCP

Dua cara menghubungkan

Persyaratan

Siapkan Claude atau Cursor MCP

Menghubungkan agen cloud (server terkelola)

Contoh prompt

Ketika dua orang memiliki nama yang sama

Yang berfungsi sekarang vs belum

Terkait

​Dua cara menghubungkan

​Persyaratan

​Siapkan Claude atau Cursor MCP

​Menghubungkan agen cloud (server terkelola)

​Contoh prompt

​Ketika dua orang memiliki nama yang sama

​Yang berfungsi sekarang vs belum

​Terkait

Dua cara menghubungkan

Persyaratan

Siapkan Claude atau Cursor MCP

Menghubungkan agen cloud (server terkelola)

Contoh prompt

Ketika dua orang memiliki nama yang sama

Yang berfungsi sekarang vs belum

Terkait