Kalka
Documentación

MCP y ACP

Conecta Claude Code, Cursor, Codex, Claude Desktop y otros clientes MCP al servidor integrado de Kalka, elige qué pueden hacer e instala la skill de agente de Kalka.

docs / mcp

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.

Ajustes, pestaña MCP: la sección Conectar un agente y una entrada de servidor para pegar en cualquier otro cliente MCP
Ajustes › MCP. En la app de escritorio, arriba aparecen los clientes encontrados en tu ordenador, cada uno con Conectar.

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.