Solucionar errores de Democruit MCP y revocar el acceso
Identifica errores de permisos, cuotas, límites de solicitudes y sesiones caducadas de Democruit MCP. Después, restablece la conexión o revoca el acceso del cliente.
Para recuperar una tarea fallida de Democruit MCP, primero identifica si el problema se debe a la autorización, los permisos, los datos de entrada de la herramienta, una cuota del producto o la frecuencia de las solicitudes. Cada caso requiere una solución distinta. Volver a conectarte no aumenta la cuota de tu plan, y cambiar de plan no corrige la falta de un permiso. Para detener el acceso de un cliente, abre los ajustes de Democruit, busca Agentes conectados y selecciona Revocar acceso.
Paso 1: Lee el error antes de volver a intentarlo
Anota el cliente, la herramienta solicitada, el mensaje de error y si la tarea ya había devuelto un resultado. Evita repetir una solicitud de escritura si no está claro qué resultado tuvo. Comprueba primero el estado del documento o de la acción afectada para no confundir una respuesta tardía con un cambio fallido.
Usa esta tabla para elegir el siguiente paso:
| Lo que ves | Categoría probable | Siguiente acción |
|---|---|---|
| Se requiere autorización o ha caducado | Credenciales de conexión | Inicia sesión o vuelve a autorizar, como se explica a continuación |
FORBIDDEN | La herramienta no está disponible con los permisos concedidos | Revisa los permisos de la conexión |
INVALID_ARGUMENTS | Faltan datos o no son válidos | Proporciona la referencia del documento o los datos requeridos |
| Un mensaje sobre el límite del plan con un enlace a los precios | Límite de uso de la función | Comprueba el límite de uso y los planes actuales |
| Un mensaje sobre el límite de solicitudes | Frecuencia de solicitudes | Reduce las solicitudes y las consultas de estado |
| Un enlace de confirmación en el panel | Aprobación pendiente | Revisa la acción en Democruit |
| Una carga o confirmación caducada | El flujo de trabajo temporal ha caducado | Inicia una nueva solicitud si aún la necesitas |
TOOL_EXECUTION_FAILED | Falló la operación de la herramienta | Lee el mensaje y comprueba el estado de la tarea antes de volver a intentarlo |
Antes de volver a intentarlo, elige una solución según el error recibido.
Paso 2: Restablece la autorización o corrige los permisos
Si falta la autorización, completa el flujo de inicio de sesión y consentimiento OAuth del cliente. Comprueba que el endpoint sea https://mcp.democruit.com/mcp y que estés conectando la cuenta correcta. La guía para conectar Claude, ChatGPT y Gemini explica cómo configurar cada cliente. En Gemini CLI, usa /mcp auth democruit cuando el servidor necesite autorización y, después, completa el inicio de sesión en el navegador.
Los tokens de acceso duran una hora. Un cliente puede renovar el acceso mientras su token de actualización siga siendo válido, por lo que la duración de una hora del token de acceso no significa necesariamente que tengas que iniciar sesión cada hora. Los tokens de actualización duran 30 días con vencimiento deslizante y 90 días con vencimiento absoluto si se usa offline_access, o siete días con vencimiento deslizante y 30 días con vencimiento absoluto si no se usa.
Si el token de actualización ha caducado o se revocó la conexión, vuelve a autorizarla. Los códigos de autorización duran cinco minutos. Reinicia el inicio de sesión si caduca un intercambio de códigos que aún no se había completado. No pegues tokens en un chat para intentar resolver un error de autorización.
Si aparece FORBIDDEN, revisa los permisos necesarios de la herramienta y los ámbitos concedidos al cliente. Los permisos de lectura y escritura son distintos para cada área del producto. Un flujo de trabajo combinado del kit de aplicaciones requiere permisos de escritura para el currículum, la carta de presentación y el ATS. Es posible que una conexión para una tarea más pequeña no incluya todos esos permisos. Solicita solo los permisos necesarios para el trabajo que quieras realizar.
Paso 3: Corrige los datos de entrada de la herramienta
Si aparece INVALID_ARGUMENTS, pide al asistente que revise los requisitos de entrada de la herramienta e identifique qué falta. Proporciona la referencia del documento seleccionado, la descripción del puesto u otros datos solicitados. No dejes que el asistente invente experiencia ni elija un documento basándose únicamente en un título dudoso.
La falta de datos de entrada no es un problema de facturación. Completa esos datos antes de considerar un cambio de plan. Si aparece TOOL_EXECUTION_FAILED, lee la explicación recibida y comprueba si existe un documento o una acción pendiente antes de intentar otra operación de escritura.
Paso 4: Comprueba la cuota del producto y el enlace para cambiar de plan
Una cuota del producto limita el uso de las funciones según tu plan de Democruit. MCP usa los mismos límites de uso del plan que la aplicación. Si una herramienta informa de que se alcanzó el límite del plan, comprueba el uso de la función afectada en tu cuenta. Consulta los precios de Democruit para comparar los límites disponibles antes de decidir si quieres cambiar de plan.
La disponibilidad y los límites de uso de las funciones dependen de tu plan actual. No des por hecho que todas las funciones de la aplicación tienen una herramienta MCP, ni que volver a conectarte, eliminar un documento o esperar un minuto restaurará una cuota de IA ya consumida.
Por ejemplo, volver a conectar Claude no restablece una cuota de verificaciones ATS agotada. Revisa el uso de ATS y los planes actuales antes de decidir cómo continuar. Después de cambiar de plan, comprueba el uso de la cuenta y vuelve a intentar la operación prevista una vez. Si sigue bloqueada, contacta con el equipo de soporte e incluye el error recibido.
Paso 5: Reduce las solicitudes si alcanzaste el límite
El límite estándar de la API es de 500 solicitudes por minuto, el mismo valor predeterminado que usa la aplicación Democruit. Los endpoints de registro OAuth y de tokens tienen límites más estrictos, por lo que las 500 solicitudes no son una cuota para volver a intentar iniciar sesión rápidamente. Reduce las solicitudes repetidas, sobre todo las consultas frecuentes mientras una tarea está en espera. Una respuesta HTTP 429 significa que se enviaron demasiadas solicitudes. Si se indica cuánto tiempo debes esperar para volver a intentarlo, respeta ese plazo y reduce la frecuencia antes de hacerlo. Un error de cuota o de límite de solicitudes también puede aparecer dentro de TOOL_EXECUTION_FAILED, así que lee la explicación en lugar de guiarte solo por ese código general.
Esperar a que se restablezca el límite de solicitudes no repone una cuota de producto agotada. Una conexión puede tener cuota disponible para una función y, aun así, enviar solicitudes con demasiada frecuencia. Comprueba qué límite describe realmente el error.
Una respuesta resumida es otro caso distinto. Las respuestas extensas se dividen en páginas de 20 elementos o se resumen, a menos que se indique detail=true. Continúa usando la información de paginación recibida o solicita los detalles si la tarea requiere el contenido completo. Una página corta, por sí sola, no indica que haya un error de cuota.
Paso 6: Resuelve una confirmación pendiente o una carga caducada
Las herramientas destructivas esperan una confirmación en el panel de Democruit. Abre el enlace recibido y revisa la acción exacta. El asistente puede consultar get_action_status. No debe informar que se completó una eliminación mientras siga pendiente de aprobación.
Una confirmación pendiente no es un error. El enlace de aprobación recibido abre la acción en Democruit. Revisa el objetivo antes de aprobarla. Si se rechaza la acción, aparece DENIED. Si no se toma una decisión, al final aparece EXPIRED.
La confirmación caduca a los diez minutos. Si aún quieres realizar la acción después de que caduque, inicia una nueva solicitud de confirmación y vuelve a revisarla. Las cargas también son válidas durante diez minutos y tienen un tamaño máximo de 10 MB. Los propósitos de importación de currículums y carga de ATS solo aceptan PDF. Si la carga anterior caduca, crea una nueva y usa el tipo de archivo solicitado sin superar el tamaño exacto permitido.
Paso 7: Desconecta y revoca el acceso
- Abre los ajustes de la cuenta de Democruit.
- Busca el cliente en Agentes conectados y revisa los ámbitos indicados.
- Selecciona Revocar acceso para la conexión que quieras detener.
- Espera el resultado que confirme que se revocó correctamente. Si la página de ajustes informa de un error, vuelve a intentarlo allí o contacta con el equipo de soporte.
- Elimina o desactiva el servidor de Democruit en tu cliente de IA si también quieres que deje de ofrecer herramientas o solicitar el inicio de sesión.
- Si vuelves a conectar ese cliente más adelante, completa la autorización y revisa de nuevo los ámbitos solicitados.
Revoca las credenciales en Democruit y, si ya no lo usas, elimina el servidor del cliente.
La revocación desactiva para tu cuenta la concesión de autorización del cliente, los tokens de acceso y los tokens de actualización. Eliminar una entrada del servidor en el cliente es un paso de configuración aparte. Usa el control Revocar acceso de Democruit para invalidar sus credenciales.
Revocar el acceso no elimina tu cuenta de Democruit ni tus documentos. Impide que se realicen futuras solicitudes autorizadas con esas credenciales. Si el cliente de IA ya recibió contenido, revisa su historial y los controles de datos. Esta revocación no establece reglas de eliminación ni de conservación de datos para otro servicio. Consulta la Política de privacidad para conocer las prácticas de datos publicadas por Democruit.
Si la tarea sigue bloqueada
Contacta con [email protected] e incluye el nombre del cliente, el nombre de la herramienta y el mensaje de error. Explica si estabas iniciando sesión, leyendo un documento, guardando un cambio o esperando una confirmación. No incluyas contraseñas, tokens ni contenido privado de documentos en el mensaje de soporte.