Serveur MCP

Meistron

            app.meistron/meistron
        

Entreprise et opérations Finance et investissement Public et accessible MCP 2026-07-28

Ce que fait ce MCP

Manages trades-business customers, jobs, employees, materials, inventory, work times, offers, invoices, payments, and maintenance contracts.

angebot_anlegen

Angebot anlegen

Legt einen ANGEBOTS-Entwurf an. Ein Angebot ist noch keine Rechnung: Es fordert kein Geld und wird nicht gebucht. Verschickt NICHTS an den Kunden. Wird ein Auftrag angegeben, übernimmt das Angebot dessen noch nicht abgerechnetes Material und erfasste Arbeitszeit als Positionen — sofern der Betrieb die Bereiche „Material" und „Zeiterfassung" für den KI-Zugang nicht abgeschaltet hat; die Antwort sagt, was übernommen wurde. Zusätzlich oder stattdessen können eigene Positionen angegeben werden. Betreff und Belegkopf kommen ebenfalls aus dem Auftrag: Ohne Angabe wird der Auftragstitel zum Betreff, und Auftragsnummer, Objekt und Leistungstag/-zeitraum werden übernommen wie mit dem Knopf „Aus Auftrag & Projekt übernehmen" — gedruckt werden nur die Kopffelder, die der Betrieb unter Rechnungen → Einstellungen gewählt hat; die Kundennummer kommt aus dem Kundenstamm. Ist am Auftrag ein Nettopreis hinterlegt, nennt die Antwort die Abweichung der Positionen dazu. Die Umwandlung eines Angebots in eine Rechnung geschieht in Meistron und ist über diesen Zugang NICHT möglich.

Schéma d’entrée

{'type': 'object', 'properties': {'betreff': {'type': 'string', 'maxLength': 120, 'description': 'Betreff des Angebots, eine Zeile unter der Belegnummer (z. B. „Heizungswartung Reihenhaus"). Ohne Angabe wird der Titel des Auftrags übernommen.'}, 'hinweis': {'type': 'string', 'description': 'Text für den Kunden auf dem Angebot.'}, 'kunde_id': {'type': 'string', 'description': 'Die Kennung des Kunden. Ohne Angabe wird der Kunde des Auftrags übernommen.'}, 'belegkopf': {'type': 'object', 'properties': {'leistung_bis': {'type': 'string', 'description': 'Ende des Leistungszeitraums, JJJJ-MM-TT.'}, 'leistung_von': {'type': 'string', 'description': 'Leistungstag oder Beginn, JJJJ-MM-TT.'}, 'objektnummer': {'type': 'string', 'maxLength': 60, 'description': 'Objekt- oder Projektnummer. Vorgabe: die Nummer des Projekts am Auftrag.'}, 'objektadresse': {'type': 'string', 'maxLength': 200, 'description': 'Bezeichnung des Objekts, z. B. „Wohnanlage Süd, Haus 3". Vorgabe: Projektname, sonst Ort des Auftrags.'}, 'auftragsnummer': {'type': 'string', 'maxLength': 60, 'description': 'Auftragsnummer(n) auf dem Beleg, mehrere durch Komma. Vorgabe: die des Auftrags.'}, 'kundenreferenz': {'type': 'string', 'maxLength': 60, 'description': 'Bestell- oder Vorgangsnummer des Kunden („Ihre Nr."), z. B. PO-4711.'}, 'leistung_modus': {'enum': ['keine', 'tag', 'zeitraum'], 'type': 'string', 'description': '`tag` druckt einen Leistungstag (`leistung_von`), `zeitraum` eine Spanne (`leistung_von` bis `leistung_bis`), `keine` druckt nichts. Ohne Angabe ergibt sich der Modus aus den Daten bzw. aus dem Termin des Auftrags.'}, 'leistungsempfaenger': {'type': 'string', 'maxLength': 200, 'description': 'Wer die Leistung erhalten hat, wenn nicht der Rechnungsempfänger — etwa der Mieter.'}}, 'description': 'Angaben rechts oben im Belegkopf. Ohne Angabe werden Auftragsnummer, Objekt und Leistungszeitraum aus dem Auftrag übernommen (siehe `belegkopf_aus_auftrag`); jede Angabe hier gewinnt je Feld. Gedruckt wird NUR, was der Betrieb unter Rechnungen → Einstellungen „Angaben im Belegkopf" gewählt hat — die Antwort sagt, welche Angaben deshalb nicht auf dem Beleg stehen. Die Kundennummer lässt sich hier nicht setzen; sie kommt aus dem Kundenstamm.', 'additionalProperties': False}, 'auftrag_id': {'type': 'string', 'description': 'Auftrag, dessen Material und Arbeitszeit übernommen werden sollen — und aus dem Betreff und Belegkopf gefüllt werden.'}, 'positionen': {'type': 'array', 'items': {'type': 'object', 'required': ['beschreibung', 'menge', 'einzelpreis'], 'properties': {'menge': {'type': 'number'}, 'einheit': {'type': 'string'}, 'einzelpreis': {'type': 'number', 'description': 'Netto, ohne Steuer.'}, 'beschreibung': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Eigene Positionen. Höchstens 50.'}, 'steuersatz': {'type': 'number', 'description': 'Steuersatz für den GESAMTEN Beleg in Prozent — 19, 7 oder 0. Ohne Angabe der im Betrieb hinterlegte Satz. Ein Beleg trägt genau EINEN Satz, im Kopf wie in jeder Position; gemischte Sätze lehnt Meistron beim Finalisieren ab. Wer beides braucht, legt zwei Belege an.'}, 'ohne_zeiten': {'type': 'boolean', 'description': 'Nur Material übernehmen, keine Stunden.'}, 'ohne_material': {'type': 'boolean', 'description': 'Nur Stunden übernehmen, kein Material.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}, 'belegkopf_aus_auftrag': {'type': 'boolean', 'description': 'Vorgabe true: übernimmt Auftragsnummer, Objektnummer, Objektadresse und Leistungstag/-zeitraum aus dem Auftrag — wie der Knopf „Aus Auftrag & Projekt übernehmen" in Meistron. Auf false setzen, wenn der Belegkopf ausschließlich aus `belegkopf` kommen soll.'}}, 'additionalProperties': False}

angebote_suchen

Angebote suchen

Listet Angebote mit Nummer, Kunde, Betrag und Status. Zeigt auch, welche bereits in eine Rechnung umgewandelt wurden — und welche offen liegen.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {'bis': {'type': 'string', 'description': 'Spätestes Datum, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Frühestes Datum, JJJJ-MM-TT.'}, 'anzahl': {'type': 'number', 'description': 'Höchstens so viele (Vorgabe 25, Grenze 100).'}, 'nur_offen': {'type': 'boolean', 'description': 'Nur noch nicht umgewandelte Angebote.'}}, 'additionalProperties': False}

auftraege_suchen

Aufträge suchen

Listet Aufträge eines Zeitraums — etwa einer Woche — mit Titel, Termin, Status, Ort und Kunde. Ohne Zeitraum werden die nächsten anstehenden Termine gezeigt. Mit `suche` findet es einen Auftrag über Teil der Auftragsnummer oder des Titels — dann auch vergangene —, mit `kunde_id` die Aufträge eines Kunden. Die Kennung eines Treffers ist die Eingabe für `auftrag_ansehen` und `rechnung_anlegen`.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {'bis': {'type': 'string', 'description': 'Spätester Termin, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Frühester Termin, JJJJ-MM-TT.'}, 'suche': {'type': 'string', 'maxLength': 60, 'description': 'Teil der Auftragsnummer oder des Titels, z. B. „0118" oder „Heizung". Ohne Zeitraum werden dann auch vergangene Aufträge gefunden, nicht nur anstehende.'}, 'anzahl': {'type': 'number', 'description': 'Höchstens so viele (Vorgabe 25, Grenze 100).'}, 'status': {'enum': ['scheduled', 'in_progress', 'documented', 'completed', 'canceled'], 'type': 'string', 'description': 'Nur Aufträge in diesem Status.'}, 'kunde_id': {'type': 'string', 'description': 'Nur Aufträge dieses Kunden — die Kennung aus `kunden_suchen`.'}, 'nur_unterminiert': {'type': 'boolean', 'description': 'Nur Aufträge ohne Termin — die, die noch eingeplant werden müssen.'}}, 'additionalProperties': False}

