Una vez conectado ezeep, tu asistente dispone de un conjunto de herramientas de impresión que puede utilizar por ti. Tú describes lo que quieres y el asistente selecciona la herramienta adecuada, por lo que los nombres que aparecen a continuación solo son importantes cuando quieres ser preciso sobre algo. Esta página explica qué hace cada herramienta, qué información necesita de ti y qué devuelve.
Buscar e inspeccionar impresoras
| Herramienta | Función |
| List Printers | Devuelve todas las impresoras a las que puede acceder la cuenta conectada, con un identificador, nombre para mostrar, ubicación y la indicación de si la entrada corresponde a una cola. El estado de la impresora no forma parte de esta respuesta, por lo que las preguntas sobre qué impresoras están fuera de servicio se responden a partir de los conectores. |
| Get Printers Properties | Necesita el identificador de una impresora. Devuelve la información más completa que puede proporcionar una sola herramienta: compatibilidad con color y dúplex, incluidos sus valores predeterminados, intercalado, todos los tamaños de papel compatibles con sus dimensiones y cuál es el predeterminado, la lista de bandejas, orientaciones y resoluciones. Las preguntas sobre lo que una impresora determinada puede hacer físicamente se responden en una sola llamada. |
| Check Supported File Types | Devuelve la configuración de la plataforma, que incluye las extensiones de archivo compatibles junto con una gran cantidad de información del sistema que no está relacionada. Pide específicamente las extensiones y el asistente las extraerá por ti. |
| List Printers with issues | Devuelve un número y las impresoras que actualmente están informando de un problema. Si no hay ningún problema, devuelve una lista vacía y un número igual a cero, no un error. |
Imprimir un documento
| Herramienta | Función |
| Print from a URL | Necesita la URL del archivo, un nombre de archivo y el identificador de una impresora. El número de copias, color, dúplex y tamaño de papel son opcionales. Devuelve un identificador de trabajo. |
| Print a local or generated file | La preparación de una carga necesita un nombre de archivo y devuelve una ubicación de carga con tiempo limitado. Una vez colocado el archivo allí, la llamada de impresión necesita el identificador del archivo y el identificador de la impresora, con las mismas opciones de configuración. |
Hacer seguimiento de un trabajo
| Herramienta | Función |
| Get Print Job Status | Necesita un identificador de trabajo, que se devuelve cuando se envía el trabajo. Devuelve el estado actual. El mismo trabajo aparece en el portal de administración, por lo que todo lo que se imprime desde un cliente de IA puede auditarse en el lugar habitual. |
Estado de los conectores y las impresoras
| Herramienta | Función |
| List Connectors | Devuelve los resultados página por página. Cada conector incluye su identificador, nombre, descripción, tipo, estado en línea o fuera de línea, ubicación, nombre de host, dirección interna, sistema operativo, versión del software, cuándo se detectó en línea por última vez y cuándo se actualizaron sus impresoras por última vez. |
| List offline Connectors | Devuelve directamente los conectores que están fuera de línea. |
| Get Connector Status | Necesita un identificador de conector y devuelve los detalles de ese conector. |
Administrar usuarios y accesos
| Herramienta | Función |
| List Groups | No necesita información y devuelve los resultados página por página. Cada grupo incluye su identificador, nombre, descripción, indicadores de impresión local e impresora personal, el origen del grupo (un proveedor de identidad o el propio ezeep) y el número de miembros e impresoras. |
| Create a Group | Necesita un nombre. La descripción es opcional. |
| Add a User to a Group | Necesita un identificador de grupo y un identificador de usuario. |
| Assign a printer to a group | Necesita un identificador de grupo y un identificador de impresora. |
| List Users | Devuelve la lista completa de usuarios de la organización en una sola respuesta, con los datos de contacto, identificadores de inicio de sesión, estado de verificación, indicadores de funciones y pertenencia a grupos de cada persona. Es importante saberlo antes de pedirle a un cliente de IA que la lea. |
| Invite a User | Necesita una dirección de correo electrónico. El nombre, apellido y duración de la invitación son opcionales. |
Comprobar tu cuenta
| Herramienta | Función |
| Get Account Info | Devuelve el nombre para mostrar de la cuenta conectada, la organización, los roles, el estado de verificación, el idioma y el proveedor de identidad. Pide esta información primero cuando los resultados parezcan desconocidos o una llamada de administración sea rechazada. |
| Get Organization | Devuelve la información de la organización, incluido su nombre y el proveedor de identidad al que está vinculada.
|
Soporte para desarrolladores
El servidor incluye su propia documentación como herramientas que se pueden utilizar: una guía de integración, una referencia de la API y ejemplos de código. Estas funcionan antes de que hayas iniciado sesión, por lo que un asistente puede preparar la estructura de una integración con ezeep y después guiarte para conectarla. Crear una aplicación que imprima con la API de ezeep explica este proceso.
Lo que el servidor MCP no puede hacer
Eliminar un usuario, eliminar un grupo, quitar una impresora de un grupo y cancelar un trabajo en curso no están disponibles a través del servidor MCP. La API REST sí permite eliminar impresoras, conectores y usuarios, por lo que estas no son limitaciones de la plataforma, sino simplemente herramientas que no están disponibles en la interfaz MCP. Utiliza el portal de administración.
