Skip to main content
AgencyHandys MCP-tilkobling lar deg snakke med Claude eller Cursor på vanlig språk og utføre daglig arbeid i AgencyHandy-arbeidsområdet — uten å åpne hver skjerm selv. Du beholder kontrollen. Claude og Cursor handler bare med API-nøkkelen for arbeidsområdet du genererer, og ber deg bekrefte når et navn matcher mer enn én person.
Du trenger en rolle som kan åpne Workspace Config og administrere API keys (vanligvis SuperAdmin eller Admin). Du trenger også Node.js 20+ på datamaskinen der Claude Desktop eller Cursor kjører.

​
Krav

MCP-pakken på npm er agencyhandy-mcp. Claude og Cursor kjører den med npx -y agencyhandy-mcp@1.

​
Sett opp Claude eller Cursor MCP

1

Åpne Workspace Config

I AgencyHandy, åpne Workspace Config (bedriftsinnstillinger) og gå til fanen API Key.
2

Generer en API-nøkkel for arbeidsområdet

Opprett en ny API-nøkkel for arbeidsområdet (eller bruk en lagret). Kopier nøkkelen når den vises — AgencyHandy kan ikke vise hele nøkkelen igjen senere.
3

Kopier MCP-konfigurasjonen

På samme fane API Key, bruk Claude / Cursor MCP-panelet. Klikk Copy MCP config slik at JSON inkluderer nøkkel og backend-URL.
4

Lim inn i Cursor eller Claude Desktop

Lim inn konfigurasjonen i:
  • Cursor: prosjekt- eller bruker-.mcp.json
  • Claude Desktop: claude_desktop_config.json
Behold kommandoen npx -y agencyhandy-mcp@1 og API-nøkkelen som generert.
5

Start på nytt og prøv en prompt

Avslutt helt og åpne Cursor eller Claude Desktop på nytt. Be deretter om noe enkelt, for eksempel en morgenbriefing for arbeidsområdet.
Hvis Claude eller Cursor ikke finner MCP-serveren, bekreft at Node.js 20+ er installert og at du startet appen på nytt etter lagring av konfigurasjonen.

​
Eksempelprompter

Bruk naturlig språk. Foretrekk fulle navn eller e-poster når du tildeler arbeid, slik at riktig person velges.

​
Når to personer har samme navn

Hvis to teammedlemmer heter Sara, spør Claude hvem du mener. Den finner ikke på ID-er og gjetter ikke i stillhet. Ta alltid med et fullt navn eller en e-post i prompten når navn kan kollidere.

​
Hva som fungerer nå vs ennå ikke

MCP støtter lesing av arbeidsområdet og handlinger (opprette, tildele, sende, oppdatere) med API-nøkkelen. Svar i klientchat er ikke eksponert via MCP ennå — bruk AgencyHandy for de samtalene.

​
Relatert

  • Generer nøkler og kopier konfigurasjonen i appen under Workspace Config → API Key
  • Pakke: agencyhandy-mcp på npm (npx -y agencyhandy-mcp@1)
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.