---
title: "MCP と ACP | Kalka docs"
description: "Claude Code、Cursor、Codex、Claude Desktop などの MCP クライアントを Kalka の内蔵サーバーに接続し、許可する操作を選び、Kalka のエージェントスキルをインストールします。"
url: https://kalka.design/ja/docs/mcp
language: ja
---

Kalka はエージェントと 2 つのプロトコルでやり取りします。

- **MCP**（Model Context Protocol）：ターミナルの Claude Code や Cursor など、別の場所で動くエージェントが Kalka のツールを使い、開いているドキュメントを読んで編集します。

- **ACP**（Agent Client Protocol）：Kalka が自分の AI パネルの中でコーディングエージェントを動かします。[Kalka のエージェント](https://kalka.design/ja/docs/agents)を参照してください。

このページでは 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
```

## エージェントにできること

エージェントは 100 を超えるツールを使えます。よく使われるものは次のとおりです。

| ツール | できること |
| --- | --- |
| 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 の設定を変える |

Figma の MCP サーバー向けに書かれたエージェントは、`get_metadata`、`get_variable_defs`、`search_design_system` など、見慣れたツールを同じ名前で使えます。Figma のプラグイン API 向けのスクリプトも、`use_figma` を通じて開いているドキュメントで動きます。

**キーはあなたのものです。**エージェントが API キー、接続、ツールへのアクセス設定を読んだり変えたりすることはできません。

エージェントの作業中は、その名前と作業内容がキャンバスに表示され、編集はブロックごとに現れます。エージェントによる取り消しは、そのエージェント自身のステップにしか及ばず、あなたの操作は取り消しません。

## エージェントに許可する操作を選ぶ

- **設定 › ツールへのアクセス** では、各ツールのオンとオフを、内蔵の AI と MCP クライアントで別々に切り替えます。ツールは読み取り専用のものと、変更を加えるものに分かれています。

- **設定 › MCP** の **選択範囲のみ共有** を使うと、クライアントは選択したレイヤーしか読めず、編集ツールも使えません。

- **認証を要求** は、コンピューター上のほかのプログラムがトークンなしでサーバーを使うのを防ぎます。標準でオンです。

- **MCP ルートディレクトリ** で、ツールがファイルを読み書きできるフォルダを制限します。

これらを変更したら、**MCP サーバーを再起動** でサーバーを再起動してください。

## Kalka スキル

Kalka にはエージェントスキルが付属しています。Kalka でのデザイン方法をエージェントに教える指示で、デザインプロセスと避けるべき癖のリストが入っています。[Kalka リポジトリ](https://github.com/leyscore/kalka/tree/main/skills/kalka)の `skills/kalka` フォルダです。エージェントのスキルフォルダにコピーしてください。Claude Code なら、たとえば `~/.claude/skills/kalka` です。

## Kalka からほかのサーバーへの接続

内蔵の AI はほかの MCP サーバーも使えるので、内容をでっち上げずに、仕様書、ドキュメント、チケットを読み込めます。**設定 › MCP › MCP接続** で、URL またはコマンドを指定して追加します。

## コマンドライン

`kalka` コマンドは、アプリを開かずに `.fig`、`.kalka`、`.pen` ファイルを扱います。ファイルを省略すると、開いているドキュメントが対象になります。書き出し、検査、リント、スクリプトの実行ができます。まだパッケージとしては公開していないので、[Bun](https://bun.sh) を使って [Kalka リポジトリ](https://github.com/leyscore/kalka)のクローンから実行します。

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

## 接続できないとき

[トラブルシューティング](https://kalka.design/ja/docs/troubleshooting)を参照してください。ポート 7600 がすでに使われている場合の対処も載っています。
