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.

​
Zwei Wege zur Verbindung

Beide nutzen denselben Workspace-API-Key und geben dem Agenten dieselben Werkzeuge.
Sie brauchen eine Rolle, die Workspace Config öffnen und API keys verwalten kann (in der Regel SuperAdmin oder Admin). Für die lokale Einrichtung benötigen Sie außerdem Node.js 20+ auf dem Rechner, auf dem Claude Desktop oder Cursor läuft — der gehostete Server braucht überhaupt keine Installation.

​
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

Nutzen Sie diesen Weg, wenn Claude Desktop oder Cursor auf Ihrem eigenen Computer läuft. Für einen Agenten in der Cloud springen Sie zu Cloud-Agenten verbinden.
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.

​
Cloud-Agenten verbinden (gehosteter Server)

Wenn Ihr Agent dort läuft, wo Sie kein Paket installieren können — Cloudflare Workers, Vercel-Funktionen, n8n oder ein gehostetes Claude oder Cursor — richten Sie ihn auf den MCP-Server, den wir für Sie betreiben:
Es gibt nichts zu installieren und keinen Server zu betreiben. Authentifizieren Sie jede Anfrage mit demselben Workspace-API-Key als Bearer-Token. Der Workspace wird aus dem Key gelesen, jeder Nutzer verbindet sich also mit seinem eigenen. Cursor, Claude Code und jeder Host, der eigene Header sendet:
Claude Desktop kann keine eigenen Header senden — überbrücken Sie das mit mcp-remote:
Claude Code auf der Kommandozeile:
Die Adresse ist der Root-Pfad — https://mcp.agencyhandy.com/, nicht /mcp. Um zu prüfen, ob der Server erreichbar ist, öffnen Sie https://mcp.agencyhandy.com/health.
Sie bauen stattdessen eine eigene Integration gegen die HTTP-API? Senden Sie einen User-Agent-Header mit Ihren Anfragen. Manche Laufzeitumgebungen — darunter das fetch() von Cloudflare Workers — senden standardmäßig keinen, und Anfragen ohne diesen Header werden abgewiesen, bevor sie die API erreichen.

​
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.
  • Gehosteter Server für Cloud-Agenten: https://mcp.agencyhandy.com/ (Health-Check unter /health)
  • Paket: agencyhandy-mcp auf npm (npx -y agencyhandy-mcp@1)