AgencyHandy’ni MCP bilan boshqarish uchun Claude va Cursor’ni ulang

AgencyHandy MCP ulanishi Claude yoki Cursor bilan oddiy tilda gaplashib, AgencyHandy ish maydonidagi kundalik ishlarni bajarishga imkon beradi — har bir ekranni o‘zingiz ochmasdan. Nazorat sizda qoladi. Claude va Cursor faqat siz yaratgan ish maydoni API kaliti bilan ishlaydi va ism bir nechta odamga mos kelganda tasdiqlashni so‘raydi.

Ulanishning ikki yo’li

Agentingiz qayerda ishlaydi	Qanday ulanadi	Sozlash
Kompyuteringizda — Claude Desktop yoki Cursor	Ilova ishga tushiradigan `agencyhandy-mcp` paketi	Quyidagi Claude yoki Cursor MCP’sini sozlash — Node.js 20+ kerak
Bulutda — Cloudflare Workers, Vercel, n8n, joylashtirilgan Claude yoki Cursor	`https://mcp.agencyhandy.com/` manzilidagi bizning MCP serverimiz	Quyidagi Bulut agentini ulash — hech narsa o’rnatilmaydi

Ikkalasi ham bir xil ish maydoni API kalitidan foydalanadi va agentga bir xil vositalarni beradi.

Sizga Workspace Config bo’limini ocha oladigan va API keys boshqara oladigan rol kerak (odatda SuperAdmin yoki Admin). Mahalliy sozlash uchun Claude Desktop yoki Cursor ishlaydigan kompyuterda Node.js 20+ ham kerak — joylashtirilgan server esa umuman o’rnatishni talab qilmaydi.

Talablar

Talab	Tafsilotlar
AgencyHandy ish maydoni	Workspace Config → API Key bo’limiga kirish
MCP xosti	Kompyuteringizdagi Claude Desktop yoki Cursor, yoki MCP serverini HTTP orqali chaqira oladigan istalgan agent
Node.js (faqat mahalliy sozlash)	20-versiya yoki undan yangi (`node -v` bilan tekshiring)
MCP paketi (faqat mahalliy sozlash)	`npx -y agencyhandy-mcp@1` (`1` tegi 1.7.2+ beradi)

npm’dagi MCP paketi agencyhandy-mcp. Claude va Cursor uni npx -y agencyhandy-mcp@1 bilan ishga tushiradi.

Claude yoki Cursor MCP’ni sozlash

Claude Desktop yoki Cursor o’z kompyuteringizda ishlayotganda shu yo’ldan foydalaning. Agent bulutda ishlasa, Bulut agentini ulash bo’limiga o’ting.

Workspace Config’ni oching

AgencyHandy’da Workspace Configni (kompaniya sozlamalari) oching, keyin API Key tabiga o‘ting.

Ish maydoni API kalitini yarating

Yangi ish maydoni API kalitini yarating (yoki saqlanganini ishlating). Ko‘rinishi bilan nusxalang — AgencyHandy keyin to‘liq kalitni qayta ko‘rsata olmaydi.

MCP konfiguratsiyasini nusxalang

Xuddi shu API Key tabida Claude / Cursor MCP panelidan foydalaning. JSON kalitingiz va backend URL’ni o‘z ichiga olishi uchun Copy MCP config tugmasini bosing.

Cursor yoki Claude Desktop’ga joylashtiring

Konfiguratsiyani quyidagiga joylashtiring:

Cursor: loyiha yoki foydalanuvchi .mcp.json
Claude Desktop: claude_desktop_config.json

npx -y agencyhandy-mcp@1 buyrug‘i va API kalitini yaratilganidek saqlang.

Qayta ishga tushiring va promptni sinab ko‘ring

Cursor yoki Claude Desktopni to‘liq yoping va qayta oching. Keyin ish maydoni uchun ertalabki brifing kabi oddiy narsa so‘rang.

Agar Claude yoki Cursor MCP serverini topa olmasa, Node.js 20+ o‘rnatilganini va konfiguratsiyani saqlagandan keyin ilovani qayta ishga tushirganingizni tekshiring.

Bulut agentini ulash (joylashtirilgan server)

Agar agentingiz paket o’rnatib bo’lmaydigan joyda ishlasa — Cloudflare Workers, Vercel funksiyalari, n8n yoki joylashtirilgan Claude va Cursor — uni biz siz uchun yuritayotgan MCP serveriga yo’naltiring:

https://mcp.agencyhandy.com/

