Sobald ezeep verbunden ist, verfügt Ihr Assistent über eine Reihe von Drucktools, die er für Sie aufrufen kann. Sie beschreiben, was Sie möchten, und der Assistent wählt das passende Tool aus. Die unten aufgeführten Namen sind daher nur dann relevant, wenn Sie bei einer Anfrage besonders präzise sein möchten. Auf dieser Seite erfahren Sie, was jedes Tool macht, welche Informationen es von Ihnen benötigt und was es zurückgibt.
Drucker suchen und überprüfen
| Tool | Zweck |
| List Printers | Gibt alle Drucker zurück, auf die das verbundene Konto zugreifen kann, einschließlich Kennung, Anzeigename, Standort und der Information, ob es sich um eine Warteschlange handelt. Der Druckerstatus ist nicht Bestandteil dieser Antwort. Fragen zu ausgefallenen Druckern werden daher anhand der Connectors beantwortet. |
| Get Printers Properties | Benötigt die Kennung eines Druckers. Liefert das umfassendste Bild, das ein einzelnes Tool bereitstellen kann: Unterstützung für Farbe und Duplexdruck einschließlich Standardeinstellungen, Sortierung, alle unterstützten Papierformate mit Abmessungen und dem Standardformat, die Fachliste sowie Ausrichtungen und Auflösungen. Fragen dazu, was ein bestimmter Drucker tatsächlich leisten kann, werden mit einem einzigen Aufruf beantwortet. |
| Check Supported File Types | Gibt die Plattformkonfiguration zurück. Diese enthält die unterstützten Dateierweiterungen sowie zahlreiche weitere, nicht relevante Systemdetails. Fragen Sie gezielt nach den Erweiterungen, und der Assistent extrahiert diese für Sie. |
| List Printers with issues | Gibt eine Anzahl und die Drucker zurück, die derzeit ein Problem melden. Wenn kein Problem vorliegt, werden eine leere Liste und die Anzahl null zurückgegeben, nicht ein Fehler. |
Ein Dokument drucken
| Tool | Zweck |
| Print from a URL | Benötigt die Datei-URL, einen Dateinamen und die Druckerkennung. Kopien, Farbe, Duplexdruck und Papierformat sind optional. Gibt eine Auftragskennung zurück. |
| Print a local or generated file | Für die Vorbereitung eines Uploads werden ein Dateiname und ein zeitlich begrenzter Upload-Speicherort benötigt. Sobald die Datei dort abgelegt wurde, benötigt der Druckaufruf die Datei- und Druckerkennung sowie dieselben optionalen Einstellungen. |
Einen Druckauftrag verfolgen
| Tool | Zweck |
| Get Print Job Status | Benötigt eine Auftragskennung, die beim Absenden eines Auftrags zurückgegeben wird. Gibt den aktuellen Status zurück. Derselbe Auftrag wird im Admin-Portal angezeigt, sodass alles, was über einen KI-Client gedruckt wird, wie gewohnt nachvollziehbar ist. |
Status von Connectors und Druckern
| Tool | Zweck |
| List Connectors | Gibt die Ergebnisse seitenweise zurück. Jeder Connector enthält seine Kennung, seinen lesbaren Namen, seine Beschreibung, seinen Typ, den Online- oder Offline-Status, den Standort, den Hostnamen, die interne Adresse, das Betriebssystem, die Softwareversion, den Zeitpunkt der letzten Online-Erkennung und den Zeitpunkt der letzten Aktualisierung seiner Drucker. |
| List offline Connectors | Gibt die Offline-Connectors direkt zurück. |
| Get Connector Status | Benötigt eine Connector-Kennung und gibt die Details dieses Connectors zurück. |
Benutzer und Zugriffe verwalten
| Tool | Zweck |
| List Groups | Benötigt keine Angaben und gibt die Ergebnisse seitenweise zurück. Jede Gruppe enthält ihre Kennung, ihren Namen, ihre Beschreibung, die Einstellungen für lokales Drucken und persönliche Drucker, die Herkunft der Gruppe (Identitätsanbieter oder ezeep selbst) sowie die Anzahl der Mitglieder und Drucker. |
| Create a Group | Benötigt einen Namen. Eine Beschreibung ist optional. |
| Add a User to a Group | Benötigt eine Gruppenkennung und eine Benutzerkennung. |
| Assign a printer to a group | Benötigt eine Gruppenkennung und eine Druckerkennung. |
| List Users | Gibt die vollständige Benutzerliste der Organisation in einer einzigen Antwort zurück, einschließlich Kontaktdaten, Anmeldekennungen, Verifizierungsstatus, Funktionskennzeichnungen und Gruppenzugehörigkeiten für jede Person. Dies sollten Sie wissen, bevor Sie einen KI-Client auffordern, diese Liste auszulesen. |
| Invite a User | Benötigt eine E-Mail-Adresse. Vor- und Nachname sowie die Gültigkeitsdauer der Einladung sind optional. |
Konto überprüfen
| Tool | Zweck |
| Get Account Info | Gibt den Anzeigenamen des verbundenen Kontos, die Organisation, Rollen, den Verifizierungsstatus, die Sprache und den Identitätsanbieter zurück. Fragen Sie diese Informationen zuerst ab, wenn Ergebnisse unbekannt wirken oder ein Verwaltungsvorgang abgelehnt wird. |
| Get Organization | Gibt die Informationen zur Organisation zurück, einschließlich ihres Namens und des Identitätsanbieters, mit dem sie verbunden ist.
|
Entwicklerunterstützung
Der Server enthält seine eigene Dokumentation in Form von aufrufbaren Tools: einen Integrationsleitfaden, eine API-Referenz und Codebeispiele. Diese funktionieren bereits, bevor Sie sich angemeldet haben. Dadurch kann ein Assistent eine ezeep-Integration vorbereiten und Sie anschließend durch die Verbindung führen. Eine App entwickeln, die mit der ezeep API druckt beschreibt diesen Ablauf.
Was der MCP-Server nicht kann
Das Löschen eines Benutzers, das Löschen einer Gruppe, das Entfernen eines Druckers aus einer Gruppe und das Abbrechen eines laufenden Druckauftrags sind über den MCP-Server nicht verfügbar. Die REST-API unterstützt das Löschen von Druckern, Connectors und Benutzern. Es handelt sich daher nicht um Plattformbeschränkungen, sondern lediglich um Funktionen, die über die MCP-Schnittstelle nicht angeboten werden. Verwenden Sie dafür das Admin-Portal.
