Skip to main content
AgencyHandys MCP-anslutning låter dig prata med Claude eller Cursor på vardagsspråk och utföra vardagsarbete i din AgencyHandy-arbetsyta — utan att öppna varje skärm själv. Du behåller kontrollen. Claude och Cursor agerar bara med det API-nyckel för arbetsytan som du skapar, och ber dig bekräfta när ett namn matchar mer än en person.
Du behöver en roll som kan öppna Workspace Config och hantera API keys (vanligtvis SuperAdmin eller Admin). Du behöver också Node.js 20+ på datorn där Claude Desktop eller Cursor körs.

​
Krav

MCP-paketet på npm är agencyhandy-mcp. Claude och Cursor kör det med npx -y agencyhandy-mcp@1.

​
Konfigurera Claude eller Cursor MCP

1

Öppna Workspace Config

I AgencyHandy, öppna Workspace Config (företagsinställningar) och gå till fliken API Key.
2

Generera en API-nyckel för arbetsytan

Skapa en ny API-nyckel för arbetsytan (eller använd en sparad). Kopiera nyckeln när den visas — AgencyHandy kan inte visa hela nyckeln igen senare.
3

Kopiera MCP-konfigurationen

På samma flik API Key, använd Claude / Cursor MCP-panelen. Klicka på Copy MCP config så att JSON inkluderar nyckel och backend-URL.
4

Klistra in i Cursor eller Claude Desktop

Klistra in konfigurationen i:
  • Cursor: projekt- eller användar-.mcp.json
  • Claude Desktop: claude_desktop_config.json
Behåll kommandot npx -y agencyhandy-mcp@1 och din API-nyckel som genererats.
5

Starta om och testa en prompt

Avsluta helt och öppna Cursor eller Claude Desktop igen. Be sedan om något enkelt, till exempel en morgonbriefing för arbetsytan.
Om Claude eller Cursor inte hittar MCP-servern, bekräfta att Node.js 20+ är installerat och att du startat om appen efter att ha sparat konfigurationen.

​
Exempelpromptar

Använd naturligt språk. Föredra fullständiga namn eller e-post när du tilldelar arbete så att rätt person väljs.

​
När två personer delar samma namn

Om två teammedlemmar heter Sara frågar Claude vilken du menar. Den hittar inte på ID:n och gissar inte tyst. Inkludera alltid ett fullständigt namn eller en e-postadress i prompten när namn kan krocka.

​
Vad som fungerar nu vs ännu inte

MCP stöder läsning av arbetsytan och åtgärder (skapa, tilldela, skicka, uppdatera) med din API-nyckel. Svar i klientchatten är ännu inte tillgängliga via MCP — använd AgencyHandy för de samtalen.

​
Relaterat

  • Generera nycklar och kopiera konfigurationen i appen under 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.