Kalka habla dos protocolos con los agentes:
- MCP, el Model Context Protocol: un agente que se ejecuta en otro sitio, como Claude Code en tu terminal o Cursor, usa las herramientas de Kalka para leer y editar el documento abierto.
- ACP, el Agent Client Protocol: Kalka ejecuta un agente de programación dentro de su propio panel de IA. Consulta Agentes en Kalka.
Esta página trata de MCP.
El servidor integrado
La app de escritorio tiene su propio servidor MCP. Arranca con Kalka, se ejecuta solo en tu ordenador y responde en http://127.0.0.1:7600/mcp. No hay nada que instalar y Kalka no pone ningún límite de uso.
Conectar un agente con un clic
Abre Ajustes › MCP. En Conectar un agente, haz clic en Conectar junto a tu cliente:
Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Antigravity, Kiro, Zed, LM Studio u opencode.
Kalka escribe la configuración del cliente por ti, después de guardar una copia de seguridad del archivo a su lado. Reinicia el cliente y las herramientas de Kalka aparecen con el nombre kalka. Para Claude Desktop también puedes usar Instalar extensión.

Para cualquier otro cliente, Cualquier otro cliente MCP muestra la entrada que debes pegar en sus ajustes.
Para comprobar que Claude Code ve Kalka:
claude mcp list
Qué puede hacer un agente
Los agentes reciben más de cien herramientas. Las que más usan:
| Herramienta | Qué hace |
|---|---|
get_selection, get_page_tree |
Ver qué has seleccionado y cómo está construida la página |
get_html |
Leer capas como HTML |
write_html |
Añadir o reemplazar capas escribiendo HTML y CSS |
update_styles |
Cambiar el CSS de las capas |
get_screenshot |
Mirar el resultado para revisar el trabajo |
get_design_guide |
Leer el proceso de diseño de Kalka y su lista de costumbres de máquina que hay que evitar |
ask_user |
Hacerte preguntas en Kalka, con respuestas para hacer clic |
get_comments, reply_to_comment |
Leer hilos de comentarios y responderlos |
list_settings, update_settings |
Cambiar ajustes de Kalka, como el tema o seguir a los agentes |
Los agentes escritos para el servidor MCP de Figma encuentran las herramientas que conocen, con los mismos nombres: get_metadata, get_variable_defs y search_design_system. Los scripts escritos para la API de plugins de Figma también se ejecutan en el documento abierto, mediante use_figma.
Mientras un agente trabaja, su nombre aparece en el lienzo con lo que está haciendo, y sus ediciones aparecen bloque a bloque. Deshacer lo de un agente solo alcanza sus propios pasos, nunca los tuyos.
Elegir qué pueden hacer los agentes
- Ajustes › Acceso a herramientas activa o desactiva cada herramienta, por separado para la IA integrada y para los clientes MCP. Las herramientas se dividen entre las de solo lectura y las que cambian cosas.
- Compartir solo la selección, en Ajustes › MCP, deja que los clientes lean las capas seleccionadas y nada más, sin herramientas de edición.
- Requerir autenticación impide que otros programas de tu ordenador usen el servidor sin su token. Está activado por defecto.
- Directorio raíz MCP limita la carpeta en la que las herramientas pueden leer y escribir archivos.
Después de cambiar estos ajustes, reinicia el servidor con Reiniciar servidor MCP.
La skill de Kalka
Kalka incluye una skill de agente: instrucciones que enseñan a un agente a diseñar en Kalka, con el proceso de diseño y la lista de costumbres que evitar. Es la carpeta skills/kalka del repositorio de Kalka. Cópiala en la carpeta de skills de tu agente, por ejemplo ~/.claude/skills/kalka para Claude Code.
Conexiones de Kalka a otros servidores
La IA integrada también puede usar otros servidores MCP, para leer tus especificaciones, documentos o tickets en lugar de inventarse el contenido. Añádelos en Ajustes › MCP › Conexiones MCP, por URL o por comando.
La línea de comandos
El comando kalka trabaja con archivos .fig, .kalka y .pen sin abrir la app, o con el documento abierto si omites el archivo. Exporta, inspecciona, revisa y ejecuta scripts. Todavía no está publicado como paquete: ejecútalo desde un clon del repositorio de Kalka con Bun:
git clone https://github.com/leyscore/kalka.git
cd kalka
bun install
bun kalka --help
Si no se conecta
Consulta Solución de problemas, sobre todo si el puerto 7600 ya está en uso.