---
title: "MCP et ACP | Kalka docs"
description: "Connecter Claude Code, Cursor, Codex, Claude Desktop et d’autres clients MCP au serveur intégré de Kalka, choisir ce qu’ils ont le droit de faire, et installer le skill d’agent Kalka."
url: https://kalka.design/fr/docs/mcp
language: fr
---

Kalka parle deux protocoles avec les agents :

- **MCP**, le Model Context Protocol : un agent qui tourne ailleurs, comme Claude Code dans votre terminal ou Cursor, utilise les outils de Kalka pour lire et modifier le document ouvert.

- **ACP**, l’Agent Client Protocol : Kalka fait tourner un agent de code dans son propre panneau IA. Voir [Les agents dans Kalka](https://kalka.design/fr/docs/agents#lagent-de-code-sur-votre-ordinateur).

Cette page parle de MCP.

## Le serveur intégré

L’app desktop a son propre serveur MCP. Il démarre avec Kalka, tourne uniquement sur votre ordinateur et répond à l’adresse `http://127.0.0.1:7600/mcp`. Il n’y a rien à installer, et Kalka n’impose aucune limite d’usage.

**Kalka doit être ouvert.** Le serveur tourne dans l’app desktop et ne voit que les documents que vous ouvrez dans Kalka.

## Connecter un agent en un clic

Ouvrez **Paramètres › MCP**. Sous **Connecter un agent**, cliquez sur **Connecter** à côté de votre client :

Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Antigravity, Kiro, Zed, LM Studio ou opencode.

Kalka écrit la configuration du client pour vous, après avoir gardé une sauvegarde du fichier juste à côté. Redémarrez le client, et les outils de Kalka apparaissent sous le nom `kalka`. Pour Claude Desktop, vous pouvez aussi utiliser **Installer l’extension**.

_Paramètres, onglet MCP : la section Connecter un agent et une entrée de serveur à coller dans n’importe quel autre client MCP_

Paramètres › MCP. Dans l’app desktop, les clients trouvés sur votre ordinateur sont listés au-dessus, chacun avec Connecter.
Pour tout autre client, **Tout autre client MCP** affiche l’entrée à coller dans ses réglages.

Pour vérifier que Claude Code voit Kalka :

```
claude mcp list
```

## Ce qu’un agent peut faire

Les agents disposent de plus d’une centaine d’outils. Ceux qu’ils utilisent le plus :

| Outil | Ce qu’il fait |
| --- | --- |
| get_selection, get_page_tree | Voir ce que vous avez sélectionné et comment la page est construite |
| get_html | Lire des calques en HTML |
| write_html | Ajouter ou remplacer des calques en écrivant du HTML et du CSS |
| update_styles | Modifier le CSS de calques |
| get_screenshot | Regarder le résultat, pour vérifier le travail |
| get_design_guide | Lire la démarche de design de Kalka et sa liste de réflexes « faits à la machine » à éviter |
| ask_user | Vous poser des questions dans Kalka, avec des réponses à cliquer |
| get_comments, reply_to_comment | Lire les fils de commentaires et y répondre |
| list_settings, update_settings | Changer des réglages de Kalka comme le thème ou Suivre les agents |

Les agents écrits pour le serveur MCP de Figma retrouvent les outils qu’ils connaissent, sous les mêmes noms : `get_metadata`, `get_variable_defs` et `search_design_system`. Les scripts écrits pour l’API de plugins de Figma tournent aussi sur le document ouvert, via `use_figma`.

**Vos clés restent les vôtres.** Un agent ne peut jamais lire ni modifier vos clés d’API, vos connexions ou l’accès aux outils.

Pendant qu’un agent travaille, son nom s’affiche sur le canvas avec ce qu’il est en train de faire, et ses modifications apparaissent bloc par bloc. Annuler depuis un agent n’atteint que ses propres étapes, jamais les vôtres.

## Choisir ce que les agents peuvent faire

- **Paramètres › Accès aux outils** active ou désactive chaque outil, séparément pour l’IA intégrée et pour les clients MCP. Les outils sont classés en outils en lecture seule et outils qui modifient.

- **Partager uniquement la sélection**, dans **Paramètres › MCP**, permet aux clients de lire les calques sélectionnés et rien d’autre, sans aucun outil de modification.

- **Exiger une authentification** empêche les autres programmes de votre ordinateur d’utiliser le serveur sans son jeton. C’est activé par défaut.

- **Répertoire racine MCP** limite le dossier où les outils peuvent lire et écrire des fichiers.

Redémarrez le serveur avec **Redémarrer le serveur MCP** après avoir modifié ces réglages.

## Le skill Kalka

Kalka fournit un skill d’agent : des instructions qui apprennent à un agent à concevoir dans Kalka, avec la démarche de design et la liste des réflexes à éviter. C’est le dossier `skills/kalka` du [dépôt Kalka](https://github.com/leyscore/kalka/tree/main/skills/kalka). Copiez-le dans le dossier des skills de votre agent, par exemple `~/.claude/skills/kalka` pour Claude Code.

## Connexions de Kalka vers d’autres serveurs

L’IA intégrée peut aussi utiliser d’autres serveurs MCP, pour lire vos specs, vos docs ou vos tickets au lieu d’inventer du contenu. Ajoutez-les dans **Paramètres › MCP › Connexions MCP**, par URL ou par commande.

## La ligne de commande

La commande `kalka` travaille sur des fichiers `.fig`, `.kalka` et `.pen` sans ouvrir l’app, ou sur le document ouvert si vous ne précisez pas de fichier. Elle exporte, inspecte, vérifie et lance des scripts. Elle n’est pas encore publiée en package : lancez-la depuis un clone du [dépôt Kalka](https://github.com/leyscore/kalka) avec [Bun](https://bun.sh) :

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

## Quand la connexion échoue

Voir [Dépannage](https://kalka.design/fr/docs/troubleshooting#les-agents-ne-joignent-pas-kalka), en particulier quand le port 7600 est déjà utilisé.
