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.

​
Twee manieren om te verbinden

Beide gebruiken dezelfde workspace-API-sleutel en geven de agent dezelfde tools.
Je hebt een rol nodig die Workspace Config kan openen en API keys kan beheren (meestal SuperAdmin of Admin). Voor de lokale installatie heb je ook Node.js 20+ nodig op de machine waar Claude Desktop of Cursor draait — de gehoste server vereist helemaal geen installatie.

​
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

Gebruik dit wanneer Claude Desktop of Cursor op je eigen computer draait. Draait je agent in de cloud, ga dan door naar Een cloudagent verbinden.
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.

​
Een cloudagent verbinden (gehoste server)

Draait je agent ergens waar je geen pakket kunt installeren — Cloudflare Workers, Vercel-functies, n8n, of een gehoste Claude of Cursor — richt hem dan op de MCP-server die wij voor je draaien:
Er valt niets te installeren en geen server te onderhouden. Authenticeer elk verzoek met dezelfde workspace-API-sleutel als bearer token. De workspace wordt uit de sleutel gelezen, dus iedere gebruiker verbindt met zijn eigen sleutel. Cursor, Claude Code en elke host die eigen headers verstuurt:
Claude Desktop kan geen eigen headers versturen — overbrug dit met mcp-remote:
Claude Code vanaf de opdrachtregel:
Het adres is het hoofdpad — https://mcp.agencyhandy.com/, niet /mcp. Open https://mcp.agencyhandy.com/health om te controleren of de server bereikbaar is.
Bouw je in plaats daarvan je eigen integratie op de HTTP-API? Stuur dan een User-Agent-header mee met je verzoeken. Sommige runtimes — waaronder de fetch() van Cloudflare Workers — sturen er standaard geen, en verzoeken zonder header worden geweigerd voordat ze de API bereiken.

​
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
  • Gehoste server voor cloudagenten: https://mcp.agencyhandy.com/ (health-check op /health)
  • 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.