MCP Tool

Suche nach Kunden/Lieferanten SELECT

Suche nach Kunden/Lieferanten Paginiert ID DESC. _meta.has_more beachten und cursor=next_cursor mit gleichem snapshot_bis_ID und Filtern weitergeben. Rechte werden vor der Datenausgabe geprueft. Detailgrad begrenzen; Bei Unterlisten ist die Kundenseite auf maximal 20 Kunden begrenzt. Unterlisten haben eigene Cursor und snapshot_bis_ID (z.B. ansprechpartner_cursor und ansprechpartner_snapshot_bis_ID) und sind auf 100 Eintraege begrenzt.

Tool-Name

tool

select_kunden

Parameter

Parameter	Typ	Pflicht	Beschreibung
`adressen_cursor`	`integer`	Nein	–
`adressen_snapshot_bis_ID`	`integer`	Nein	–
`adressen_typ`	`string`	Nein	lieferung/rechnung: aktuelle Standardadresse laut aktiv/aktiv_rechnung, kein Verzeichnis aller geeigneten Adressen. Standard: `alle`
`adressfilter`	`object`	Nein	–
`aktivitaeten_cursor`	`integer`	Nein	–
`aktivitaeten_snapshot_bis_ID`	`integer`	Nein	–
`ansprechpartner_cursor`	`integer`	Nein	–
`ansprechpartner_ID`	`integer`	Nein	–
`ansprechpartner_snapshot_bis_ID`	`integer`	Nein	–
`cursor`	`integer`	Nein	–
`detailgrad`	`string`	Nein	Kommagetrennt, z.B. stammdaten,texte
`email`	`string`	Nein	Siehe MCP-Schema; Cursor und Snapshot fuer vollstaendiges Weiterblaettern behalten.
`email_ansprechpartner`	`string`	Nein	– Standard: `1`
`ID`	`any`	Nein	–
`kontaktzweck`	`string`	Nein	– Standard: `allgemein`
`kundekategorien`	`any`	Nein	–
`limit`	`integer`	Nein	– Standard: `100`
`name_firma`	`string`	Nein	Teiltext in konfigurierten Namens-/Firmenfeldern sowie Adressen/Kontakten. Alle Kandidaten erhalten.
`snapshot_bis_ID`	`integer`	Nein	–
`suchtyp`	`string`	Nein	Fixer Suchtyp: kunden Standard: `kunden`
`telefon`	`string`	Nein	Exakt normalisiert (Leerzeichen, Satzzeichen, + versus 00); keine Landesvorwahl erfinden.

Input Schema

json

{
    "type": "object",
    "properties": {
        "ID": {
            "anyOf": [
                {
                    "type": "integer",
                    "minimum": 1
                },
                {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                        "type": "integer",
                        "minimum": 1
                    }
                },
                {
                    "type": "string",
                    "pattern": "^[0-9]+(,[0-9]+)*$"
                }
            ]
        },
        "detailgrad": {
            "type": "string",
            "description": "Kommagetrennt, z.B. stammdaten,texte"
        },
        "kundekategorien": {
            "anyOf": [
                {
                    "type": "integer",
                    "minimum": 1
                },
                {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                        "type": "integer",
                        "minimum": 1
                    }
                },
                {
                    "type": "string",
                    "pattern": "^[0-9]+(,[0-9]+)*$"
                }
            ]
        },
        "email": {
            "type": "string",
            "description": "Siehe MCP-Schema; Cursor und Snapshot fuer vollstaendiges Weiterblaettern behalten."
        },
        "email_ansprechpartner": {
            "type": "string",
            "enum": [
                "0",
                "1"
            ],
            "default": "1"
        },
        "telefon": {
            "type": "string",
            "description": "Exakt normalisiert (Leerzeichen, Satzzeichen, + versus 00); keine Landesvorwahl erfinden."
        },
        "name_firma": {
            "type": "string",
            "description": "Teiltext in konfigurierten Namens-/Firmenfeldern sowie Adressen/Kontakten. Alle Kandidaten erhalten."
        },
        "adressfilter": {
            "type": "object",
            "additionalProperties": false,
            "minProperties": 1,
            "properties": {
                "land": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Interne Landes-Auswahl-ID aus kunden_felder_auswahl, wie Zusatzadressen-UI."
                },
                "plz": {
                    "type": "string"
                },
                "ort": {
                    "type": "string"
                },
                "strasse": {
                    "type": "string"
                }
            }
        },
        "adressen_typ": {
            "type": "string",
            "enum": [
                "alle",
                "lieferung",
                "rechnung"
            ],
            "default": "alle",
            "description": "lieferung/rechnung: aktuelle Standardadresse laut aktiv/aktiv_rechnung, kein Verzeichnis aller geeigneten Adressen."
        },
        "ansprechpartner_ID": {
            "type": "integer",
            "minimum": 1
        },
        "kontaktzweck": {
            "type": "string",
            "enum": [
                "allgemein",
                "rechnung"
            ],
            "default": "allgemein"
        },
        "ansprechpartner_cursor": {
            "type": "integer",
            "minimum": 1
        },
        "adressen_cursor": {
            "type": "integer",
            "minimum": 1
        },
        "aktivitaeten_cursor": {
            "type": "integer",
            "minimum": 1
        },
        "ansprechpartner_snapshot_bis_ID": {
            "type": "integer",
            "minimum": 1
        },
        "adressen_snapshot_bis_ID": {
            "type": "integer",
            "minimum": 1
        },
        "aktivitaeten_snapshot_bis_ID": {
            "type": "integer",
            "minimum": 1
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "default": 100
        },
        "cursor": {
            "type": "integer",
            "minimum": 0
        },
        "snapshot_bis_ID": {
            "type": "integer",
            "minimum": 0
        },
        "suchtyp": {
            "type": "string",
            "description": "Fixer Suchtyp: kunden",
            "default": "kunden"
        }
    }
}

Beispiel-Aufruf

json

{
    "tool": "select_kunden",
    "arguments": {
        "adressen_cursor": 1,
        "adressen_snapshot_bis_ID": 1,
        "adressen_typ": "alle",
        "adressfilter": {},
        "aktivitaeten_cursor": 1,
        "aktivitaeten_snapshot_bis_ID": 1,
        "ansprechpartner_cursor": 1,
        "ansprechpartner_ID": 1,
        "ansprechpartner_snapshot_bis_ID": 1,
        "cursor": 1,
        "detailgrad": "...",
        "email": "...",
        "email_ansprechpartner": "1",
        "ID": "...",
        "kontaktzweck": "allgemein",
        "kundekategorien": "...",
        "limit": 100,
        "name_firma": "...",
        "snapshot_bis_ID": 1,
        "suchtyp": "kunden",
        "telefon": "..."
    }
}