Kalka rozmawia z agentami w dwóch protokołach:
- MCP, Model Context Protocol: agent uruchomiony gdzie indziej, na przykład Claude Code w terminalu albo Cursor, używa narzędzi Kalki, żeby czytać i edytować otwarty dokument.
- ACP, Agent Client Protocol: Kalka uruchamia agenta programistycznego we własnym panelu AI. Zobacz Agenci w Kalce.
Ta strona dotyczy MCP.
Wbudowany serwer
Aplikacja na komputer ma własny serwer MCP. Uruchamia się razem z Kalką, działa tylko na twoim komputerze i odpowiada pod adresem http://127.0.0.1:7600/mcp. Nie trzeba niczego instalować, a Kalka nie nakłada limitów użycia.
Podłączanie agenta jednym kliknięciem
Otwórz Ustawienia › MCP. W sekcji Połącz agenta kliknij Połącz obok swojego klienta:
Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Antigravity, Kiro, Zed, LM Studio lub opencode.
Kalka sama zapisze konfigurację klienta, po zrobieniu kopii zapasowej pliku obok niego. Uruchom klienta ponownie, a narzędzia Kalki pojawią się pod nazwą kalka. Dla Claude Desktop możesz też wybrać Zainstaluj rozszerzenie.

Dla każdego innego klienta Inny klient MCP pokazuje wpis do wklejenia w jego ustawieniach.
Żeby sprawdzić, czy Claude Code widzi Kalkę:
claude mcp list
Co może agent
Agenci dostają ponad sto narzędzi. Najczęściej używane:
| Narzędzie | Do czego służy |
|---|---|
get_selection, get_page_tree |
Sprawdza zaznaczenie i budowę strony |
get_html |
Czyta warstwy jako HTML |
write_html |
Dodaje lub zastępuje warstwy, pisząc HTML i CSS |
update_styles |
Zmienia CSS warstw |
get_screenshot |
Ogląda wynik, żeby sprawdzić pracę |
get_design_guide |
Czyta proces projektowy Kalki i listę maszynowych nawyków, których należy unikać |
ask_user |
Zadaje ci pytania w Kalce, z odpowiedziami do kliknięcia |
get_comments, reply_to_comment |
Czyta wątki komentarzy i na nie odpowiada |
list_settings, update_settings |
Zmienia ustawienia Kalki, takie jak motyw lub śledzenie agentów |
Agenci napisani dla serwera MCP Figmy znajdą znane sobie narzędzia pod tymi samymi nazwami: get_metadata, get_variable_defs i search_design_system. Skrypty napisane dla API wtyczek Figmy też działają na otwartym dokumencie, przez use_figma.
Gdy agent pracuje, jego imię widać na płótnie razem z tym, co robi, a jego zmiany pojawiają się blok po bloku. Cofanie przez agenta sięga tylko jego własnych kroków, nigdy twoich.
Decyduj, co mogą robić agenci
- Ustawienia › Dostęp do narzędzi włącza i wyłącza każde narzędzie, osobno dla wbudowanego AI i dla klientów MCP. Narzędzia są podzielone na tylko do odczytu i takie, które coś zmieniają.
- Udostępniaj tylko zaznaczenie w Ustawienia › MCP pozwala klientom czytać tylko zaznaczone warstwy, bez narzędzi do edycji.
- Wymagaj uwierzytelnienia nie pozwala innym programom na twoim komputerze korzystać z serwera bez jego tokena. Jest domyślnie włączone.
- Katalog główny MCP ogranicza folder, w którym narzędzia mogą czytać i zapisywać pliki.
Po zmianie tych ustawień uruchom serwer ponownie przyciskiem Uruchom serwer MCP ponownie.
Umiejętność Kalka
Kalka ma umiejętność dla agentów: instrukcje, które uczą agenta projektowania w Kalce, z procesem projektowym i listą nawyków do unikania. To folder skills/kalka w repozytorium Kalki. Skopiuj go do folderu umiejętności swojego agenta, na przykład ~/.claude/skills/kalka dla Claude Code.
Połączenia z Kalki do innych serwerów
Wbudowane AI może też korzystać z innych serwerów MCP, żeby czytać twoje specyfikacje, dokumentację czy zgłoszenia, zamiast wymyślać treść. Dodaj je w Ustawienia › MCP › Połączenia MCP, przez URL lub polecenie.
Wiersz poleceń
Polecenie kalka działa na plikach .fig, .kalka i .pen bez otwierania aplikacji albo na otwartym dokumencie, gdy pominiesz plik. Eksportuje, sprawdza, lintuje i uruchamia skrypty. Nie jest jeszcze opublikowane jako pakiet: uruchom je z klonu repozytorium Kalki za pomocą Bun:
git clone https://github.com/leyscore/kalka.git
cd kalka
bun install
bun kalka --help
Gdy nie ma połączenia
Zobacz Rozwiązywanie problemów, zwłaszcza gdy port 7600 jest już zajęty.