auftrag_aendern

Auftrag ändern

Ändert Titel, Beschreibung, Ort oder Termin eines bestehenden Auftrags. Nur die angegebenen Felder werden angefasst. Ändert NICHT den Status. Bei einer echten Terminverschiebung können die zugewiesenen Mitarbeiter eine Push-Meldung erhalten, wenn der Betrieb die Aussenwirkung erlaubt hat; dem Kunden wird nichts geschickt.

Accès externe Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['auftrag_id'], 'properties': {'ort': {'type': 'string'}, 'endet': {'type': 'string', 'description': 'Neues Termin-Ende, JJJJ-MM-TTTHH:MM.'}, 'titel': {'type': 'string'}, 'beginnt': {'type': 'string', 'description': 'Neuer Termin-Beginn, JJJJ-MM-TTTHH:MM.'}, 'auftrag_id': {'type': 'string', 'description': 'Die Kennung des Auftrags.'}, 'beschreibung': {'type': 'string'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}}, 'additionalProperties': False}

auftrag_anlegen

Auftrag anlegen

Legt einen neuen Auftrag an — mit Titel, optional Beschreibung, Termin, Ort und Kunde. JEDER Auftrag braucht mindestens eine zuständige Person: ohne Angabe wird der Inhaber selbst zugewiesen. Ob die Zugewiesenen eine Benachrichtigung auf ihr Gerät bekommen, hängt davon ab, ob der Betrieb die Aussenwirkung freigegeben hat — in der Vorgabe ist sie AUS. Die Antwort sagt jedes Mal, was tatsächlich hinausging. Legt KEINE Rechnung an und schreibt dem Kunden nichts.

Accès externe

Schéma d’entrée

{'type': 'object', 'required': ['titel'], 'properties': {'ort': {'type': 'string', 'description': 'Einsatzort als Text.'}, 'endet': {'type': 'string', 'description': 'Termin-Ende, JJJJ-MM-TTTHH:MM. Nur zusammen mit `beginnt`.'}, 'titel': {'type': 'string', 'description': 'Kurzer Titel, worum es geht.'}, 'beginnt': {'type': 'string', 'description': 'Termin-Beginn, JJJJ-MM-TTTHH:MM (Ortszeit).'}, 'kunde_id': {'type': 'string', 'description': 'Kennung eines bestehenden Kunden.'}, 'mitarbeiter': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Kennungen der zuständigen Personen (siehe mitarbeiter_auflisten). Ohne Angabe wird der Inhaber selbst zugewiesen.'}, 'beschreibung': {'type': 'string', 'description': 'Was zu tun ist.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}}, 'additionalProperties': False}

auftrag_ansehen

Auftrag ansehen

Zeigt einen einzelnen Auftrag ausführlich: Beschreibung, Termin, Ort, Kunde, Projekt, Vor-Ort-Kontakt (nur der Name), zugewiesene Mitarbeiter, zugewiesenes Material mit Abrechnungsstand und noch nicht abgerechnete Stunden (sofern die Bereiche „Material" bzw. „Zeiterfassung" freigegeben sind), Zahl der Fotos, bei Storno den Grund — und die zugehörigen Rechnungen sowie den am Auftrag hinterlegten Nettopreis, sofern der Bereich „Rechnungen" für den KI-Zugang freigegeben ist. Der übliche Blick, BEVOR aus dem Auftrag eine Rechnung entsteht: Material und Stunden zeigen, was `rechnung_anlegen` übernehmen würde.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['auftrag_id'], 'properties': {'auftrag_id': {'type': 'string', 'description': 'Die Kennung des Auftrags.'}}, 'additionalProperties': False}

betrieb_ueberblick

Überblick über den Betrieb

Nennt die aktuellen Eckdaten: wie viele Aufträge offen und wie viele terminiert sind, wie viele Rechnungen unbezahlt und davon überfällig, und die Summe der offenen Posten — als RESTBETRAG, Teilzahlungen sind also bereits abgezogen. Guter erster Aufruf, um zu verstehen, worum es gerade geht.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {}, 'additionalProperties': False}

datei_anfordern

Datei anfordern

