Skip to main content
AgencyHandys MCP-forbindelse lader dig tale med Claude eller Cursor på almindeligt sprog og udføre dagligt arbejde i dit AgencyHandy-arbejdsområde — uden at åbne hvert skærmbillede selv. Du bevarer kontrollen. Claude og Cursor handler kun med den API-nøgle til arbejdsområdet, du genererer, og beder dig bekræfte, når et navn matcher mere end én person.

​
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
Behold kommandoen 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.
Hvis Claude eller Cursor ikke kan finde MCP-serveren, skal du bekræfte, at Node.js 20+ er installeret, og at du genstartede appen efter at have gemt konfigurationen.

​
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:
Der er intet at installere og ingen server at holde kørende. Godkend hver forespørgsel med den samme API-nøgle til arbejdsområdet som bearer-token. Arbejdsområdet læses fra nøglen, så hver bruger forbinder med sin egen. Cursor, Claude Code og enhver vært, der sender egne headers:
Claude Desktop kan ikke sende egne headers — brug mcp-remote som bro:
Claude Code fra kommandolinjen:
Adressen er rodstien — https://mcp.agencyhandy.com/, ikke /mcp. Åbn https://mcp.agencyhandy.com/health for at tjekke, at serveren svarer.
Bygger du i stedet din egen integration mod HTTP-API’et? Send en User-Agent-header med dine forespørgsler. Nogle runtimes — heriblandt fetch() i Cloudflare Workers — sender ingen som standard, og forespørgsler uden bliver afvist, før de når API’et.

​
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.

​
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-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.