Kalka
Dokumentacja

MCP i ACP

Podłącz Claude Code, Cursor, Codex, Claude Desktop i innych klientów MCP do wbudowanego serwera Kalki, zdecyduj, co mogą robić, i zainstaluj umiejętność agenta Kalka.

docs / mcp

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.

Ustawienia, karta MCP: sekcja Połącz agenta i wpis serwera do wklejenia w dowolnym innym kliencie MCP
Ustawienia › MCP. W aplikacji na komputer powyżej widać klientów znalezionych na komputerze, każdego z przyciskiem Połącz.

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.