app.meistron/meistron

Est-ce que app.meistron/meistron est sûr ?

Au dernier audit MCP Hub, le serveur MCP « app.meistron/meistron » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 31 outils

• angebot_anlegen≈ 1367 tokens

  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.

  Paramètres, retour & exemple (11)

  Paramètres

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

  Exemple d'appel

  {"name": "angebot_anlegen", "arguments": {"betreff": "texte", "hinweis": "texte", "kunde_id": "texte", "belegkopf": {}, "auftrag_id": "texte", "positionen": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• angebote_suchen≈ 193 tokens

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

  Paramètres, retour & exemple (4)

  Paramètres

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

  Exemple d'appel

  {"name": "angebote_suchen", "arguments": {"bis": "texte", "von": "texte", "anzahl": 1, "nur_offen": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• auftraege_suchen≈ 387 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

  • bis · string · optionnel
    Spätester Termin, JJJJ-MM-TT.
  • von · string · optionnel
    Frühester Termin, JJJJ-MM-TT.
  • suche · string · optionnel
    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 · optionnel
    Höchstens so viele (Vorgabe 25, Grenze 100).
  • status · string · optionnel · scheduled | in_progress | documented | completed | canceled
    Nur Aufträge in diesem Status.
  • kunde_id · string · optionnel
    Nur Aufträge dieses Kunden — die Kennung aus `kunden_suchen`.
  • nur_unterminiert · boolean · optionnel
    Nur Aufträge ohne Termin — die, die noch eingeplant werden müssen.

  Exemple d'appel

  {"name": "auftraege_suchen", "arguments": {"bis": "texte", "von": "texte", "suche": "texte", "anzahl": 1, "status": "scheduled", "kunde_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• auftrag_aendern≈ 403 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

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

  Exemple d'appel

  {"name": "auftrag_aendern", "arguments": {"auftrag_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• auftrag_anlegen≈ 483 tokens

  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.

  Paramètres, retour & exemple (8)

  Paramètres

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

  Exemple d'appel

  {"name": "auftrag_anlegen", "arguments": {"titel": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• auftrag_ansehen≈ 254 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • auftrag_id · string · requis
    Die Kennung des Auftrags.

  Exemple d'appel

  {"name": "auftrag_ansehen", "arguments": {"auftrag_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• auftragsnachweis_pdf≈ 207 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • auftrag_id · string · requis
    Die interne Kennung des Auftrags.

  Exemple d'appel

  {"name": "auftragsnachweis_pdf", "arguments": {"auftrag_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• beleg_pdf≈ 233 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • rechnung_id · string · requis
    Interne Kennung aus `rechnungen_suchen` oder `angebote_suchen`.

  Exemple d'appel

  {"name": "beleg_pdf", "arguments": {"rechnung_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• bestandsliste_pdf≈ 146 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "bestandsliste_pdf", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• betrieb_ueberblick≈ 154 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "betrieb_ueberblick", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• datei_anfordern≈ 662 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

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

  Exemple d'appel

  {"name": "datei_anfordern", "arguments": {"zweck": "datanorm"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• datei_stand≈ 136 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "datei_stand", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• einstellungen_aendern≈ 432 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

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

  Exemple d'appel

  {"name": "einstellungen_aendern", "arguments": {"feld": "texte", "wert": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• einstellungen_ansehen≈ 146 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "einstellungen_ansehen", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• kunde_anlegen≈ 597 tokens

  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.

  Paramètres, retour & exemple (9)

  Paramètres

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

  Exemple d'appel

  {"name": "kunde_anlegen", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• kunden_suchen≈ 277 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

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

  Exemple d'appel

  {"name": "kunden_suchen", "arguments": {"suche": "texte", "anzahl": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• lieferanten_auflisten≈ 156 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "lieferanten_auflisten", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• material_ansehen≈ 135 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • material_id · string · requis
    Die Kennung des Artikels.

  Exemple d'appel

  {"name": "material_ansehen", "arguments": {"material_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• material_buchen≈ 458 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

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

  Exemple d'appel

  {"name": "material_buchen", "arguments": {"art": "zugang", "menge": 1, "material_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• material_suchen≈ 224 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

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

  Exemple d'appel

  {"name": "material_suchen", "arguments": {"suche": "texte", "anzahl": 1, "nur_knapp": true, "nur_werkzeug": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• material_zuweisen≈ 364 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

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

  Exemple d'appel

  {"name": "material_zuweisen", "arguments": {"menge": 1, "auftrag_id": "texte", "material_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• mitarbeiter_auflisten≈ 122 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "mitarbeiter_auflisten", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rechnung_anlegen≈ 1387 tokens

  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.

  Paramètres, retour & exemple (11)

  Paramètres

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

  Exemple d'appel

  {"name": "rechnung_anlegen", "arguments": {"betreff": "texte", "hinweis": "texte", "kunde_id": "texte", "belegkopf": {}, "auftrag_id": "texte", "positionen": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rechnung_ansehen≈ 218 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • rechnung_id · string · requis
    Die Kennung der Rechnung.

  Exemple d'appel

  {"name": "rechnung_ansehen", "arguments": {"rechnung_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rechnung_versand_vorschau≈ 344 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • rechnung_id · string · requis
    Interne Kennung aus `rechnungen_suchen`. Selbst zwischen Werkzeugen weiterreichen und niemals vom Menschen eintippen lassen.

  Exemple d'appel

  {"name": "rechnung_versand_vorschau", "arguments": {"rechnung_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rechnung_versenden≈ 974 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

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

  Exemple d'appel

  {"name": "rechnung_versenden", "arguments": {"rechnung_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• rechnungen_suchen≈ 416 tokens

  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.

  Paramètres, retour & exemple (6)

  Paramètres

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

  Exemple d'appel

  {"name": "rechnungen_suchen", "arguments": {"bis": "texte", "von": "texte", "suche": "texte", "anzahl": 1, "nur_offen": true, "nur_ueberfaellig": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• tagesuebersicht≈ 231 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "tagesuebersicht", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• wartungsvertraege_suchen≈ 263 tokens

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

  Paramètres, retour & exemple (5)

  Paramètres

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

  Exemple d'appel

  {"name": "wartungsvertraege_suchen", "arguments": {"anzahl": 1, "status": "active", "kunde_id": "texte", "faellig_bis": "texte", "nur_ueberfaellig": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• wartungsvertrag_ansehen≈ 152 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • vertrag_id · string · requis
    Die Kennung des Wartungsvertrags.

  Exemple d'appel

  {"name": "wartungsvertrag_ansehen", "arguments": {"vertrag_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• zeiten_auswerten≈ 172 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • bis · string · requis
    Letzter Tag, JJJJ-MM-TT.
  • von · string · requis
    Erster Tag, JJJJ-MM-TT.

  Exemple d'appel

  {"name": "zeiten_auswerten", "arguments": {"bis": "texte", "von": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://meistron.app/api/mcp