Meistron

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Auftraege, Rechnungen, Material und Zeiten eines Handwerksbetriebs abfragen und pflegen.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Meistron": {
      "url": "https://meistron.app/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (31)

• betrieb_ueberblick read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tagesuebersicht read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• beleg_pdf read-only

  Liest die PDF einer Rechnung, Quittung oder eines Angebots. Ausgestellte Belege kommen ausschließlich als byte-genaues gespeichertes Original; der aktuelle Status wird nie in die Datei gestempelt. Entwürfe werden sichtbar als ENTWURF ohne Nummer live erzeugt und nie gespeichert. Ein ausgestellter Beleg ohne Original wird abgewiesen statt neu gerendert. Das PDF kann Anschrift, Bank- und Steuerangaben enthalten und ist deshalb zusätzlich am ausgeschalteten Bereich „Dokumente“ gebunden.

  Parameters:

  • rechnung_id (required) — string — Interne Kennung aus `rechnungen_suchen` oder `angebote_suchen`.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• auftragsnachweis_pdf read-only

  Liest den Auftragsnachweis eines dokumentierten oder abgeschlossenen Auftrags. Eine gespeicherte Fassung wird byte-genau geliefert; fehlt sie, entsteht die PDF live und ohne Ablage. Für geplante, laufende oder stornierte Aufträge gibt es keinen Nachweis. Die Datei kann Fotos und eine Unterschrift enthalten und ist deshalb zusätzlich am ausgeschalteten Bereich „Dokumente“ gebunden.

  Parameters:

  • auftrag_id (required) — string — Die interne Kennung des Auftrags.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• bestandsliste_pdf read-only

  Erzeugt eine aktuelle Bestandsliste aller aktiven Katalogartikel mit Bestand, Mindestbestand, Lagerort und Verkaufspreis. Die PDF wird nur für diesen Aufruf live erstellt und nie gespeichert; sie ist zusätzlich am ausgeschalteten Bereich „Dokumente“ gebunden.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• auftraege_suchen read-only

  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`.

  Parameters:

  • bis — string — Spätester Termin, JJJJ-MM-TT.
  • von — string — Frühester Termin, JJJJ-MM-TT.
  • suche — string — Teil der Auftragsnummer oder des Titels, z. B. „0118" oder „Heizung". Ohne Zeitraum werden dann auch vergangene Aufträge gefunden, nicht nur anstehende.
  • anzahl — number — Höchstens so viele (Vorgabe 25, Grenze 100).
  • status — string — Nur Aufträge in diesem Status.
  • kunde_id — string — Nur Aufträge dieses Kunden — die Kennung aus `kunden_suchen`.
  • nur_unterminiert — boolean — Nur Aufträge ohne Termin — die, die noch eingeplant werden müssen.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• auftrag_ansehen read-only

  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.

  Parameters:

  • auftrag_id (required) — string — Die Kennung des Auftrags.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rechnungen_suchen read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rechnung_ansehen read-only

  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.

  Parameters:

  • rechnung_id (required) — string — Die Kennung der Rechnung.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rechnung_versand_vorschau read-only

  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.

  Parameters:

  • rechnung_id (required) — string — Interne Kennung aus `rechnungen_suchen`. Selbst zwischen Werkzeugen weiterreichen und niemals vom Menschen eintippen lassen.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• angebote_suchen read-only

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

  Parameters:

  • bis — string — Spätestes Datum, JJJJ-MM-TT.
  • von — string — Frühestes Datum, JJJJ-MM-TT.
  • anzahl — number — Höchstens so viele (Vorgabe 25, Grenze 100).
  • nur_offen — boolean — Nur noch nicht umgewandelte Angebote.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• zeiten_auswerten read-only

  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.

  Parameters:

  • von (required) — string — Erster Tag, JJJJ-MM-TT.
  • bis (required) — string — Letzter Tag, JJJJ-MM-TT.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• kunden_suchen read-only

  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.

  Parameters:

  • suche — string — Teil des Namens, der Firma oder des Ortes. Ohne Angabe die zuletzt angelegten.
  • anzahl — number — Höchstens so viele (Vorgabe 25, Grenze 100).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• material_suchen read-only

  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.

  Parameters:

  • suche — string — Teil der Bezeichnung oder Artikelnummer.
  • anzahl — number — Höchstens so viele (Vorgabe 25, Grenze 100).
  • nur_knapp — boolean — Nur Artikel unter dem hinterlegten Mindestbestand.
  • nur_werkzeug — boolean — Nur Werkzeuge statt Verbrauchsmaterial.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• material_ansehen read-only

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

  Parameters:

  • material_id (required) — string — Die Kennung des Artikels.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• material_buchen destructive

  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.

  Parameters:

  • material_id (required) — string — Die Kennung des Artikels.
  • art (required) — string — zugang = Ware kommt herein · abgang = Ware geht ohne Auftrag heraus · inventur = der gezählte Ist-Bestand, NICHT die Differenz.
  • menge (required) — number — Bei Zugang und Abgang die bewegte Menge (immer positiv). Bei Inventur der gezählte Bestand — die Differenz errechnet das System selbst.
  • notiz — string — Grund der Buchung, z. B. Lieferschein-Nummer.
  • idempotency_key — string — 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.

  Hints: read-only no · destructive yes · idempotent no · open-world no

• material_zuweisen destructive

  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.

  Parameters:

  • auftrag_id (required) — string — Die Kennung des Auftrags.
  • material_id (required) — string — Die Kennung des Artikels aus dem Katalog.
  • menge (required) — number — Wie viel auf den Auftrag geht (positiv).
  • notiz — string — Optionaler Vermerk zur Zuweisung.
  • idempotency_key — string — 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.

  Hints: read-only no · destructive yes · idempotent no · open-world no

• 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.

  Parameters:

  • betreff — string — Betreff der Rechnung, eine Zeile unter der Belegnummer (z. B. „Heizungswartung Reihenhaus"). Ohne Angabe wird der Titel des Auftrags übernommen.
  • hinweis — string — Text für den Kunden auf der Rechnung.
  • kunde_id — string — Die Kennung des Kunden. Ohne Angabe wird der Kunde des Auftrags übernommen.
  • belegkopf — object — 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.
  • auftrag_id — string — Auftrag, dessen Material und Arbeitszeit übernommen werden sollen — und aus dem Betreff und Belegkopf gefüllt werden.
  • positionen — array — Eigene Positionen. Höchstens 50.
  • steuersatz — number — 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 — boolean — Auf true setzen, wenn NUR das Material übernommen werden soll, keine Stunden.
  • ohne_material — boolean — Auf true setzen, wenn NUR die Stunden übernommen werden sollen.
  • idempotency_key — string — 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 — boolean — 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.

  Hints: read-only no · destructive no · idempotent no · open-world no

• 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.

  Parameters:

  • betreff — string — Betreff des Angebots, eine Zeile unter der Belegnummer (z. B. „Heizungswartung Reihenhaus"). Ohne Angabe wird der Titel des Auftrags übernommen.
  • hinweis — string — Text für den Kunden auf dem Angebot.
  • kunde_id — string — Die Kennung des Kunden. Ohne Angabe wird der Kunde des Auftrags übernommen.
  • belegkopf — object — 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.
  • auftrag_id — string — Auftrag, dessen Material und Arbeitszeit übernommen werden sollen — und aus dem Betreff und Belegkopf gefüllt werden.
  • positionen — array — Eigene Positionen. Höchstens 50.
  • steuersatz — number — 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 — boolean — Nur Material übernehmen, keine Stunden.
  • ohne_material — boolean — Nur Stunden übernehmen, kein Material.
  • idempotency_key — string — 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 — boolean — 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.

  Hints: read-only no · destructive no · idempotent no · open-world no

• einstellungen_ansehen read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• einstellungen_aendern destructive

  Ändert eine Firmen- oder Rechnungsvorgabe. Wirkt auf ALLE künftigen Rechnungen und Angebote; Firmendaten wie die Anschrift erscheinen auch in noch nicht ausgestellten Entwürfen. Ausgestellte Belege behalten ihr Original. 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.

  Parameters:

  • feld (required) — string — Was geändert werden soll, z. B. default_payment_terms, default_hourly_rate, phone, closing_name. „einstellungen_ansehen" nennt die möglichen Namen.
  • wert (required) — ['string', 'number', 'boolean'] — Der neue Wert. Bei Ja/Nein-Feldern true oder false.
  • idempotency_key — string — 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.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• lieferanten_auflisten read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rechnung_versenden destructive

  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.

  Parameters:

  • rechnung_id (required) — string — 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.
  • weg — string — Nur E-Mail. Briefe lassen sich über diesen Zugang NICHT versenden — sie werden in Meistron ausgelöst.
  • freigabe — string — Das Freigabewort aus der Vorschau (Form „SENDEN-1234"). Nur setzen, wenn der Mensch die Vorschau gesehen und ausdrücklich zugestimmt hat.
  • idempotency_key — string — 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.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• 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.

  Parameters:

  • zweck (required) — string — datanorm = Preisdatei eines Lieferanten · dokument = PDF (Ausschreibung, Plan) · beleg = Eingangsrechnung oder Quittung · bild = Foto.
  • hinweis — string — Was genau gebraucht wird — steht dem Menschen auf der Upload-Seite.
  • lieferant_id — string — 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 — string — 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 — string — 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.

  Hints: read-only no · destructive no · idempotent no · open-world no

• datei_stand read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• mitarbeiter_auflisten read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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.

  Parameters:

  • titel (required) — string — Kurzer Titel, worum es geht.
  • ort — string — Einsatzort als Text.
  • endet — string — Termin-Ende, JJJJ-MM-TTTHH:MM. Nur zusammen mit `beginnt`.
  • beginnt — string — Termin-Beginn, JJJJ-MM-TTTHH:MM (Ortszeit).
  • kunde_id — string — Kennung eines bestehenden Kunden.
  • mitarbeiter — array — Kennungen der zuständigen Personen (siehe mitarbeiter_auflisten). Ohne Angabe wird der Inhaber selbst zugewiesen.
  • beschreibung — string — Was zu tun ist.
  • idempotency_key — string — 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.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• auftrag_aendern destructive

  Ändert Titel, Beschreibung, Ort oder Termin eines bestehenden Auftrags. Nur die angegebenen Felder werden angefasst. Den Status setzt das Werkzeug nicht selbst — wie in der App stellt aber eine geänderte Beschreibung einen geplanten Auftrag auf „In Bearbeitung“, und zurück auf „geplant“ geht es danach nicht. 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.

  Parameters:

  • auftrag_id (required) — string — Die Kennung des Auftrags.
  • ort — string
  • endet — string — Neues Termin-Ende, JJJJ-MM-TTTHH:MM.
  • titel — string
  • beginnt — string — Neuer Termin-Beginn, JJJJ-MM-TTTHH:MM.
  • beschreibung — string
  • idempotency_key — string — 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.

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• 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 schon genau einen Kunden mit diesem Namen, wird KEIN zweiter angelegt; dort werden nur Angaben ergänzt, die noch leer sind (Firma, Anschrift, Kontaktdaten). Vorhandene Angaben werden nie überschrieben oder gelöscht; Korrekturen macht der Betrieb in Meistron. 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.

  Parameters:

  • name (required) — string — Name der Person oder des Betriebs.
  • ort — string
  • plz — string
  • email — string — E-Mail-Adresse des Kunden. Nur mit serverseitig aktiver Vollautonomie für diesen Zugang.
  • firma — string — Firmenname, falls abweichend.
  • mobil — string — Mobilnummer. Nur mit serverseitig aktiver Vollautonomie für diesen Zugang.
  • strasse — string
  • telefon — string — Festnetznummer. Nur mit serverseitig aktiver Vollautonomie für diesen Zugang.
  • idempotency_key — string — 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.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• wartungsvertraege_suchen read-only

  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?".

  Parameters:

  • anzahl — number — Höchstens so viele (Vorgabe 25, Grenze 100).
  • status — string — Nur Verträge in diesem Zustand. Ohne Angabe nur aktive.
  • kunde_id — string — Nur Verträge dieses Kunden.
  • faellig_bis — string — Nur Verträge, die bis zu diesem Tag fällig werden, JJJJ-MM-TT.
  • nur_ueberfaellig — boolean — Nur Verträge, deren Fälligkeit schon vorbei ist.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• wartungsvertrag_ansehen read-only

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

  Parameters:

  • vertrag_id (required) — string — Die Kennung des Wartungsvertrags.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.