> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consumo y solución de problemas

> Consulte el consumo y resuelva problemas de acceso, proyectos, conectores, entornos remotos, tareas y Git.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

## Consulte el consumo

En **Settings → Usage**, puede consultar la actividad del gateway en un mapa de calor de 30 días, los totales diarios de tokens y solicitudes y el desglose por modelo.

La corrección del checkout puede generar varias solicitudes al modelo: una para decidir qué investigar y otras para analizar los archivos y los resultados de las pruebas. Cada llamada contribuye a los totales de solicitudes y tokens. Una tarea no equivale necesariamente a una solicitud; consulte la cronología para ver las acciones del agente.

Pase el cursor sobre un día para examinar su actividad y use **Refresh** para actualizar. Las tarjetas de coste o presupuesto aparecen solo cuando el servicio proporciona esos datos. Una tarjeta ausente no significa saldo cero ni actividad gratuita.

## Localice dónde se detuvo la tarea

Empiece por la última acción fallida de la cronología. Un error del gateway, un fallo de comando y una aprobación pendiente requieren respuestas distintas:

| Síntoma | Primera comprobación |
| - | - |
| Sin respuesta o modelos | Cuenta, URL del gateway y **Test connection**. |
| Herramienta esperando | Pregunta o aprobación pendiente. |
| Comando fallido | Salida completa, carpeta y herramientas instaladas. |
| Error de conector | Autorización, **Test** y acceso al recurso. |
| Respuesta completa con resultado inesperado | Diff, pruebas o estado real del navegador. |

Después de corregir la causa, pida repetir la comprobación concreta: «Las dependencias ya están instaladas. Ejecute npm test otra vez e informe del resultado». Así obtiene una verificación nueva sin dar por bueno el intento anterior.

<Frame caption="Test connection confirma el acceso y muestra los modelos disponibles. Este ejemplo usa un gateway local de demostración.">
  <ScreenshotCrop src="/images/mka1-code/guides/troubleshooting.jpg" alt="Prueba de conexión correcta con un modelo disponible" width={2720} height={1660} x={1030} y={30} cropWidth={1080} cropHeight={520} maxWidth="100%" />
</Frame>

## Solución de problemas

Revise el mensaje de error en la aplicación o en el resultado de la herramienta y busque el síntoma correspondiente.

Con la CLI instalada, `mka1-code doctor` comprueba el entorno de ejecución del agente, la cuenta, el catálogo de modelos del gateway, los conectores y la configuración del terminal. Lea los resultados individuales, incluidas las advertencias, para localizar el problema. Para un conector, ejecute también **Test** en **Extensions**; comprueba la conexión y la detección de las herramientas del servidor.

<AccordionGroup>
  <Accordion title="El inicio de sesión no se completa">
    Si el navegador no se abrió, vuelva a abrir la página de autorización desde la aplicación. Si el código caducó, elija **Request a new code** y autorice de nuevo. Una sesión de cuenta caducada requiere volver a iniciar sesión. Ante un error de conexión, compruebe la URL del servidor y su conexión de red antes de reintentar.
  </Accordion>

  <Accordion title="Un comando del proyecto no encuentra una herramienta o dependencia">
    Compruebe la salida del comando y la carpeta seleccionada para la sesión. Las herramientas de compilación y pruebas y las dependencias deben estar instaladas en el entorno que ejecuta la tarea. Para SSH, WSL o Docker, compruebe ese entorno. Un nuevo worktree puede necesitar los pasos habituales de configuración antes de ejecutar pruebas.
  </Accordion>

  <Accordion title="Un conector no está disponible o no aparecen sus herramientas">
    En **Settings → Extensions**, compruebe que el conector esté habilitado, complete el acceso o la configuración solicitada y elija **Test**. Examine el error o las herramientas descubiertas. Los cambios de configuración se aplican en la siguiente ejecución del agente; la ejecución activa termina con la configuración anterior.
  </Accordion>

  <Accordion title="El entorno remoto no se conecta">
    Confirme que existen el destino y la carpeta del proyecto. Para SSH, establezca primero una conexión desde el terminal y asegúrese de que la autenticación no requiere una solicitud interactiva. Para Docker, compruebe que el contenedor esté en ejecución y sea accesible mediante su contexto de Docker. Examine el error del diálogo para identificar herramientas ausentes o entornos no admitidos.
  </Accordion>

  <Accordion title="Una tarea programada no se ejecutó">
    Compruebe que la programación esté habilitada, que la aplicación siguiera ejecutándose y que el ordenador estuviera activo. Consulte el historial: la coincidencia de trabajos en una misma programación o proyecto puede provocar que se omita una ejecución, y el modo de permisos guardado puede requerir su atención. Las ocurrencias perdidas no se reintentan automáticamente.
  </Accordion>

  <Accordion title="Falló un commit o un envío">
    Resuelva el error de Git que muestra el diálogo. Si los archivos o el área de preparación cambiaron durante la revisión, elija **Refresh changes** y seleccione los archivos de nuevo. Resuelva conflictos de merge y termine las operaciones de Git pendientes antes de crear el commit. Si solo falló el envío, use **Retry push** para enviar el commit local existente.
  </Accordion>

  <Accordion title="El selector de modelos está vacío">
    En **Settings → Connection**, pruebe la credencial y compruebe la URL. Guarde los cambios y actualice el catálogo. Si la autenticación funciona pero no hay modelos, pregunte al administrador cuáles están habilitados para la cuenta. Introduzca un ID manual solo si lo proporciona el equipo responsable.
  </Accordion>

  <Accordion title="No se utiliza una preferencia del proyecto">
    En **Settings → Projects**, compruebe cuenta, carpeta y estado de la memoria. Cada worktree tiene sus preferencias; una clave API por sí sola no activa memoria. Si un cambio interrumpió el turno, reenvíe la solicitud. Consulte [Memoria del proyecto](/es/docs/mka1-code/memory).
  </Accordion>

  <Accordion title="No se abre una vista previa de documento">
    Compruebe que el archivo existe dentro de la carpeta local y usa un formato admitido. Elija **Try again** o **Refresh preview** tras regenerarlo. No hay vista previa en sesiones remotas o en la nube. Abra archivos protegidos o no admitidos en su aplicación original.
  </Accordion>
</AccordionGroup>

## Comunique un problema reproducible

Incluya la versión de **Settings → About**, sistema operativo, entorno local o remoto y pasos del fallo. Copie el error relevante y describa lo esperado. Para la CLI, incluya la comprobación fallida de `mka1-code doctor`.

Un informe útil delimita un fallo: «En una sesión local, Test connection devuelve este error después de iniciar sesión y el selector sigue vacío». Quite claves API, códigos de autorización, datos personales y contenido ajeno al problema antes de compartir capturas o registros.