Hech narsa o’rnatilmaydi va hech qanday serverni ushlab turish kerak emas. Har bir so’rovni o’sha ish maydoni API kaliti bilan bearer token sifatida tasdiqlang. Ish maydoni kalitdan o’qiladi, shuning uchun har bir foydalanuvchi o’zinikida ulanadi. Cursor, Claude Code va maxsus sarlavhalar yuboradigan har qanday xost:

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

Claude Desktop maxsus sarlavhalar yubora olmaydi — mcp-remote orqali ko’prik quring:

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

Buyruqlar satridan Claude Code:

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

Manzil ildiz yo’l — /mcp emas, https://mcp.agencyhandy.com/. Server javob berayotganini tekshirish uchun https://mcp.agencyhandy.com/health sahifasini oching.

Buning o’rniga HTTP API ustida o’z integratsiyangizni qurayapsizmi? So’rovlaringiz bilan birga User-Agent sarlavhasini yuboring. Ba’zi muhitlar — jumladan Cloudflare Workers’ning fetch() funksiyasi — uni sukut bo’yicha yubormaydi va bu sarlavhasiz so’rovlar API’ga yetib bormasdan rad etiladi.

Namuna promptlar

Tabiiy tildan foydalaning. Ish tayinlashda to‘g‘ri odamni tanlash uchun to‘liq ism yoki emailni afzal ko‘ring.

Maqsad	Namuna prompt
Ertalabki brifing	“Menga ertalabki brifing ber: ochiq ticketlar, to‘lanmagan invoice’lar va mijoz kutayotgan takliflar.”
Ticket tayinlash	“Acme bosh sahifa redesign ticketini Jordan Lee’ga (jordan@agency.com) tayinla.”
Invoice yuborish	“INV-1042 invoice’ni mijozga email orqali yubor.”
Lead yaratish	“Bright Studio’dan Nora Patel uchun lead yarat, email nora@brightstudio.com.”
Invoice’ni to‘langan deb belgilash	“INV-1042 invoice’ni paid deb belgilа.”

Ikki kishi bir xil ismga ega bo‘lsa

Jamoada ikkita Sara bo‘lsa, Claude qaysi birini nazarda tutayotganingizni so‘raydi. U ID o‘ylab topmaydi va jimlikda taxmin qilmaydi. Ismlar to‘qnashishi mumkin bo‘lsa, promptda doimo to‘liq ism yoki emailni kiriting.

Hozir ishlaydigan vs hali emas

Hozir ishlaydi	MCP orqali hali yo‘q
Taklif, loyiha, ticket va invoice’lar bo‘yicha brifing va qidiruv	MCP orqali client chatda javob berish
Ticket va boshqa jamoa ishlarini tayinlash	—
Lead yaratish	—
Invoice yuborish va to‘langan deb belgilash	—

MCP API kalitingiz bilan ish maydonini o‘qish va amallar (yaratish, tayinlash, yuborish, yangilash)ni qo‘llab-quvvatlaydi. Mijoz chat javoblari hali MCP orqali ochilmagan — bu suhbatlar uchun AgencyHandy’dan foydalaning.

Bog‘liq

Ilovada Workspace Config → API Key ostida kalit yarating va konfiguratsiyani nusxalang

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.

Bulut agentlari uchun joylashtirilgan server: https://mcp.agencyhandy.com/ (holat tekshiruvi /health)
Paket: npm’dagi agencyhandy-mcp (npx -y agencyhandy-mcp@1)

Boshlash

Ish muhitini sozlash

CRM

Xizmatlar va Buyurtmalar

Takliflar va Hisob-fakturalar

Jamoa va Vazifalar

Shakllar va Fayllar

Hisob va To'lov

To'lovlar

Integratsiyalar

AgencyHandy’ni MCP bilan boshqarish uchun Claude va Cursor’ni ulang

Ulanishning ikki yo’li

Talablar

Claude yoki Cursor MCP’ni sozlash

Bulut agentini ulash (joylashtirilgan server)

Namuna promptlar

Ikki kishi bir xil ismga ega bo‘lsa

Hozir ishlaydigan vs hali emas

Bog‘liq

​Ulanishning ikki yo’li

​Talablar

​Claude yoki Cursor MCP’ni sozlash

​Bulut agentini ulash (joylashtirilgan server)

​Namuna promptlar

​Ikki kishi bir xil ismga ega bo‘lsa

​Hozir ishlaydigan vs hali emas

​Bog‘liq

Ulanishning ikki yo’li

Talablar

Claude yoki Cursor MCP’ni sozlash

Bulut agentini ulash (joylashtirilgan server)

Namuna promptlar

Ikki kishi bir xil ismga ega bo‘lsa

Hozir ishlaydigan vs hali emas

Bog‘liq