Kalka общается с агентами по двум протоколам:
- MCP, Model Context Protocol: агент, запущенный в другом месте, например Claude Code в терминале или Cursor, использует инструменты Kalka, чтобы читать и править открытый документ.
- ACP, Agent Client Protocol: Kalka запускает агента для программирования в своей панели ИИ. См. Агенты в Kalka.
Эта страница — про MCP.
Встроенный сервер
У десктопного приложения есть собственный MCP-сервер. Он запускается вместе с Kalka, работает только на вашем компьютере и отвечает по адресу http://127.0.0.1:7600/mcp. Ничего устанавливать не нужно, и Kalka не ограничивает использование.
Подключить агента в один клик
Откройте Настройки › MCP. В разделе Подключить агента нажмите Подключить рядом со своим клиентом:
Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Antigravity, Kiro, Zed, LM Studio или opencode.
Kalka запишет конфигурацию клиента за вас, предварительно сохранив резервную копию файла рядом с ним. Перезапустите клиент, и инструменты Kalka появятся под именем kalka. Для Claude Desktop можно также выбрать Установить расширение.

Для любого другого клиента раздел Любой другой MCP-клиент показывает запись, которую нужно вставить в его настройки.
Чтобы проверить, что Claude Code видит Kalka:
claude mcp list
Что может агент
Агенты получают больше сотни инструментов. Самые востребованные:
| Инструмент | Что делает |
|---|---|
get_selection, get_page_tree |
Смотрит, что вы выделили и как устроена страница |
get_html |
Читает слои как HTML |
write_html |
Добавляет или заменяет слои, записывая HTML и CSS |
update_styles |
Меняет CSS слоёв |
get_screenshot |
Смотрит на результат, чтобы проверить работу |
get_design_guide |
Читает дизайн-процесс Kalka и список машинных привычек, которых стоит избегать |
ask_user |
Задаёт вам вопросы в Kalka, с ответами в один щелчок |
get_comments, reply_to_comment |
Читает ветки комментариев и отвечает в них |
list_settings, update_settings |
Меняет настройки Kalka, например тему или следование за агентами |
Агенты, написанные для MCP-сервера Figma, найдут знакомые инструменты с теми же именами: get_metadata, get_variable_defs и search_design_system. Скрипты для API плагинов Figma тоже работают с открытым документом — через use_figma.
Пока агент работает, его имя видно на холсте вместе с тем, что он делает, а его правки появляются блок за блоком. Отмена со стороны агента касается только его собственных шагов, никогда — ваших.
Что разрешено агентам
- Настройки › Доступ к инструментам включает и выключает каждый инструмент отдельно для встроенного ИИ и для MCP-клиентов. Инструменты разделены на те, что только читают, и те, что вносят изменения.
- Открывать только выделение в Настройки › MCP позволяет клиентам читать только выделенные слои и ничего больше, без инструментов правки.
- Требовать аутентификацию не даёт другим программам на вашем компьютере пользоваться сервером без его токена. По умолчанию включено.
- Корневой каталог MCP ограничивает папку, в которой инструменты могут читать и записывать файлы.
После изменения этих настроек перезапустите сервер кнопкой Перезапустить MCP-сервер.
Навык Kalka
Kalka поставляется с навыком для агентов: инструкциями, которые учат агента проектировать в Kalka, с дизайн-процессом и списком привычек, которых стоит избегать. Это папка skills/kalka в репозитории Kalka. Скопируйте её в папку навыков своего агента, например в ~/.claude/skills/kalka для Claude Code.
Подключения из Kalka к другим серверам
Встроенный ИИ тоже может пользоваться другими MCP-серверами, чтобы читать ваши спецификации, документацию или задачи, а не выдумывать содержимое. Добавьте их в Настройки › MCP › Подключения MCP по URL или по команде.
Командная строка
Команда kalka работает с файлами .fig, .kalka и .pen без запуска приложения или с открытым документом, если не указывать файл. Она экспортирует, исследует, проверяет линтером и запускает скрипты. Как пакет она пока не опубликована: запускайте её из клона репозитория Kalka с помощью Bun:
git clone https://github.com/leyscore/kalka.git
cd kalka
bun install
bun kalka --help
Если не подключается
См. Решение проблем, особенно если порт 7600 уже занят.