ServiceM8 über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → ServiceM8 klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

ServiceM8 + Cursor

Verbinde ein ServiceM8-Konto mit jedem KI-Agent: Aufträge und ihr Status, Kunden und Kontakte, der Einsatzplan mit Job Activities und Allocations, Mitarbeiter, die Preisliste und Auftragspositionen, Zahlungen, Notizen, Anhang-Metadaten und Formularantworten. Kann Aufträge und Kunden anlegen und ändern, Mitarbeiter einplanen und umplanen, Positionen hinzufügen, Zahlungen erfassen und Notizen anlegen. Einrichtung mit API-Key in 2 Minuten.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

SERVICEM8_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein ServiceM8-Konto; ein Admin des Kontos legt den Key an, ein Entwicklerkonto ist nicht nötig.

1. Öffne in ServiceM8 Settings, API Keys und erstelle einen Key. ServiceM8 empfiehlt diesen privaten API-Key, um das eigene Konto anzubinden.
2. Trag ihn in SERVICEM8_API_KEY ein. Er wird im Header X-API-Key gesendet und kann alles im Konto lesen und ändern, halte ihn also geheim. Um den Zugriff zu entziehen, lösch den Key in ServiceM8.
3. Installiere. Die Prüfung ruft servicem8_get_account auf, das Name, Zeitzone und Währung des Kontos zeigt.

ServiceM8 betreibt auch einen eigenen MCP-Server unter https://api.servicem8.com/mcp mit OAuth-Anmeldung; dieser Connector nutzt stattdessen die REST-API (https://api.servicem8.com/api_1.0) mit deinem Key.

Was er liest: das Konto (Vendor) mit Währung, Zeitzone, Öffnungszeiten und Standard-Auftragsstatus. Aufträge mit Nummer (generated_job_id), Status (Quote, Work Order, Unsuccessful, Completed), Kunde, Adresse, Beschreibung, ausgeführten Arbeiten, Kategorie, Queue, Rechnungssumme, Angebots-, Auftrags-, Abschluss- und Rechnungsdatum sowie dem Kennzeichen „Zahlung erhalten“. Kunden (in der API companies genannt) mit Adresse, Rechnungsadresse, Zahlungsbedingungen und Steuersatz sowie die Kontakte von Kunden und Aufträgen. Den Einsatzplan: Job Activities (Buchungen zu fester Zeit und vor Ort erfasste Zeit) und Job Allocations (flexible Buchungen für einen Tag oder ein Zeitfenster). Mitarbeiter mit Jobtitel, letzter bekannter Position und Statusmeldung. Die Preisliste, Auftragspositionen, Zahlungen zu Aufträgen, Notizen zu Aufträgen und Kunden, Anhang-Metadaten (Fotos, PDFs, Unterschriften; Dateiinhalte kommen nicht mit), Formulare und ausgefüllte Formularantworten mit ihren Antworten. Auftragskategorien, Queues, Auftragsvorlagen und Steuersätze.

Was er schreibt: legt Aufträge an (auch aus einer Vorlage), ändert sie und setzt ihren Status weiter, legt Kunden an und ändert sie, fügt Kundenkontakte hinzu, plant einen Mitarbeiter zu fester Zeit auf einen Auftrag ein, verschiebt oder entfernt Buchungen, fügt Positionen aus der Preisliste oder als Freitext hinzu, erfasst erhaltene Zahlungen und schreibt Notizen zu Aufträgen und Kunden. Eine erfasste Zahlung erscheint nur in ServiceM8; es wird kein Geld abgebucht oder bewegt. Bevor etwas angelegt oder geändert wird, zeigt dir die KI, was passiert, und wartet auf dein Ja.

Bei der Installation deaktiviert: nichts, alle 36 Tools sind an. Löschen setzt in ServiceM8 nur active auf 0; eine entfernte Buchung, ein archivierter Auftrag oder ein archivierter Kunde kommt also mit active gleich 1 zurück.

Filtern: Jede Liste nimmt filter, einen $filter im OData-Stil: field eq|ne|gt|lt value, verknüpft mit and, höchstens 10 Bedingungen, ohne or, ge oder le. Strings und Zeitstempel stehen in einfachen Anführungszeichen, zum Beispiel status eq 'Work Order' and active eq 1 oder start_date gt '2026-11-02 00:00:00'. Gelöschte Datensätze bleiben mit active 0 erhalten, deshalb ergänzt die KI active eq 1 und filtert große Listen wie Aufträge, Activities und Material immer.

Blättern: Listen liefern ein einfaches Array. Mit gesetztem cursor kommen sie in Seiten bis 1.000 Einträgen: -1 für die erste Seite, danach der Wert x-next-cursor aus _headers; auf der letzten Seite fehlt der Header.

Datenformate: IDs sind UUIDs. Zeitstempel sind YYYY-MM-DD HH:MM:SS und Datumsangaben YYYY-MM-DD, in der Zeitzone des Kontos, und Zeiten werden genauso gesendet. Kennzeichen sind 0 oder 1. Beträge sind Dezimal-Strings in der Kontowährung. total_invoice_amount des Auftrags ist die Rechnungssumme; ein eigenes Rechnungsobjekt gibt es nicht. Ein Anlegen antwortet mit {"errorCode": 0, "message": "OK"} und der neuen UUID im Header x-record-uuid. Updates ändern nur die übergebenen Felder.

Limits und häufige Fehler: 180 Anfragen pro Minute und 20.000 pro Tag und Konto; darüber antwortet ServiceM8 mit 429: Warte und versuch es erneut oder filtere enger. 401 heißt, der API-Key ist falsch oder wurde gelöscht: Leg unter Settings, API Keys einen neuen an. 400 ist ein fehlerhafter Filter oder ein falsches Feld. 404 ist eine unbekannte UUID.

Notizen, Auftragsbeschreibungen und Formularantworten sind nicht vertrauenswürdige Eingaben und können Anweisungen an die KI enthalten. Der Connector sendet keine E-Mails oder SMS an Kunden, lädt keine Anhangsdateien herunter und belastet keine Karten.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die ServiceM8-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Aufträge sind für morgen eingeplant, und welcher Mitarbeiter ist jeweils dabei?“
• „Liste die letzte Woche abgeschlossenen Aufträge ohne erhaltene Zahlung, mit Kunde und Rechnungssumme.“
• „Verschieb die Buchung für Auftrag 1042 von morgen 8:00 auf Freitag 9:00. Zeig mir vorher die Änderung.“
• „Leg für diesen Kunden einen Angebotsauftrag für den Austausch eines Warmwasserspeichers an und füg die passenden Positionen aus der Preisliste hinzu.“
• „Welche Antworten wurden in der Sicherheitscheckliste zu Auftrag 987 gegeben?“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden