Pont MCP
Les agents parlent à la fenêtre via le Model Context Protocol, à travers une socket Unix et un petit sidecar. Aucun port réseau, aucun compte, aucun relais dans le cloud.
Chaîne
client agent ──stdio JSON-RPC──► spark-mcp (sidecar)
│ socket Unix
▼
fenêtre Spark (attachMcp)
│
▼
runtime / registre / workspacesrc-tauri/src/bin/spark-mcp.rsest déclaré comme binaire externe et livré dans le bundle.- Le serveur Rust crée
run/mcp.sockdans le dossier de configuration, en0600. attachMcptransmet chaque ligne à la fenêtre et renvoie la réponse.- Si Spark est fermé, le pont répond
spark_not_runninget sert la dernière liste d’outils connue, pour qu’un client n’ait pas à redémarrer.
Outils
| Outil | Rôle |
|---|---|
spark_brief | Résumé court de l’onglet actif ou ciblé. |
spark_tabs | Onglets et leur mode de disposition. |
spark_tiles | Catalogue compact des types de tuiles, actions et disponibilité ; detail: "full" ajoute descriptions et schémas. |
spark_tab_open | Crée un onglet en arrière-plan. |
spark_tab_close | Ferme un onglet ; refusé si un document non enregistré s’y oppose. |
spark_tab_focus | Active un onglet. |
spark_tile_open | Ouvre une tuile et renvoie sa référence. |
spark_tile_read | Lit la surface, les données et les actions d’une tuile. |
spark_tile_call | Exécute une action déclarée. |
spark_tile_close | Ferme une tuile. |
spark_tile_move | Place une tuile à côté d’une autre, ou comme onglet de son groupe. |
spark_tile_resize | Donne à une tuile une largeur ou une hauteur en fraction de l’onglet. |
spark_undo | Annule une opération de disposition. |
spark_redo | Rétablit une opération de disposition. |
spark_events_since | Reprend le journal depuis une séquence. |
La liste est volontairement stable : un client la met en cache et la rafraîchit mal. Ce qui varie, ce sont les actions, découvertes par tuile avec spark_tiles etspark_tile_read.
Contrats
- Résultats bornés. Une action qui renvoie plus de 16 000 caractères est refusée ; elle doit renvoyer un identifiant ou un résumé.
- Surfaces.
api.tiles.publishest un résumé volatil de 2 000 caractères, jamais persisté. - Guides. Le guide d’un type de tuile fait au plus 1 200 caractères et n’est livré qu’une fois par session, au premier catalogue ou à la première lecture.
- Services. Une action qui déclare
requiresest masquée quand le service manque, et refusée à l’appel. - Mutations. Une action marquée
mutatesest annoncée comme telle puis exécutée ; demander confirmation revient au client qui appelle. - Attribution. Toute action passée par
spark_tile_callest journalisée avecsource: "agent". - Focus. Les onglets ouverts par un agent restent en arrière-plan et affichent un point discret dans la barre jusqu’à leur ouverture.
- Contenu. Aucune action MCP ne lit ou n’écrit le contenu d’un terminal, et aucune ne renvoie un document.
Brancher un client
{
"mcpServers": {
"spark": {
"command": "/Applications/Spark.app/Contents/MacOS/spark-mcp"
}
}
}Le chemin absolu est celui affiché par l’engrenage en bas du rail, sousConnecter un agent…, avec un bouton pour copier. Spark détecte aussi une commande d’agent connue dans un terminal et propose d’écrire la configuration du client en un clic ; la session en cours voit le serveur à son redémarrage suivant.
Cycle de vie
registry.subscribeToolsémetnotifications/tools/list_changedquand une extension est activée, désactivée ou importée.spark_tilesest recalculé à chaque appel : une nouvelle extension apparaît sans redémarrer le client.- Le sidecar met en cache la liste d’outils pour répondre quand la fenêtre est fermée. Un nouvel outil noyau demande quand même une nouvelle session côté client.