---
title: "MCP и ACP | Kalka docs"
description: "Подключите Claude Code, Cursor, Codex, Claude Desktop и другие MCP-клиенты к встроенному серверу Kalka, выберите, что им разрешено, и установите навык агента Kalka."
url: https://kalka.design/ru/docs/mcp
language: ru
---

Kalka общается с агентами по двум протоколам:

- **MCP**, Model Context Protocol: агент, запущенный в другом месте, например Claude Code в терминале или Cursor, использует инструменты Kalka, чтобы читать и править открытый документ.

- **ACP**, Agent Client Protocol: Kalka запускает агента для программирования в своей панели ИИ. См. [Агенты в Kalka](https://kalka.design/ru/docs/agents#%D0%B0%D0%B3%D0%B5%D0%BD%D1%82-%D0%B4%D0%BB%D1%8F-%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D0%BD%D0%B0-%D0%B2%D0%B0%D1%88%D0%B5%D0%BC-%D0%BA%D0%BE%D0%BC%D0%BF%D1%8C%D1%8E%D1%82%D0%B5%D1%80%D0%B5).

Эта страница — про MCP.

## Встроенный сервер

У десктопного приложения есть собственный MCP-сервер. Он запускается вместе с Kalka, работает только на вашем компьютере и отвечает по адресу `http://127.0.0.1:7600/mcp`. Ничего устанавливать не нужно, и Kalka не ограничивает использование.

**Приложение Kalka должно быть открыто.** Сервер работает внутри десктопного приложения и видит только документы, открытые в 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`.

**Ваши ключи остаются вашими.** Агент никогда не может прочитать или изменить ваши API-ключи, подключения или доступ к инструментам.

Пока агент работает, его имя видно на холсте вместе с тем, что он делает, а его правки появляются блок за блоком. Отмена со стороны агента касается только его собственных шагов, никогда — ваших.

## Что разрешено агентам

- **Настройки › Доступ к инструментам** включает и выключает каждый инструмент отдельно для встроенного ИИ и для MCP-клиентов. Инструменты разделены на те, что только читают, и те, что вносят изменения.

- **Открывать только выделение** в **Настройки › MCP** позволяет клиентам читать только выделенные слои и ничего больше, без инструментов правки.

- **Требовать аутентификацию** не даёт другим программам на вашем компьютере пользоваться сервером без его токена. По умолчанию включено.

- **Корневой каталог MCP** ограничивает папку, в которой инструменты могут читать и записывать файлы.

После изменения этих настроек перезапустите сервер кнопкой **Перезапустить MCP-сервер**.

## Навык Kalka

Kalka поставляется с навыком для агентов: инструкциями, которые учат агента проектировать в Kalka, с дизайн-процессом и списком привычек, которых стоит избегать. Это папка `skills/kalka` в [репозитории Kalka](https://github.com/leyscore/kalka/tree/main/skills/kalka). Скопируйте её в папку навыков своего агента, например в `~/.claude/skills/kalka` для Claude Code.

## Подключения из Kalka к другим серверам

Встроенный ИИ тоже может пользоваться другими MCP-серверами, чтобы читать ваши спецификации, документацию или задачи, а не выдумывать содержимое. Добавьте их в **Настройки › MCP › Подключения MCP** по URL или по команде.

## Командная строка

Команда `kalka` работает с файлами `.fig`, `.kalka` и `.pen` без запуска приложения или с открытым документом, если не указывать файл. Она экспортирует, исследует, проверяет линтером и запускает скрипты. Как пакет она пока не опубликована: запускайте её из клона [репозитория Kalka](https://github.com/leyscore/kalka) с помощью [Bun](https://bun.sh):

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

## Если не подключается

См. [Решение проблем](https://kalka.design/ru/docs/troubleshooting#%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D1%8B-%D0%BD%D0%B5-%D0%BC%D0%BE%D0%B3%D1%83%D1%82-%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B8%D1%82%D1%8C%D1%81%D1%8F-%D0%BA-kalka), особенно если порт 7600 уже занят.
