Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge ServiceM8 mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
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.
Frag einfach
Beispiel-Prompts für ServiceM8
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 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 + Microsoft Copilot
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.
- Öffne in ServiceM8 Settings, API Keys und erstelle einen Key. ServiceM8 empfiehlt diesen privaten API-Key, um das eigene Konto anzubinden.
- Trag ihn in
SERVICEM8_API_KEYein. Er wird im HeaderX-API-Keygesendet und kann alles im Konto lesen und ändern, halte ihn also geheim. Um den Zugriff zu entziehen, lösch den Key in ServiceM8. - Installiere. Die Prüfung ruft
servicem8_get_accountauf, 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 Microsoft Copilot 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 AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
ServiceM8-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | What it does |
|---|---|
servicem8_get_account | The connected ServiceM8 account (vendor): name, business number, email, currency, time zone, opening hours, default job status and whether… |
servicem8_list_jobs | List jobs: uuid, job number (generated_job_id), status (Quote, Work Order, Unsuccessful, Completed), client (company_uuid), address… |
servicem8_get_job | One job by UUID with status, client, addresses, description, work done, totals, dates and badges |
servicem8_list_clients | List clients (ServiceM8 calls them companies): uuid, name, address parts, billing address, ABN or business number, website, payment terms… |
servicem8_get_client | One client (company) by UUID with address, billing address, payment terms and tax rate |
servicem8_list_client_contacts | Contacts of clients: uuid, company_uuid, first and last name, phone, mobile, email, type (BILLING, JOB, ...), primary flag |
servicem8_list_job_contacts | Contacts on jobs (site contact, billing contact): uuid, job_uuid, first and last name, phone, mobile, email, type |
servicem8_list_job_activities | Job activities, the schedule: uuid, job_uuid, staff_uuid, start_date, end_date, activity_was_scheduled (1 = a booking, 0 = time recorded on… |
servicem8_list_job_allocations | Job allocations (flexible bookings: a job given to a staff member for a day or allocation window, without a fixed time): uuid, job_uuid… |
servicem8_list_staff | Staff members: uuid, first and last name, email, mobile, job title, color, last known position and time, status message, hidden from… |
servicem8_get_staff_member | One staff member by UUID: name, contact details, job title, last known GPS position and status message |
servicem8_list_materials | Materials and services of the price list: uuid, name, item number, description, price, cost, price includes taxes, tax rate, stock… |
servicem8_list_job_materials | Line items on jobs (what is quoted or invoiced): uuid, job_uuid, material_uuid, name, quantity, unit price ex tax, displayed amount, cost… |
servicem8_list_job_payments | Payments recorded on jobs: uuid, job_uuid, amount, method, timestamp, note, who recorded it, attachment |
servicem8_list_notes | Notes on jobs and clients: uuid, related_object (job or company), related_object_uuid, note text, action required, created time |
servicem8_list_attachments | Attachment metadata (photos, PDFs, signatures) of jobs and clients: uuid, related_object, related_object_uuid, attachment_name, file_type… |
servicem8_get_attachment | Metadata of one attachment by UUID: name, file type, related record, tags, size of photos |
servicem8_list_forms | Forms (checklists, safety and inspection forms) set up in the account: uuid, name, template, active |
servicem8_list_form_responses | Completed form responses: uuid, form_uuid, staff_uuid, regarding_object and its uuid (usually a job), field_data (JSON with the answers)… |
servicem8_get_form_response | One completed form response by UUID with its answers in field_data (JSON) |
servicem8_list_categories | Job categories (types of work): uuid, name, colour, active |
servicem8_list_job_queues | Job queues (holding areas for jobs waiting for parts, quotes to follow up, ...): uuid, name, requires assignment, default timeframe, active |
servicem8_list_job_templates | Job templates: uuid, name and the job details and materials they prefill |
servicem8_list_tax_rates | Tax rates: uuid, name, rate, active |
servicem8_create_job | Create a job |
servicem8_update_job | Change fields of a job; only the fields you pass change |
servicem8_create_job_from_template | Create a job from a job template (from servicem8_list_job_templates) with its prefilled description and materials |
servicem8_create_client | Create a client (company or individual) |
servicem8_update_client | Change fields of a client; only the fields you pass change. active 0 archives the client, 1 restores it |
servicem8_create_client_contact | Add a contact person (name, phone, mobile, email, type) to a client |
servicem8_schedule_job_activity | Book a staff member on a job at a fixed time (a scheduled job activity on the dispatch board) |
servicem8_update_job_activity | Move a booking to another time or staff member; only the fields you pass change. active 1 restores a removed booking |
servicem8_remove_job_activity | Remove a booking from the schedule |
servicem8_add_job_material | Add a line item to a job (quote or invoice): from the price list with material_uuid, or free text with name and price |
servicem8_record_job_payment | Record a payment received for a job (cash, card, bank transfer) |
servicem8_add_note | Add a note to a job or a client |
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
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
War dieser Guide hilfreich?