---
title: "Solución de problemas | Kalka docs"
description: "Soluciones para los avisos del primer arranque en macOS y Windows, Linux, las actualizaciones, el puerto MCP, el guardado automático en el navegador y cómo informar de un error."
url: https://kalka.design/es/docs/troubleshooting
language: es
---

## macOS no abre Kalka

Las versiones beta aún no están firmadas con un certificado de Apple Developer, así que macOS bloquea el primer arranque.

- Abre Kalka una vez y deja que macOS lo rechace.

- Abre **Ajustes del Sistema › Privacidad y seguridad**.

- Baja hasta el mensaje sobre Kalka y haz clic en **Abrir igualmente**.

- Confirma con tu contraseña o con Touch ID. Kalka se abre, y macOS no volverá a preguntar para esta versión.

**¿«Kalka está dañado y no se puede abrir»?** La descarga quedó en cuarentena; Kalka no está dañado.

Quita la marca de cuarentena en Terminal y vuelve a abrirlo:

```
xattr -dr com.apple.quarantine /Applications/Kalka.app
```

## Windows SmartScreen bloquea el instalador

SmartScreen avisa de los instaladores que ha visto pocas veces, y las versiones beta aún no están firmadas. En la ventana azul «Windows protegió su PC», haz clic en **Más información** y luego en **Ejecutar de todas formas**.

## Linux

Kalka se distribuye como AppImage. Si no arranca al hacer doble clic, hazlo ejecutable primero:

```
chmod +x Kalka-*.AppImage
```

En Windows y Linux, el menú de Kalka está dentro de la ventana en lugar de en una barra de menús del sistema.

## Las actualizaciones no se instalan en macOS

Un Kalka sin firmar no puede reemplazarse a sí mismo en macOS. La ventana **Actualización de software** lo indica y ofrece **Descargar**: instala el nuevo `.dmg` encima del Kalka antiguo en Aplicaciones. Tus documentos y ajustes se mantienen.

## Los agentes no llegan a Kalka

El servidor MCP se ejecuta dentro de la app de escritorio, en el puerto 7600. Kalka tiene que estar abierto para que los agentes lleguen a él.

- **«Otro programa usa el puerto 7600»** en **Ajustes › MCP**: otro programa ocupa el puerto, a menudo un servidor de desarrollo de Kalka que se quedó abierto u otra copia de Kalka. Ciérralo y vuelve a iniciar el servidor desde Ajustes.

- **«El servidor MCP no respondió a tiempo»** o **«El servidor MCP no es accesible»**: comprueba que Kalka está abierto y reinicia tu agente para que vuelva a conectarse.

- **«El servidor MCP rechazó la conexión local»**: reinicia Kalka; genera un nuevo token local.

Consulta [MCP y ACP](https://kalka.design/es/docs/mcp) para saber cómo conectar cada agente.

## El guardado automático pide permiso en el navegador

En Chrome y Edge, una página web solo puede escribir un archivo en tu disco con tu permiso. Cuando activas el guardado automático para un archivo que abriste desde el disco, el navegador pregunta una vez. Si lo rechazas, Kalka no puede guardar automáticamente y te lo dice. Los navegadores sin acceso a archivos, como Safari y Firefox, descargan una copia cada vez que guardas.

## Las versiones no funcionan

El panel Historial necesita la app de escritorio, un documento guardado en tu ordenador y Git instalado. En macOS, instala Git con `xcode-select --install`; en Windows, desde [git-scm.com](https://git-scm.com). Para publicar versiones en línea, tu ordenador ya tiene que poder hacer push a ese repositorio con Git.

## Demasiado movimiento

En **Ajustes › General**, en Apariencia, **Animaciones** puede seguir el ajuste de movimiento reducido de tu sistema o desactivar las animaciones. **Reducir las animaciones de agentes** muestra de golpe las capas nuevas de un agente en lugar de hacerlas aparecer bloque a bloque.

_Ajustes, pestaña General: idioma, tema, animaciones, Reducir las animaciones de agentes, tu nombre y la recuperación tras un cierre inesperado_

Ajustes › General, con Animaciones, Reducir las animaciones de agentes y la recuperación tras un cierre inesperado.

## Recuperar trabajo perdido

Si Kalka se cerró antes de que guardaras, vuelve a abrirlo: te ofrece restaurar los documentos sin guardar. Consulta [Archivos y versiones](https://kalka.design/es/docs/files-versions).

## Informar de un error

Abre una incidencia en [github.com/leyscore/kalka/issues](https://github.com/leyscore/kalka/issues). Si Kalka no arranca, su pantalla de error tiene un enlace **Report a problem** que abre la incidencia con tu versión y tu sistema ya rellenados. Cuenta qué hiciste, qué esperabas y qué pasó; un archivo o una captura de pantalla ayudan mucho.
