---
title: "MCP y ACP | Kalka docs"
description: "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."
url: https://kalka.design/es/docs/mcp
language: es
---

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](https://kalka.design/es/docs/agents#el-agente-de-programaci%C3%B3n-de-tu-ordenador).

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.

**Kalka tiene que estar abierto.** El servidor se ejecuta dentro de la app de escritorio y solo ve los documentos que abres en Kalka.

## 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`.

**Tus claves siguen siendo tuyas.** Un agente nunca puede leer ni cambiar tus claves de API, tus conexiones ni el acceso a herramientas.

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](https://github.com/leyscore/kalka/tree/main/skills/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](https://github.com/leyscore/kalka) con [Bun](https://bun.sh):

```
git clone https://github.com/leyscore/kalka.git
cd kalka
bun install
bun kalka --help
```

## Si no se conecta

Consulta [Solución de problemas](https://kalka.design/es/docs/troubleshooting#los-agentes-no-llegan-a-kalka), sobre todo si el puerto 7600 ya está en uso.
