Kalka
Документация

MCP и ACP

Подключите Claude Code, Cursor, Codex, Claude Desktop и другие MCP-клиенты к встроенному серверу Kalka, выберите, что им разрешено, и установите навык агента Kalka.

docs / mcp

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: раздел «Подключить агента» и запись сервера для вставки в любой другой MCP-клиент
Настройки › MCP. В десктопном приложении выше перечислены клиенты, найденные на вашем компьютере, у каждого — кнопка «Подключить».

Для любого другого клиента раздел Любой другой 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 уже занят.