Skip to main content
Die MCP-Verbindung von AgencyHandy lässt Sie mit Claude oder Cursor in Alltagssprache sprechen und alltägliche Arbeit in Ihrem AgencyHandy-Workspace ausführen — ohne jeden Bildschirm selbst zu öffnen. Sie behalten die Kontrolle. Claude und Cursor handeln nur mit dem Workspace-API-Schlüssel, den Sie erzeugen, und fragen nach, wenn ein Name zu mehr als einer Person passt.
Sie brauchen eine Rolle, die Workspace Config öffnen und API keys verwalten kann (typisch SuperAdmin oder Admin). Außerdem brauchen Sie Node.js 20+ auf dem Computer, auf dem Claude Desktop oder Cursor läuft.

​
Voraussetzungen

Das MCP-Paket auf npm heißt agencyhandy-mcp. Claude und Cursor starten es mit npx -y agencyhandy-mcp@1.

​
Claude oder Cursor MCP einrichten

1

Workspace Config öffnen

Öffnen Sie in AgencyHandy Workspace Config (Unternehmenseinstellungen) und gehen Sie zum Tab API Key.
2

Workspace-API-Schlüssel erzeugen

Erstellen Sie einen neuen Workspace-API-Schlüssel (oder nutzen Sie einen bereits gespeicherten). Kopieren Sie den Schlüssel, wenn er erscheint — AgencyHandy kann den vollständigen Schlüssel später nicht erneut anzeigen.
3

MCP-Konfiguration kopieren

Nutzen Sie auf demselben Tab API Key das Claude-/Cursor-MCP-Setup. Klicken Sie auf Copy MCP config, damit JSON Schlüssel und Backend-URL enthält.
4

In Cursor oder Claude Desktop einfügen

Fügen Sie die Konfiguration ein in:
  • Cursor: Projekt- oder Benutzer-.mcp.json
  • Claude Desktop: claude_desktop_config.json
Behalten Sie den Befehl npx -y agencyhandy-mcp@1 und Ihren API-Schlüssel wie erzeugt.
5

Neu starten und Prompt testen

Beenden Sie Cursor oder Claude Desktop vollständig und öffnen Sie die App erneut. Fragen Sie dann etwas Einfaches, z. B. ein Morgen-Briefing für Ihren Workspace.
Wenn Claude oder Cursor den MCP-Server nicht finden, prüfen Sie Node.js 20+ und starten Sie die App nach dem Speichern der Konfiguration neu.

​
Beispiel-Prompts

Nutzen Sie natürliche Sprache. Bevorzugen Sie vollständige Namen oder E-Mails beim Zuweisen, damit die richtige Person gewählt wird.

​
Wenn zwei Personen denselben Namen haben

Wenn zwei Teammitglieder Sara heißen, fragt Claude nach, wen Sie meinen. Es erfindet keine IDs und rät nicht stillschweigend. Nehmen Sie immer einen vollständigen Namen oder eine E-Mail in den Prompt auf, wenn Namen kollidieren könnten.

​
Was jetzt funktioniert vs. noch nicht

MCP unterstützt das Lesen Ihres Workspaces und Aktionen (erstellen, zuweisen, senden, aktualisieren) mit Ihrem API-Schlüssel. Client-Chat-Antworten sind über MCP noch nicht verfügbar — nutzen Sie dafür AgencyHandy.

​
Verwandte Themen

  • Schlüssel erzeugen und Konfiguration in der App unter Workspace Config → API Key kopieren
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.