Zyles MCP-Server

Der Zyles MCP-Server (Model Context Protocol) stellt die Backend-API als Werkzeuge bereit, die KI-Clients wie Claude, Claude Code oder Cursor direkt aufrufen können. Statt Endpunkte selbst aufzurufen, verbinden Sie Claude einmalig mit Zyles und formulieren Ihre Anliegen in normaler Sprache:

„Leg mir alle Leads aus dieser Liste an und starte den Power-Dialer."

Der Server hält keine eigenen Daten: Er leitet jeden Aufruf an die Backend-API weiter — dieselben Ressourcen (Leads, Agents, Power-Dialer …) und dieselben Berechtigungen wie über HTTP. Validierung, Projekt-Scoping und Tarif-Grenzen erzwingt weiterhin das Backend.

Endpunkt

Umgebung	URL	Transport
Produktion	https://mcp.zyles.ai/mcp	Streamable HTTP

Der Server nutzt den Streamable-HTTP-Transport (kein stdio). Die Pfade /sse und / sind nicht belegt — verwenden Sie immer /mcp.

Loslegen

Die Einrichtung dauert etwa zwei Minuten:

→ MCP zu Claude hinzufügen

Authentifizierung

Es gibt zwei Wege:

• OAuth 2.1 — Anmeldung mit Ihren normalen Zyles-Zugangsdaten im Browser. Der Client zeigt dafür eine Verbinden-Schaltfläche (claude.ai, Claude Desktop, Claude Code). Die Verbindung deckt alle Projekte Ihres Kontos ab.

• Projekt-scoped API-Key als Bearer-Token im Authorization-Header — für Clients ohne Anmelde-Schaltfläche und für Automatisierungen:

  Authorization: Bearer <ihr_zyles_api_schlüssel>

Ohne gültige Anmeldung antwortet der Server mit 401 Unauthorized. Wie bei der HTTP-API bestimmt das Token das aktive Projekt; jeder Zugriff ist auf dessen project_id beschränkt (siehe Authentifizierung).

Eigener Schlüssel pro Person

Geben Sie jedem Nutzer einen eigenen projekt-scoped Schlüssel, statt einen zu teilen. Der Schlüssel bestimmt, welchen Workspace die Person über den MCP lesen und ändern kann.

Mehrere Projekte

Wenn Sie sich über den OAuth-Flow verbinden, deckt die Verbindung alle Projekte Ihres Kontos ab. workspaces_list listet sie auf (inkl. Default-Projekt). Jedes Werkzeug nimmt optional project_id entgegen: geben Sie es an, um auf ein bestimmtes Projekt zu wirken — ohne wird das Default-Projekt verwendet. Die Auswahl gilt pro Aufruf (der Server ist zustandslos). Ein projekt-scoped API-Key ist dagegen fest an ein Projekt gebunden; project_id wird dann ignoriert.

Immer nur ein Projekt pro Aufruf

Es ist stets genau ein Token aktiv. Zyles gibt Anmeldedaten eines Projekts niemals bei einer Anfrage an ein anderes Projekt mit — eine Verwechslung von Mandanten ist ausgeschlossen.

Was Claude damit tun kann

Bereich	Möglichkeiten
Leads	anlegen (auch als Stapel), suchen, filtern, lesen, aktualisieren, archivieren
Smart Views	anlegen, ändern, löschen und zu passenden Leads auflösen
Power-Dialer	Kampagnen anlegen, starten, pausieren, planen und löschen
KI-Agenten	anlegen, konfigurieren, auslesen, löschen
Aktivitäten	Timeline lesen, Notizen und Anrufe erfassen
Lead-Status	Statuswerte des Projekts verwalten
Anrufergebnisse	Ergebnistypen pflegen und Aktivitäten zuordnen
Eigene Aktivitäten	benutzerdefinierte Aktivitätstypen und -einträge verwalten

Die vollständige Liste aller 42 Werkzeuge mit dem jeweils aufgerufenen Backend-Endpunkt steht in der Werkzeug-Referenz.

Was nicht geht

Leads werden nie hart gelöscht — leads_update mit archived: true archiviert, false stellt wieder her. E-Mail-Aktivitäten und Massenimporte sind derzeit nicht als Werkzeug verfügbar.

Voraussetzungen

• Ein Zyles-Konto mit API-Zugriff (Entitlement open_api). Fehlt er, antwortet bereits der erste Werkzeugaufruf mit 403.
• Ein MCP-fähiger Client — z. B. Claude (Web, Desktop oder Code).

Einzelne Aktionen sind zusätzlich an Ihren Tarif gebunden:

Aktion	Werkzeug	Voraussetzung
KI-Agent anlegen	agents_create	Kontingent ai_assistants
Dialer anlegen	power_dialers_create	CampaignPlanning
Dialer starten	power_dialers_set_status → running	OutboundCalls

Greift eine Sperre, reicht der MCP-Server die 403-Antwort des Backends unverändert durch — Claude zeigt Ihnen also die exakte Meldung an, statt den Aufruf stillschweigend zu verschlucken.

Verbindung prüfen

Nach der Einrichtung bestätigt das Werkzeug zyles_whoami, dass der Server erreichbar und authentifiziert ist, und zeigt das Projekt und den Nutzer an, auf die das Token verweist.

Sicherheit

• Jede Anfrage trägt ihr eigenes Token; der Server hält keinen Sitzungsstatus.
• Tokens werden nie protokolliert und nie an den Aufrufer zurückgegeben.
• Der Server prüft Rechte nicht selbst nach, sondern reicht jede Anfrage projektgebunden ans Backend weiter. Claude kann damit nie mehr als Sie selbst mit Ihrem Zyles-Login.
• Sie können den Zugriff jederzeit widerrufen, indem Sie den Connector im Client entfernen oder den API-Key in Zyles zurückziehen.