To måder at forbinde på
Begge bruger den samme API-nøgle til arbejdsområdet og giver agenten de samme værktøjer.
Du skal have en rolle, der kan åbne Workspace Config og administrere API keys (typisk SuperAdmin eller Admin). Til den lokale opsætning skal du desuden have Node.js 20+ på den maskine, hvor Claude Desktop eller Cursor kører — den hostede server kræver ingen installation overhovedet.
Krav
MCP-pakken på npm er
agencyhandy-mcp. Claude og Cursor kører den med npx -y agencyhandy-mcp@1.
Konfigurer Claude eller Cursor MCP
Brug denne vej, når Claude Desktop eller Cursor kører på din egen computer. Kører agenten i skyen, så spring videre til Forbind en cloud-agent.1
Åbn Workspace Config
I AgencyHandy skal du åbne Workspace Config (virksomhedsindstillinger) og gå til fanen API Key.
2
Generér en API-nøgle til arbejdsområdet
Opret en ny API-nøgle til arbejdsområdet (eller brug en gemt). Kopiér nøglen, når den vises — AgencyHandy kan ikke vise den fulde nøgle igen senere.
3
Kopiér MCP-konfigurationen
På samme fane API Key skal du bruge Claude / Cursor MCP-panelet. Klik på Copy MCP config, så JSON indeholder din nøgle og backend-URL.
4
Indsæt i Cursor eller Claude Desktop
Indsæt konfigurationen i:
- Cursor: projekt- eller bruger-
.mcp.json - Claude Desktop:
claude_desktop_config.json
npx -y agencyhandy-mcp@1 og din API-nøgle som genereret.5
Genstart og prøv en prompt
Afslut helt og åbn Cursor eller Claude Desktop igen. Bed derefter om noget enkelt, f.eks. en morgenbriefing for arbejdsområdet.
Forbind en cloud-agent (hostet server)
Hvis din agent kører et sted, hvor du ikke kan installere en pakke — Cloudflare Workers, Vercel-funktioner, n8n eller en hostet Claude eller Cursor — så peg den mod den MCP-server, vi driver for dig:mcp-remote som bro:
Adressen er rodstien —
https://mcp.agencyhandy.com/, ikke /mcp. Åbn https://mcp.agencyhandy.com/health for at tjekke, at serveren svarer.Eksempelprompts
Brug naturligt sprog. Foretræk fulde navne eller e-mails, når du tildeler arbejde, så den rigtige person vælges.Når to personer har samme navn
Hvis to teammedlemmer hedder Sara, spørger Claude, hvem du mener. Den opfinder ikke ID’er og gætter ikke i stilhed. Medtag altid et fuldt navn eller en e-mail i prompten, når navne kan kollidere.Klientkreditter, visninger af ordreformularer og klientfirmaer
Leveret iagencyhandy-mcp@1.17.0. Det er også disse værktøjer, Handy, assistenten i appen, bruger.
Eksempler på prompts
- „Fratræk 2 timers marketingarbejde fra Elizabeths kreditter til 120 kreditter i timen.“
- „Giv Acme 360 kreditter hver måned den 1., fyldt op til 360.“
- „Hvilke ordreformularer har ingen åbnet?“
- „Tilføj partneren til klientfirmaerne Apple og Samsung.“
I Handy venter tilføjelse og fratræk af kreditter samt opsætning af månedlige kreditter altid på din godkendelse, og kun en Super Admin eller Admin kan godkende. Kreditændringer kan ikke fortrydes fra chatten; Handy tilbyder i stedet at foretage den modsatte justering.
Hvad der virker nu vs endnu ikke
MCP understøtter læsning af dit arbejdsområde og handlinger (opret, tildel, send, opdater) med din API-nøgle. Svar i klientchat er endnu ikke tilgængelige via MCP — brug AgencyHandy til de samtaler.
Relateret
- Generér nøgler og kopiér konfigurationen i appen under Workspace Config → API Key
- Hostet server til cloud-agenter:
https://mcp.agencyhandy.com/(helbredstjek på/health) - Pakke:
agencyhandy-mcppå npm (npx -y agencyhandy-mcp@1)
Latest package on the
1 tag is 1.17.0. 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.
