Skip to main content
De MCP-verbinding van AgencyHandy laat je in gewone taal met Claude of Cursor praten en dagelijks werk in je AgencyHandy-werkruimte uitvoeren — zonder elk scherm zelf te openen. Jij blijft de baas. Claude en Cursor handelen alleen met de workspace-API-sleutel die je genereert, en vragen bevestiging als een naam bij meer dan één persoon past.
Je hebt een rol nodig die Workspace Config kan openen en API keys kan beheren (meestal SuperAdmin of Admin). Je hebt ook Node.js 20+ nodig op de computer waar Claude Desktop of Cursor draait.

​
Vereisten

Het MCP-pakket op npm is agencyhandy-mcp. Claude en Cursor starten het met npx -y agencyhandy-mcp@1.

​
Claude of Cursor MCP instellen

1

Workspace Config openen

Open in AgencyHandy Workspace Config (bedrijfsinstellingen) en ga naar het tabblad API Key.
2

Een workspace-API-sleutel genereren

Maak een nieuwe workspace-API-sleutel (of gebruik een opgeslagen sleutel). Kopieer de sleutel wanneer die verschijnt — AgencyHandy kan de volledige sleutel later niet opnieuw tonen.
3

MCP-config kopiëren

Gebruik op hetzelfde tabblad API Key het Claude / Cursor MCP-setuppaneel. Klik op Copy MCP config zodat de JSON je sleutel en backend-URL bevat.
4

Plakken in Cursor of Claude Desktop

Plak de config in:
  • Cursor: project- of gebruikers-.mcp.json
  • Claude Desktop: claude_desktop_config.json
Bewaar het commando npx -y agencyhandy-mcp@1 en je API-sleutel zoals gegenereerd.
5

Herstarten en een prompt proberen

Sluit Cursor of Claude Desktop volledig af en open opnieuw. Vraag daarna iets eenvoudigs, zoals een ochtendbriefing voor je werkruimte.
Als Claude of Cursor de MCP-server niet vindt, controleer Node.js 20+ en herstart de app nadat je de config hebt opgeslagen.

​
Voorbeeldprompts

Gebruik natuurlijke taal. Geef bij toewijzingen bij voorkeur volledige namen of e-mails zodat de juiste persoon wordt gekozen.

​
Wanneer twee personen dezelfde naam hebben

Als twee teamleden Sara heten, vraagt Claude wie je bedoelt. Het verzint geen ID’s en raadt niet in stilte. Neem altijd een volledige naam of e-mail op in de prompt wanneer namen kunnen botsen.

​
Wat nu werkt vs nog niet

MCP ondersteunt het lezen van je werkruimte en acties (aanmaken, toewijzen, versturen, bijwerken) met je API-sleutel. Antwoorden in clientchat zijn via MCP nog niet beschikbaar — gebruik AgencyHandy voor die gesprekken.

​
Gerelateerd

  • Genereer sleutels en kopieer de config in de app onder Workspace Config → API Key
  • Pakket: agencyhandy-mcp op 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.