Skip to main content
Conexiunea MCP AgencyHandy vă permite să vorbiți cu Claude sau Cursor în limbaj natural și să rulați munca zilnică în workspace-ul AgencyHandy — fără să deschideți fiecare ecran singuri. Păstrați controlul. Claude și Cursor acționează doar cu cheia API a workspace-ului pe care o generați și cer confirmare când un nume corespunde mai multor persoane.
Aveți nevoie de un rol care poate deschide Workspace Config și gestiona API keys (de obicei SuperAdmin sau Admin). Aveți nevoie și de Node.js 20+ pe computerul unde rulează Claude Desktop sau Cursor.

​
Cerințe

Pachetul MCP pe npm este agencyhandy-mcp. Claude și Cursor îl rulează cu npx -y agencyhandy-mcp@1.

​
Configurare Claude sau Cursor MCP

1

Deschide Workspace Config

În AgencyHandy, deschideți Workspace Config (setările companiei), apoi fila API Key.
2

Generează o cheie API a workspace-ului

Creați o cheie API nouă a workspace-ului (sau folosiți una salvată). Copiați cheia când apare — AgencyHandy nu va putea afișa din nou cheia completă ulterior.
3

Copiază configurația MCP

În aceeași filă API Key, folosiți panoul Claude / Cursor MCP. Faceți clic pe Copy MCP config ca JSON-ul să includă cheia și URL-ul backend.
4

Lipește în Cursor sau Claude Desktop

Lipiți configurația în:
  • Cursor: proiect sau utilizator .mcp.json
  • Claude Desktop: claude_desktop_config.json
Păstrați comanda npx -y agencyhandy-mcp@1 și cheia API așa cum au fost generate.
5

Repornește și încearcă un prompt

Închideți complet și redeschideți Cursor sau Claude Desktop. Apoi cereți ceva simplu, de exemplu un briefing de dimineață pentru workspace.
Dacă Claude sau Cursor nu găsesc serverul MCP, confirmați că Node.js 20+ este instalat și că ați repornit aplicația după salvarea configurației.

​
Exemple de prompturi

Folosiți limbaj natural. Preferă nume complete sau e-mailuri când atribuiți muncă, ca să fie selectată persoana potrivită.

​
Când două persoane au același nume

Dacă două colege se numesc Sara, Claude întreabă pe care o intenționați. Nu inventează ID-uri și nu ghicește în tăcere. Includeți întotdeauna un nume complet sau un e-mail în prompt când numele se pot ciocni.

​
Ce funcționează acum vs încă nu

MCP permite citirea workspace-ului și acțiuni (creare, atribuire, trimitere, actualizare) cu cheia API. Răspunsurile din chat-ul client nu sunt încă expuse prin MCP — folosiți AgencyHandy pentru acele conversații.

​
Conexe

  • Generați chei și copiați configurația în aplicație la 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.