La mayoría de los problemas se pueden dividir en tres grupos: el cliente nunca se conecta, el cliente se conecta pero algunas llamadas fallan, o una llamada tiene éxito pero la respuesta es incorrecta. Revise la sección que corresponda a lo que está viendo.
El cliente nunca se conecta
| Problema | Causa más probable |
| No aparecen herramientas de ezeep | El endpoint no fue aceptado y el fallo normalmente es silencioso. Compruebe la URL carácter por carácter, ya que una barra diagonal faltante o un carácter adicional en el host puede hacer que no aparezca nada en lugar de mostrar un error. Confirme que la dirección comienza con https y que su cliente admite servidores HTTP remotos, no solo servidores locales. Cuando se utiliza un archivo de configuración, un error de sintaxis en cualquier parte del archivo puede dejarlo sin herramientas y sin ningún mensaje. Reinicie el cliente después de realizar cualquier cambio. |
| Se abre el inicio de sesión pero nunca termina | La ventana del navegador vuelve al cliente y no sucede nada, o el proceso se repite. Cierre la ventana, permita las ventanas emergentes y las cookies de terceros para la página de inicio de sesión y vuelva a iniciar la conexión desde el cliente en lugar de intentarlo nuevamente desde el navegador. |
| La llamada falla con un error de autorización | El inicio de sesión no se completó o las credenciales almacenadas han caducado. Desconecte el servidor en su cliente y vuelva a conectarlo para forzar un nuevo inicio de sesión. Reutilizar la conexión existente no volverá a autorizarla. |
| Funcionaba hace una hora y ahora no funciona | Los tokens de acceso tienen una duración limitada. Volver a conectar el servidor en su cliente resuelve este problema. |
El cliente se conecta pero algunas llamadas fallan
| Problema | Causa más probable |
| Se rechaza una llamada de administración | Pregunte al asistente con qué cuenta de ezeep está conectado. La respuesta incluye los roles de esa cuenta, lo que le permite comprobar si inició sesión con la identidad esperada. Si no es así, vuelva a conectarse con la cuenta correcta. |
| Una llamada de un conector devuelve un error genérico | El identificador del conector no existe. Solicite la lista de conectores y utilice un identificador de esa lista. |
| El estado del trabajo indica un identificador de trabajo no válido | El identificador se escribió incorrectamente o proviene de algo distinto del envío de un trabajo de impresión. Los identificadores de trabajo se devuelven cuando se envía un trabajo y son los únicos valores que acepta esta herramienta. |
Una llamada tiene éxito pero la respuesta parece incorrecta
| Problema | Causa más probable |
| Una impresora no tiene propiedades | Un identificador de impresora que no existe devuelve un resultado vacío en lugar de un error, por lo que el asistente puede informar de que «no hay propiedades» cuando la realidad es «no existe esa impresora». Solicite la lista de impresoras de ezeep, confirme que la impresora aparece en ella y vuelva a preguntar utilizando exactamente el nombre que aparece en la lista. |
| Una lista es más corta de lo que debería | Los grupos y conectores utilizan paginación y es posible que el asistente solo haya leído la primera página. Solicite el número total y compárelo, o pídale que obtenga las páginas restantes. |
| Preguntó qué tipos de archivos son compatibles y recibió una gran cantidad de configuración | La llamada subyacente devuelve toda la configuración de la plataforma, con las extensiones ocultas dentro de ella. Solicite específicamente las extensiones de archivo compatibles. |
| Un usuario dice que nunca recibió su invitación | Una llamada de invitación correcta crea la invitación, pero no garantiza su entrega. Una invitación cuyo correo electrónico no se pudo entregar puede seguir apareciendo como abierta con una fecha de caducidad futura. Compruebe su estado de entrega en el portal de administración antes de enviar otra. |
| Se aceptó un trabajo pero no se imprimió nada | El trabajo está en cola en su conector. Pregunte primero qué conectores de ezeep están desconectados, ya que un trabajo enviado a una impresora detrás de un conector desconectado se acepta y después queda esperando. Compruebe el estado del trabajo después de eso. |
Cuando el problema no está en el servidor MCP
Una conexión activa que muestra correctamente las impresoras significa que el servidor MCP está funcionando correctamente. En ese punto, un problema de impresión es un problema de impresión normal de ezeep. Compruebe el conector, la impresora y el trabajo en el portal de administración como lo haría con cualquier otro trabajo. MCP no cambia la forma en que se procesan los trabajos una vez enviados.
Herramientas del servidor MCP de ezeep explica qué devuelve cada herramienta, lo que resulta útil cuando una respuesta parece incorrecta en lugar de simplemente no aparecer.