---
title: "MCP i ACP | Kalka docs"
description: "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."
url: https://kalka.design/pl/docs/mcp
language: pl
---

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](https://kalka.design/pl/docs/agents#agent-programistyczny-na-twoim-komputerze).

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.

**Kalka musi być otwarta.** Serwer działa wewnątrz aplikacji na komputer i widzi tylko dokumenty otwarte w Kalce.

## 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`.

**Twoje klucze zostają twoje.** Agent nigdy nie może odczytać ani zmienić twoich kluczy API, połączeń ani dostępu do narzędzi.

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](https://github.com/leyscore/kalka/tree/main/skills/kalka). 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](https://github.com/leyscore/kalka) za pomocą [Bun](https://bun.sh):

```
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](https://kalka.design/pl/docs/troubleshooting#agenci-nie-mog%C4%85-po%C5%82%C4%85czy%C4%87-si%C4%99-z-kalk%C4%85), zwłaszcza gdy port 7600 jest już zajęty.