Fordert eine Datei vom Menschen an und gibt einen Link zurück, über den er sie in Meistron hochlädt. Für Preisdateien von Lieferanten (DATANORM), PDFs, Belege und Fotos. Die Anforderung selbst verarbeitet noch nichts. Nach dem späteren Upload wird eine DATANORM-Datei automatisch geprüft und als Importvorschau vorbereitet; Einkaufspreise oder Artikel werden dabei NICHT angewendet. Das Anwenden startet ein Mensch danach in Meistron. Belege werden nur abgelegt, Bilder können dem genannten Auftrag als Foto zugeordnet werden. Eine Datei lässt sich NICHT durch den Chat schicken — auch nicht als Text oder Base64. Das ist keine Einschränkung, sondern Absicht: Bei einer Preisdatei mit zehntausenden Artikeln zählt jedes Zeichen, und ein durchgereichter Text verliert oder erfindet welche. Den Link dem Menschen zeigen. Er muss in Meistron angemeldet sein — ohne Anmeldung führt der Link nirgendwohin. Danach mit „datei_stand" nachsehen, ob sie da ist.

Schéma d’entrée

{'type': 'object', 'required': ['zweck'], 'properties': {'zweck': {'enum': ['datanorm', 'dokument', 'beleg', 'bild'], 'type': 'string', 'description': 'datanorm = Preisdatei eines Lieferanten · dokument = PDF (Ausschreibung, Plan) · beleg = Eingangsrechnung oder Quittung · bild = Foto.'}, 'hinweis': {'type': 'string', 'description': 'Was genau gebraucht wird — steht dem Menschen auf der Upload-Seite.'}, 'lieferant_id': {'type': 'string', 'description': 'PFLICHT bei zweck=datanorm: von welchem Lieferanten die Preisdatei kommt. Ohne gültige Kennung wird keine Anforderung angelegt. „lieferanten_auflisten" nennt die Kennungen.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}, 'gehoert_zu_auftrag': {'type': 'string', 'description': 'Kennung des Auftrags, zu dem die Datei gehört. Der Vermerk am Auftrag wird gesetzt; eine Ansicht, die dort abgelegte Dateien anzeigt, gibt es zurzeit noch nicht — nur ein Bild (zweck=bild) erscheint sichtbar in den Fotos des Auftrags. Sag dem Nutzer nichts anderes zu.'}}, 'additionalProperties': False}

datei_stand

Stand der angeforderten Dateien

Zeigt, welche Dateien angefordert wurden und welche davon angekommen sind. Nach „datei_anfordern" hiermit nachsehen, statt zu raten — und NICHT in kurzen Abständen wiederholt aufrufen: Der Mensch braucht einen Moment.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {}, 'additionalProperties': False}

einstellungen_aendern

Einstellungen ändern

Ändert eine Firmen- oder Rechnungsvorgabe. Wirkt auf ALLE künftigen Rechnungen und Angebote, nicht auf bestehende. NICHT änderbar, auch nicht mit Freigabe: Bankverbindung, Steuernummer, USt-IdNr., Rechnungs- und Angebotsnummern samt Präfixen, Steuerberater-Anbindung. Ebenso wenig die Schalter, die die Arbeitsweise umstellen (Bestandsführung, E-Rechnung, öffentliche Buchung). Wer danach gefragt wird, verweist auf Meistron. Vorher „einstellungen_ansehen" aufrufen, um den heutigen Wert zu kennen.

Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['feld', 'wert'], 'properties': {'feld': {'type': 'string', 'description': 'Was geändert werden soll, z. B. default_payment_terms, default_hourly_rate, phone, closing_name. „einstellungen_ansehen" nennt die möglichen Namen.'}, 'wert': {'type': ['string', 'number', 'boolean'], 'description': 'Der neue Wert. Bei Ja/Nein-Feldern true oder false.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}}, 'additionalProperties': False}

einstellungen_ansehen

Einstellungen ansehen

Zeigt die Firmendaten und die Vorgaben für Rechnungen und Angebote — Zahlungsziel, Steuersatz, Stundensatz, Textbausteine. Nützlich, um zu erklären, warum eine Rechnung aussieht, wie sie aussieht. Bankverbindung, Steuernummern und Nummernkreise werden NICHT gezeigt.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {}, 'additionalProperties': False}

kunde_anlegen

Kunde anlegen

Legt einen neuen Kunden an. Name genügt; Firma und Anschrift sind optional. Die Kundennummer vergibt Meistron selbst; die Antwort nennt sie. Gibt es genau einen gleichnamigen Kunden, werden nur die zusätzlich angegebenen Firma-, Anschrift- oder Kontaktdaten an diesem Kunden ergänzt bzw. aktualisiert; es wird KEIN zweiter angelegt. Bei mehreren gleichnamigen Kunden erfolgt KEINE Änderung. E-Mail, Festnetz und Mobilnummer werden NUR gespeichert, wenn der Inhaber für genau diesen KI-Zugang „Vollzugriff und Vollautonomie" bestätigt hat. Im normalen Modus bleiben diese Kontaktdaten gesperrt. Bei zusätzlich aktivem autonomen E-Mail-Kanal darf die so gespeicherte Adresse für den strikt gebundenen Rechnungsversand verwendet werden.

Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['name'], 'properties': {'ort': {'type': 'string'}, 'plz': {'type': 'string'}, 'name': {'type': 'string', 'description': 'Name der Person oder des Betriebs.'}, 'email': {'type': 'string', 'pattern': '^[^\\s@]+@[^\\s@]+\\.[^\\s@]{2,}$', 'maxLength': 254, 'description': 'E-Mail-Adresse des Kunden. Nur mit serverseitig aktiver Vollautonomie für diesen Zugang.'}, 'firma': {'type': 'string', 'description': 'Firmenname, falls abweichend.'}, 'mobil': {'type': 'string', 'pattern': '^\\+?[0-9 ()/.-]{3,30}$', 'maxLength': 30, 'description': 'Mobilnummer. Nur mit serverseitig aktiver Vollautonomie für diesen Zugang.'}, 'strasse': {'type': 'string'}, 'telefon': {'type': 'string', 'pattern': '^\\+?[0-9 ()/.-]{3,30}$', 'maxLength': 30, 'description': 'Festnetznummer. Nur mit serverseitig aktiver Vollautonomie für diesen Zugang.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}}, 'additionalProperties': False}

kunden_suchen

Kunden suchen

Findet Kunden des Betriebs nach Name, Firma oder Ort und nennt ihre Kennung. Diese Kennung verlangen `rechnung_anlegen`, `angebot_anlegen` und `auftrag_anlegen`. ZUERST SUCHEN, DANN ANLEGEN. Wer stattdessen `kunde_anlegen` benutzt, weil er den vorhandenen Eintrag nicht findet, erzeugt eine Dublette — zwei Karteien zum selben Kunden, mit getrennter Rechnungshistorie. Gibt bewusst KEINE Kontaktdaten heraus: Kennung, Kundennummer, Name, Ort und ob eine E-Mail-Adresse hinterlegt ist. Zum Versenden braucht es die Adresse nicht — den Empfänger löst der Server selbst aus dem Kundenstamm auf.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {'suche': {'type': 'string', 'description': 'Teil des Namens, der Firma oder des Ortes. Ohne Angabe die zuletzt angelegten.'}, 'anzahl': {'type': 'number', 'description': 'Höchstens so viele (Vorgabe 25, Grenze 100).'}}, 'additionalProperties': False}

lieferanten_auflisten

Lieferanten und Preisstände

Nennt die hinterlegten Lieferanten und wann zuletzt Preise von ihnen eingelesen wurden (DATANORM). Beantwortet die Frage, ob die Einkaufspreise im Katalog noch aktuell sind. Ein Preis-Import selbst geht NICHT über diesen Zugang — dafür braucht es eine Datei, die in Meistron hochgeladen wird.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {}, 'additionalProperties': False}

material_ansehen

Material ansehen

Zeigt einen Katalogartikel mit Preis, Bestand, Lagerort und den letzten Bestandsbewegungen — also woher der aktuelle Bestand kommt.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['material_id'], 'properties': {'material_id': {'type': 'string', 'description': 'Die Kennung des Artikels.'}}, 'additionalProperties': False}

material_buchen

Bestand buchen

Bucht eine Bestandsbewegung auf einem Katalogartikel: Zugang (Einkauf), Abgang (Entnahme ohne Auftrag) oder Inventur (Korrektur auf einen gezählten Ist-Bestand). Jede Buchung wird dauerhaft protokolliert und lässt sich NICHT löschen — ein Fehler wird durch eine Gegenbuchung berichtigt, nicht durch Rückgängigmachen. Für Material, das auf einen Auftrag geht, ist „material_zuweisen" richtig: Das verbindet den Verbrauch mit dem Auftrag und macht ihn abrechenbar.

Destructif

Schéma d’entrée

{'type': 'object', 'required': ['material_id', 'art', 'menge'], 'properties': {'art': {'enum': ['zugang', 'abgang', 'inventur'], 'type': 'string', 'description': 'zugang = Ware kommt herein · abgang = Ware geht ohne Auftrag heraus · inventur = der gezählte Ist-Bestand, NICHT die Differenz.'}, 'menge': {'type': 'number', 'description': 'Bei Zugang und Abgang die bewegte Menge (immer positiv). Bei Inventur der gezählte Bestand — die Differenz errechnet das System selbst.'}, 'notiz': {'type': 'string', 'description': 'Grund der Buchung, z. B. Lieferschein-Nummer.'}, 'material_id': {'type': 'string', 'description': 'Die Kennung des Artikels.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}}, 'additionalProperties': False}

material_suchen

Material suchen

Durchsucht den Materialkatalog nach Bezeichnung oder Artikelnummer und nennt Preis, Einheit und Lagerbestand. Mit `nur_knapp` die Artikel, die unter ihrem Mindestbestand liegen — der übliche Einstieg vor einer Bestellung.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {'suche': {'type': 'string', 'description': 'Teil der Bezeichnung oder Artikelnummer.'}, 'anzahl': {'type': 'number', 'description': 'Höchstens so viele (Vorgabe 25, Grenze 100).'}, 'nur_knapp': {'type': 'boolean', 'description': 'Nur Artikel unter dem hinterlegten Mindestbestand.'}, 'nur_werkzeug': {'type': 'boolean', 'description': 'Nur Werkzeuge statt Verbrauchsmaterial.'}}, 'additionalProperties': False}

material_zuweisen

Material einem Auftrag zuweisen

Bucht Material oder Werkzeug auf einen Auftrag. Der Bestand wird sofort abgezogen und der Verbrauch dem Auftrag zugeordnet — dadurch kann er später in eine Rechnung übernommen werden. Reicht der Bestand nicht, wird abgelehnt statt ins Minus gebucht. Legt KEINE Rechnung an.

Destructif

Schéma d’entrée

{'type': 'object', 'required': ['auftrag_id', 'material_id', 'menge'], 'properties': {'menge': {'type': 'number', 'description': 'Wie viel auf den Auftrag geht (positiv).'}, 'notiz': {'type': 'string', 'description': 'Optionaler Vermerk zur Zuweisung.'}, 'auftrag_id': {'type': 'string', 'description': 'Die Kennung des Auftrags.'}, 'material_id': {'type': 'string', 'description': 'Die Kennung des Artikels aus dem Katalog.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}}, 'additionalProperties': False}

mitarbeiter_auflisten

Mitarbeiter auflisten

Nennt die Personen, denen ein Auftrag zugewiesen werden kann, mit Namen und Kennung. Vor dem Anlegen eines Auftrags aufrufen, wenn nicht klar ist, wer zuständig sein soll.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {}, 'additionalProperties': False}

rechnung_anlegen

Rechnung anlegen

Legt einen Rechnungs-ENTWURF an. Ein Entwurf hat noch KEINE Rechnungsnummer und ist in Meistron änderbar — die Nummer wird erst beim Versenden vergeben, damit der Nummernkreis lückenlos bleibt. Verschickt NICHTS an den Kunden. Wird ein Auftrag angegeben, übernimmt der Entwurf dessen noch nicht abgerechnetes Material und erfasste Arbeitszeit als Positionen — das ist der übliche Weg, sofern der Betrieb die Bereiche „Material" und „Zeiterfassung" für den KI-Zugang nicht abgeschaltet hat; die Antwort sagt, was übernommen wurde. Zusätzlich oder stattdessen können eigene Positionen angegeben werden. Betreff und Belegkopf kommen ebenfalls aus dem Auftrag: Ohne Angabe wird der Auftragstitel zum Betreff, und Auftragsnummer, Objekt und Leistungstag/-zeitraum werden übernommen wie mit dem Knopf „Aus Auftrag & Projekt übernehmen" — gedruckt werden nur die Kopffelder, die der Betrieb unter Rechnungen → Einstellungen gewählt hat; die Kundennummer kommt aus dem Kundenstamm. Ist am Auftrag ein Nettopreis hinterlegt, nennt die Antwort, um wie viel die Positionen darunter oder darüber liegen.

Schéma d’entrée

{'type': 'object', 'properties': {'betreff': {'type': 'string', 'maxLength': 120, 'description': 'Betreff der Rechnung, eine Zeile unter der Belegnummer (z. B. „Heizungswartung Reihenhaus"). Ohne Angabe wird der Titel des Auftrags übernommen.'}, 'hinweis': {'type': 'string', 'description': 'Text für den Kunden auf der Rechnung.'}, 'kunde_id': {'type': 'string', 'description': 'Die Kennung des Kunden. Ohne Angabe wird der Kunde des Auftrags übernommen.'}, 'belegkopf': {'type': 'object', 'properties': {'leistung_bis': {'type': 'string', 'description': 'Ende des Leistungszeitraums, JJJJ-MM-TT.'}, 'leistung_von': {'type': 'string', 'description': 'Leistungstag oder Beginn, JJJJ-MM-TT.'}, 'objektnummer': {'type': 'string', 'maxLength': 60, 'description': 'Objekt- oder Projektnummer. Vorgabe: die Nummer des Projekts am Auftrag.'}, 'objektadresse': {'type': 'string', 'maxLength': 200, 'description': 'Bezeichnung des Objekts, z. B. „Wohnanlage Süd, Haus 3". Vorgabe: Projektname, sonst Ort des Auftrags.'}, 'auftragsnummer': {'type': 'string', 'maxLength': 60, 'description': 'Auftragsnummer(n) auf dem Beleg, mehrere durch Komma. Vorgabe: die des Auftrags.'}, 'kundenreferenz': {'type': 'string', 'maxLength': 60, 'description': 'Bestell- oder Vorgangsnummer des Kunden („Ihre Nr."), z. B. PO-4711.'}, 'leistung_modus': {'enum': ['keine', 'tag', 'zeitraum'], 'type': 'string', 'description': '`tag` druckt einen Leistungstag (`leistung_von`), `zeitraum` eine Spanne (`leistung_von` bis `leistung_bis`), `keine` druckt nichts. Ohne Angabe ergibt sich der Modus aus den Daten bzw. aus dem Termin des Auftrags.'}, 'leistungsempfaenger': {'type': 'string', 'maxLength': 200, 'description': 'Wer die Leistung erhalten hat, wenn nicht der Rechnungsempfänger — etwa der Mieter.'}}, 'description': 'Angaben rechts oben im Belegkopf. Ohne Angabe werden Auftragsnummer, Objekt und Leistungszeitraum aus dem Auftrag übernommen (siehe `belegkopf_aus_auftrag`); jede Angabe hier gewinnt je Feld. Gedruckt wird NUR, was der Betrieb unter Rechnungen → Einstellungen „Angaben im Belegkopf" gewählt hat — die Antwort sagt, welche Angaben deshalb nicht auf dem Beleg stehen. Die Kundennummer lässt sich hier nicht setzen; sie kommt aus dem Kundenstamm.', 'additionalProperties': False}, 'auftrag_id': {'type': 'string', 'description': 'Auftrag, dessen Material und Arbeitszeit übernommen werden sollen — und aus dem Betreff und Belegkopf gefüllt werden.'}, 'positionen': {'type': 'array', 'items': {'type': 'object', 'required': ['beschreibung', 'menge', 'einzelpreis'], 'properties': {'menge': {'type': 'number'}, 'einheit': {'type': 'string'}, 'einzelpreis': {'type': 'number', 'description': 'Netto, ohne Steuer.'}, 'beschreibung': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Eigene Positionen. Höchstens 50.'}, 'steuersatz': {'type': 'number', 'description': 'Steuersatz für den GESAMTEN Beleg in Prozent — 19, 7 oder 0. Ohne Angabe der im Betrieb hinterlegte Satz. Ein Beleg trägt genau EINEN Satz, im Kopf wie in jeder Position; gemischte Sätze lehnt Meistron beim Finalisieren ab. Wer beides braucht, legt zwei Belege an.'}, 'ohne_zeiten': {'type': 'boolean', 'description': 'Auf true setzen, wenn NUR das Material übernommen werden soll, keine Stunden.'}, 'ohne_material': {'type': 'boolean', 'description': 'Auf true setzen, wenn NUR die Stunden übernommen werden sollen.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}, 'belegkopf_aus_auftrag': {'type': 'boolean', 'description': 'Vorgabe true: übernimmt Auftragsnummer, Objektnummer, Objektadresse und Leistungstag/-zeitraum aus dem Auftrag — wie der Knopf „Aus Auftrag & Projekt übernehmen" in Meistron. Auf false setzen, wenn der Belegkopf ausschließlich aus `belegkopf` kommen soll.'}}, 'additionalProperties': False}

rechnung_ansehen

Rechnung ansehen

Zeigt eine einzelne Rechnung vollständig: Betreff, Belegkopf (Auftrags-, Kunden-, Objektnummer, Leistungstag oder -zeitraum), alle Positionen mit Menge, Einheit und Preis, Beträge, Steuer, Rabatt, Zahlungsstand mit Restbetrag bei Teilzahlungen, Mahnstufe und eine etwaige Mahnpause, ob ein festgeschriebenes Original-PDF vorliegt, bei Storno den Grund, Projekt und den zugehörigen Auftrag. Damit lässt sich prüfen, WAS auf der Rechnung steht — nicht nur, wie viel.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['rechnung_id'], 'properties': {'rechnung_id': {'type': 'string', 'description': 'Die Kennung der Rechnung.'}}, 'additionalProperties': False}

rechnungen_suchen

Rechnungen suchen

Listet Rechnungen mit Nummer, Kunde, Betrag, Status, Fälligkeit und dem noch offenen Restbetrag — bei Teilzahlungen steht der Rest neben dem Rechnungsbetrag und die Zeile ist als teilbezahlt gekennzeichnet. Mit `nur_offen` die unbezahlten (Restbetrag über null), sortiert nach Alter der Überfälligkeit — das ist der übliche Einstieg für offene Posten. Mit `suche` findet es eine Rechnung über Teil der Rechnungsnummer oder des Betreffs — auch bezahlte, stornierte und Entwürfe; die Kennung eines Treffers ist die Eingabe für `rechnung_ansehen`. Interne Kennungen ausschließlich selbst für Folgewerkzeuge verwenden; einen Menschen niemals bitten, eine UUID einzugeben oder zu wiederholen.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {'bis': {'type': 'string', 'description': 'Spätestes Rechnungsdatum, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Frühestes Rechnungsdatum, JJJJ-MM-TT.'}, 'suche': {'type': 'string', 'maxLength': 60, 'description': 'Teil der Rechnungsnummer (z. B. „0027" oder „RE-2026-0027") oder des Betreffs. Findet auch bezahlte, stornierte und Entwürfe.'}, 'anzahl': {'type': 'number', 'description': 'Höchstens so viele (Vorgabe 25, Grenze 100).'}, 'nur_offen': {'type': 'boolean', 'description': 'Nur Rechnungen mit offenem Restbetrag, älteste Fälligkeit zuerst.'}, 'nur_ueberfaellig': {'type': 'boolean', 'description': 'Nur solche, deren Fälligkeit verstrichen ist.'}}, 'additionalProperties': False}

rechnung_versand_vorschau

E-Mail-Versandvorschau einer Rechnung

Prüft garantiert nur lesend den vollständigen Rechnungsentwurf vor dem E-Mail-Versand: alle Positionen und Summen, Kunde, Empfänger, Mail-Betreff und -Text, der in Meistron gewählte aktive Standard-Absender, Provider, Antwortadresse, die vollständige Anhangsliste sowie ein kurzlebig geschütztes Entwurfs-PDF. Dieses Werkzeug versendet NIEMALS etwas, vergibt KEINE Rechnungsnummer, friert KEIN PDF ein, legt KEINE Freigabe an und verändert KEINE Daten — auch dann nicht, wenn Vollautonomie aktiv ist. Für Fragen wie „zeig mir die Versandvorschau", „welcher Absender wird benutzt?" oder „prüfe vor dem Versand" immer dieses Werkzeug verwenden. Die interne Rechnungskennung vorher selbst mit `rechnungen_suchen` ermitteln; den Menschen niemals bitten, eine UUID einzugeben oder sie ihm als notwendige Eingabe anzeigen.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['rechnung_id'], 'properties': {'rechnung_id': {'type': 'string', 'description': 'Interne Kennung aus `rechnungen_suchen`. Selbst zwischen Werkzeugen weiterreichen und niemals vom Menschen eintippen lassen.'}}, 'additionalProperties': False}

rechnung_versenden

Rechnung versenden

Nur für den tatsächlichen Versand verwenden. Für eine bloße Prüfung ohne Datenänderung immer `rechnung_versand_vorschau` aufrufen. Versendet einen Rechnungs-Entwurf per E-Mail an den Kunden. Dabei wird die Rechnungsnummer vergeben, das PDF eingefroren und der Versand protokolliert; ab dann ist die Rechnung nach GoBD unveränderlich. Die interne Rechnungskennung vorher selbst mit `rechnungen_suchen` ermitteln; den Menschen niemals bitten, eine UUID einzugeben oder zu wiederholen. BRIEFE GEHEN ÜBER DIESEN ZUGANG NICHT. Das ist Absicht, kein Fehler: Die Anschrift eines Kunden kann über denselben Zugang angelegt worden sein — ein Brief ginge dann an eine Adresse, die nie ein Mensch geprüft hat, auf Kosten des Post-Guthabens des Betriebs. Wer einen Brief verschicken will, tut das in Meistron. Das dem Handwerker so sagen, statt es anders zu versuchen. NORMALER MODUS — ZWEI SCHRITTE: 1. Ohne „freigabe" aufrufen → es geht NICHTS hinaus. Zurück kommt eine Vorschau: alle Positionen und Summen, Empfänger, Mailtext, der in Meistron gewählte Standard-Absender, Antwortadresse, die vollständige Anhangsliste und ein geschütztes Entwurfs-PDF — dazu ein Freigabewort. 2. Die Vorschau dem Menschen zeigen und ihn ausdrücklich fragen. Erst mit seinem Ja erneut aufrufen, diesmal mit „freigabe". Das Freigabewort NIEMALS selbst erfinden und den zweiten Schritt NIEMALS ohne ausdrückliche Zustimmung tun. Ausnahme: Hat der Inhaber für genau diesen Zugang in Meistron „Vollzugriff und Vollautonomie" aktiviert, führt der Server den Versand direkt ohne Vorschau-Runde aus. Diesen Modus kann das Modell weder wählen noch einschalten. Eine E-Mail ist nicht zurückholbar und trifft einen echten Kunden. Empfänger, Betreff und Text lassen sich hier NICHT angeben: Die Rechnung geht an die Adresse, die beim Kunden hinterlegt ist, mit den Vorlagen des Betriebs. Im normalen Modus muss diese Adresse menschlich bestätigt sein. Eine vom KI-Zugang angelegte Kundenadresse ist ausschließlich unter der für denselben Zugang aktivierten Vollautonomie samt E-Mail-Kanal sendefähig und wird in der Antwort so ausgewiesen. Der Absender ist ebenfalls kein Argument: Der Server nutzt exakt den aktiven Standard unter E-Mail-Absender. Nur wenn kein aktiver betrieblicher Absender existiert, wird der Meistron-Systemabsender klar ausgewiesen. Ein fehlender oder ungültiger Default neben aktiven Konten bricht ohne Fallback ab. Wer an eine andere Adresse senden will, ändert sie beim Kunden in Meistron.

Destructif Accès externe

Schéma d’entrée

{'type': 'object', 'required': ['rechnung_id'], 'properties': {'weg': {'enum': ['email'], 'type': 'string', 'description': 'Nur E-Mail. Briefe lassen sich über diesen Zugang NICHT versenden — sie werden in Meistron ausgelöst.'}, 'freigabe': {'type': 'string', 'description': 'Das Freigabewort aus der Vorschau (Form „SENDEN-1234"). Nur setzen, wenn der Mensch die Vorschau gesehen und ausdrücklich zugestimmt hat.'}, 'rechnung_id': {'type': 'string', 'description': 'Interne Kennung des Entwurfs aus `rechnungen_suchen`. Selbst zwischen Werkzeugen weiterreichen und niemals vom Menschen eintippen oder wiederholen lassen. Die Rechnung muss im Status „Entwurf" sein.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}}, 'additionalProperties': False}

tagesuebersicht

Tagesübersicht

Die Antwort auf „was steht an?" in EINEM Aufruf: Termine heute, Aufträge, die anstehen, offene Rechnungen mit Restbetrag (Teilzahlungen abgezogen) und Überfälligkeit, Angebote ohne Entscheidung, nicht abgerechnete Zeiten und Material unter dem Mindestbestand. Je Rubrik höchstens fünf Zeilen, dazu immer die Gesamtzahl und das Werkzeug, mit dem es tiefer geht. Was der Betrieb für den KI-Zugang nicht freigegeben hat, fehlt — die Antwort nennt aber ausdrücklich, welche Rubrik oder welche Angabe darin ausgelassen wurde, und schweigt darüber nie. Der richtige erste Aufruf am Morgen; für Einzelheiten danach die Fachwerkzeuge.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {}, 'additionalProperties': False}

wartungsvertraege_suchen

Wartungsverträge suchen

Listet die Wartungsverträge des Betriebs mit Kunde, Anlage, Rhythmus und nächster Fälligkeit. Ohne Angaben kommen die zuerst fälligen. Gut für „welche Wartungen stehen im nächsten Monat an?".

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'properties': {'anzahl': {'type': 'number', 'description': 'Höchstens so viele (Vorgabe 25, Grenze 100).'}, 'status': {'enum': ['active', 'paused', 'ended'], 'type': 'string', 'description': 'Nur Verträge in diesem Zustand. Ohne Angabe nur aktive.'}, 'kunde_id': {'type': 'string', 'description': 'Nur Verträge dieses Kunden.'}, 'faellig_bis': {'type': 'string', 'description': 'Nur Verträge, die bis zu diesem Tag fällig werden, JJJJ-MM-TT.'}, 'nur_ueberfaellig': {'type': 'boolean', 'description': 'Nur Verträge, deren Fälligkeit schon vorbei ist.'}}, 'additionalProperties': False}

wartungsvertrag_aendern

Wartungsvertrag ändern

Ändert einen Wartungsvertrag: Rhythmus, nächste Fälligkeit, Anlage, Zuständige, Erinnerungsstufen — oder setzt ihn auf Pause bzw. beendet ihn. Änderungen ziehen in noch nicht begonnene Wartungsaufträge nach; laufende und abgeschlossene bleiben unberührt. Nur die angegebenen Felder werden geändert.

Schéma d’entrée

{'type': 'object', 'required': ['vertrag_id'], 'properties': {'grund': {'type': 'string', 'description': 'Nur bei `ended`: warum der Vertrag endet.'}, 'notiz': {'type': 'string', 'description': 'Neue interne Notiz.'}, 'titel': {'type': 'string', 'description': 'Neuer Titel.'}, 'anlage': {'type': 'string', 'description': 'Neuer Anlagentext.'}, 'zustand': {'enum': ['active', 'paused', 'ended'], 'type': 'string', 'description': 'Pausieren (`paused`) hält die Serie an, ohne sie zu verlieren — beim Fortsetzen (`active`) wird eine versäumte Wartung nachgeholt. Beenden (`ended`) erzeugt keine neuen Aufträge mehr; bereits angelegte bleiben.'}, 'rhythmus': {'enum': ['weekly', 'monthly', 'quarterly', 'half_yearly', 'yearly', 'custom_days'], 'type': 'string', 'description': 'Neuer Rhythmus. Wirkt auf jeden künftigen Termin.'}, 'pause_bis': {'type': 'string', 'description': 'Nur bei `paused`: bis zu diesem Tag ruht die Serie, JJJJ-MM-TT.'}, 'vertrag_id': {'type': 'string', 'description': 'Die Kennung des Wartungsvertrags.'}, 'mitarbeiter': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Ersetzt die Zuständigen vollständig — wer hier fehlt, ist danach nicht mehr zuständig.'}, 'beschreibung': {'type': 'string', 'description': 'Neue Beschreibung.'}, 'vorlauf_tage': {'type': 'number', 'description': 'Neuer Vorlauf in Tagen (0 bis 60).'}, 'dauer_minuten': {'type': 'number', 'description': 'Neue Dauer in Minuten (15 bis 1440).'}, 'rhythmus_tage': {'type': 'number', 'description': 'Nur bei `custom_days`: Abstand in Tagen (1 bis 3650).'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}, 'erinnerung_7_tage': {'type': 'boolean', 'description': 'Erinnerung 7 Tage vorher ein- oder ausschalten.'}, 'erinnerung_14_tage': {'type': 'boolean', 'description': 'Erinnerung 14 Tage vorher ein- oder ausschalten.'}, 'erinnerung_30_tage': {'type': 'boolean', 'description': 'Erinnerung 30 Tage vorher ein- oder ausschalten.'}, 'naechste_faelligkeit': {'type': 'string', 'description': 'Neue Fälligkeit, JJJJ-MM-TT. Muss in der Zukunft liegen.'}}, 'additionalProperties': False}

wartungsvertrag_anlegen

Wartungsvertrag anlegen

Legt einen wiederkehrenden Wartungsvertrag an — Kunde, Rhythmus und erste Fälligkeit sind Pflicht. Die Vertragsnummer vergibt Meistron. Die Fälligkeit muss in der Zukunft liegen. Legt KEINEN Auftrag an: Der entsteht erst kurz vor der Fälligkeit von selbst. Verschickt NICHTS — der Kunde erfährt davon nichts, die Erinnerungen gehen an den Betrieb.

Schéma d’entrée

{'type': 'object', 'required': ['kunde_id', 'titel', 'rhythmus', 'naechste_faelligkeit'], 'properties': {'notiz': {'type': 'string', 'description': 'Interne Notiz zum Vertrag.'}, 'titel': {'type': 'string', 'description': 'Worum es geht, etwa „Jährliche Heizungswartung".'}, 'anlage': {'type': 'string', 'description': 'Was gewartet wird, im Klartext — „Gastherme Vaillant, Baujahr 2019, Keller".'}, 'kunde_id': {'type': 'string', 'description': 'Kennung des Kunden — über `auftraege_suchen` oder `kunde_anlegen` zu bekommen.'}, 'rhythmus': {'enum': ['weekly', 'monthly', 'quarterly', 'half_yearly', 'yearly', 'custom_days'], 'type': 'string', 'description': 'Wie oft. Bei `custom_days` zusätzlich `rhythmus_tage` angeben.'}, 'objekt_ort': {'type': 'string', 'description': 'Ort der Anlage.'}, 'objekt_plz': {'type': 'string', 'description': 'Postleitzahl der Anlage.'}, 'mitarbeiter': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Wer die Wartung macht und die Erinnerungen bekommt — Kennungen aus `mitarbeiter_auflisten`.'}, 'beschreibung': {'type': 'string', 'description': 'Was bei der Wartung zu tun ist.'}, 'vorlauf_tage': {'type': 'number', 'description': 'Wie viele Tage vor der Fälligkeit der Auftrag entsteht (0 bis 60, Vorgabe 7). 0 schaltet die Automatik ab.'}, 'dauer_minuten': {'type': 'number', 'description': 'Wie lange die Wartung üblicherweise braucht (15 bis 1440, Vorgabe 90).'}, 'rhythmus_tage': {'type': 'number', 'description': 'Nur bei `custom_days`: Abstand in Tagen (1 bis 3650).'}, 'objekt_strasse': {'type': 'string', 'description': 'Anschrift der Anlage, falls sie nicht beim Kunden steht.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$', 'description': 'Im vollautonomen Betrieb erforderlich. Beim ersten Aufruf weglassen: Der Server liefert dann einen UUID-Key, ohne die Aktion auszuführen. Den Aufruf mit diesem Key wiederholen und bei Retry/Reconnect denselben Key verwenden. Eine neue beabsichtigte Aktion braucht einen neuen Key.'}, 'naechste_faelligkeit': {'type': 'string', 'description': 'Erster Termin, JJJJ-MM-TT. Muss in der Zukunft liegen.'}}, 'additionalProperties': False}

wartungsvertrag_ansehen

Wartungsvertrag ansehen

Zeigt einen Wartungsvertrag ausführlich: Rhythmus, nächste Fälligkeit, Objektanschrift, Anlage, Zuständige, Erinnerungsstufen — und die bereits daraus entstandenen Aufträge.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['vertrag_id'], 'properties': {'vertrag_id': {'type': 'string', 'description': 'Die Kennung des Wartungsvertrags.'}}, 'additionalProperties': False}

zeiten_auswerten

Arbeitszeiten auswerten

Fasst die erfassten Arbeitszeiten eines Zeitraums zusammen — je Mitarbeiter die Summe der Stunden und die Zahl der erfassten Tage. Nennt auch Tage, an denen das Ausstempeln fehlt, denn die zählen nirgends mit.

Lecture seule Idempotent

Schéma d’entrée

{'type': 'object', 'required': ['von', 'bis'], 'properties': {'bis': {'type': 'string', 'description': 'Letzter Tag, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Erster Tag, JJJJ-MM-TT.'}}, 'additionalProperties': False}

Ajouté

                            tagesuebersicht
                        

29 September 2026 03:00

Modifié

                            kunde_anlegen
                        

21 September 2026 02:58

Modifié

                            angebot_anlegen
                        

21 September 2026 02:58

Modifié

                            rechnung_anlegen
                        

21 September 2026 02:58

Modifié

                            kunden_suchen
                        

21 September 2026 02:58

Modifié

                            rechnung_ansehen
                        

21 September 2026 02:58

Modifié

                            rechnungen_suchen
                        

21 September 2026 02:58

Modifié

                            auftrag_ansehen
                        

21 September 2026 02:58

Modifié

                            auftraege_suchen
                        

21 September 2026 02:58

Modifié

                            betrieb_ueberblick
                        

21 September 2026 02:58

Ajouté

                            wartungsvertrag_aendern
                        

17 September 2026 07:57

Ajouté

                            wartungsvertrag_anlegen
                        

17 September 2026 07:57

Ajouté

                            wartungsvertrag_ansehen
                        

17 September 2026 07:57

Ajouté

                            wartungsvertraege_suchen
                        

17 September 2026 07:57

Ajouté

                            kunde_anlegen
                        

17 September 2026 07:57

Ajouté

                            auftrag_aendern
                        

17 September 2026 07:57

Ajouté

                            auftrag_anlegen
                        

17 September 2026 07:57

Ajouté

                            mitarbeiter_auflisten
                        

17 September 2026 07:57

Ajouté

                            datei_stand
                        

17 September 2026 07:57

Ajouté

                            datei_anfordern
                        

17 September 2026 07:57

Ajouté

                            rechnung_versenden
                        

17 September 2026 07:57

Ajouté

                            lieferanten_auflisten
                        

17 September 2026 07:57

Ajouté

                            einstellungen_aendern
                        

17 September 2026 07:57

Ajouté

                            einstellungen_ansehen
                        

17 September 2026 07:57

Ajouté

                            angebot_anlegen
                        

17 September 2026 07:57

Ajouté

                            rechnung_anlegen
                        

17 September 2026 07:57

Ajouté

                            material_zuweisen
                        

17 September 2026 07:57

Ajouté

                            material_buchen
                        

17 September 2026 07:57

Ajouté

                            material_ansehen
                        

17 September 2026 07:57

Ajouté

                            material_suchen
                        

17 September 2026 07:57

Détails du serveur

Version

1.0.0

Transport

Streamable HTTP

Outils

Latence

1328 ms

Dernier scan

1 October 2026 02:52

Première détection

11 September 2026 15:28

Endpoint

https://meistron.app/api/mcp

Scans récents

Réussi

1 October 2026 02:52

Réussi

29 September 2026 03:00

Réussi

27 September 2026 02:51

Réussi

25 September 2026 03:01

Réussi

23 September 2026 02:52

Réussi

21 September 2026 02:58

Réussi

19 September 2026 02:49

Réussi

17 September 2026 12:57

Réussi

17 September 2026 07:57

Meistron

Ce que fait ce MCP

Outils

Modifications récentes des outils

Serveurs MCP similaires

Lovie Company Formation

Stratalize Finance

Red by Big Red Cloud

GestãoClick

Superlógica Condomínios

FalaZuki Finance BR

XBOSS

Sirenic