Skip to main content
AgencyHandy’nin MCP bağlantısı, Claude veya Cursor ile doğal dilde konuşup AgencyHandy çalışma alanındaki günlük işleri çalıştırmanızı sağlar — her ekranı kendiniz açmadan. Kontrol sizde kalır. Claude ve Cursor yalnızca oluşturduğunuz çalışma alanı API anahtarıyla hareket eder ve bir ad birden fazla kişiyle eşleşirse onay ister.
Workspace Config’i açıp API keys yönetebilen bir role ihtiyacınız var (genellikle SuperAdmin veya Admin). Claude Desktop veya Cursor’ın çalıştığı bilgisayarda Node.js 20+ da gerekir.

​
Gereksinimler

npm’deki MCP paketi agencyhandy-mcp’dir. Claude ve Cursor bunu npx -y agencyhandy-mcp@1 ile çalıştırır.

​
Claude veya Cursor MCP’yi kurun

1

Workspace Config’i açın

AgencyHandy’de Workspace Config’i (şirket ayarları) açın, ardından API Key sekmesine gidin.
2

Çalışma alanı API anahtarı oluşturun

Yeni bir çalışma alanı API anahtarı oluşturun (veya kaydettiğiniz birini kullanın). Göründüğünde kopyalayın — AgencyHandy daha sonra tam anahtarı tekrar gösteremez.
3

MCP yapılandırmasını kopyalayın

Aynı API Key sekmesinde Claude / Cursor MCP kurulum panelini kullanın. JSON’un anahtarınızı ve backend URL’sini içermesi için Copy MCP config’e tıklayın.
4

Cursor veya Claude Desktop’a yapıştırın

Yapılandırmayı şuraya yapıştırın:
  • Cursor: proje veya kullanıcı .mcp.json
  • Claude Desktop: claude_desktop_config.json
npx -y agencyhandy-mcp@1 komutunu ve API anahtarını üretildiği gibi bırakın.
5

Yeniden başlatın ve bir istem deneyin

Cursor veya Claude Desktop’ı tamamen kapatıp yeniden açın. Ardından çalışma alanı için sabah brifingi gibi basit bir şey isteyin.
Claude veya Cursor MCP sunucusunu bulamazsa Node.js 20+ kurulu olduğunu ve yapılandırmayı kaydettikten sonra uygulamayı yeniden başlattığınızı doğrulayın.

​
Örnek istemler

Doğal dil kullanın. İş atarken doğru kişiyi seçmek için tam ad veya e-postayı tercih edin.

​
İki kişi aynı adı paylaştığında

Ekipte iki Sara varsa Claude hangisini kastettiğinizi sorar. ID uydurmaz ve sessizce tahmin etmez. Adlar çakışabileceğinde istemde her zaman tam ad veya e-posta ekleyin.

​
Şimdi çalışan vs henüz değil

MCP, API anahtarınızla çalışma alanını okumayı ve eylemleri (oluştur, ata, gönder, güncelle) destekler. Müşteri sohbet yanıtları henüz MCP üzerinden açık değil — bu konuşmalar için AgencyHandy’yi kullanın.

​
İlgili

  • Uygulama içinde Workspace Config → API Key altında anahtar oluşturun ve yapılandırmayı kopyalayın
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.