Ce qu'un agent de programmation attend de Docker
Un agent qui travaille sur un vrai projet pose toujours les mêmes questions : qu'est-ce qui tourne, quelle application utilise le port 3000, pourquoi ce conteneur s'est-il arrêté, que disent les journaux, puis-je exécuter les tests dans un environnement jetable ? Avec un simple shell, il y répond en exécutant docker ps, docker inspect et docker logs, puis en lisant chaque ligne renvoyée. Cela fonctionne, mais c'est lent et coûteux : du JSON brut et des centaines de lignes de journaux entrent dans le contexte du modèle à chaque tour.
Un serveur MCP transforme ces questions en outils qui renvoient directement la réponse. Les outils d'Oxcart suivent les questions, plutôt que les points d'accès de l'API Docker : un seul appel remplace ainsi une chaîne de commandes.
Les 13 outils
| Intention | Outils | Niveau minimal qui les affiche |
|---|---|---|
| Voir | status, projects, ports, images, logs | Read only |
| Expliquer | diagnose : codes de sortie, arrêts par manque de mémoire, contrôles de santé en échec, problèmes de ports et lignes de journaux pertinentes | Read only |
| Agir | container (démarrer, arrêter, redémarrer), exec, compose (up, down), sandbox sans réseau | Manage |
| Modifier et nettoyer | build, remove, cleanup (aperçu préalable), sandbox avec réseau | Full |
status affiche chaque projet Compose avec son dossier, sa branche Git et ses URL localhost, pour que « l'application sur le port 3000 » désigne la même chose pour vous et votre agent. Les clients abonnés aux ressources sont informés d'un plantage, d'un arrêt par manque de mémoire ou d'un changement d'état de santé dès qu'il survient, sans interrogation répétée.
Des réponses plus petites, des sessions moins chères
Ce que lit un agent pour répondre à chaque question : Oxcart face à la sortie de la CLI docker qu'il lirait autrement, mesurés au même instant sur les mêmes conteneurs :
| Question | MCP Oxcart | Équivalent avec la CLI docker | CLI docker | Facteur de réduction |
|---|---|---|---|---|
| Pourquoi ce conteneur s'est-il arrêté ? | 159 | inspect + logs --tail 300 | 2,014 | 13× |
| Des erreurs dans les 500 dernières lignes de journaux ? | 39 | logs --tail 500 | 703 | 18× |
| Qu'est-ce qui tourne ? | 106 | ps -a + stats --no-stream + compose ls -a | 332 | 3,1× |
Cinq conteneurs de test (un qui plante, un dont le contrôle de santé échoue, un arrêté par manque de mémoire, un projet Compose, un port publié). Les réponses de diagnose et logs gardent la même taille, quelle que soit la longueur des journaux. La liste d'outils elle-même coûte 510 tokens une fois par session au niveau lecture seule (6 outils), et 1,463 avec les 13 outils.
Les sessions complètes montrent la même tendance. Claude Code avec Claude Opus 5.5 a répondu à deux questions courantes, une fois avec la seule CLI docker et une fois avec le serveur MCP d'Oxcart. Les deux variantes ont donné les bonnes réponses aux deux questions.
| Tâche | Temps | Coût | Tokens | Tours |
|---|---|---|---|---|
« worker produit-il des erreurs ? Donne-moi l'erreur. » | 4.2 s contre 31.0 s | $0.022 contre $0.157 | 10,686 contre 52,266 | 2 contre 8 |
« Mon conteneur api n'arrête pas de planter. Pourquoi ? » | 8.5 s contre 14.9 s | $0.036 contre $0.070 | 11,283 contre 19,510 | 2 contre 4 |
Une session par tâche avec et sans Oxcart, sur des conteneurs de test synthétiques, Oxcart 0.1.0 : uniquement à titre indicatif. Le coût dépend de la mise en cache des prompts et l'ordre des exécutions n'a pas été alterné.
Configurer le serveur MCP d'Oxcart dans n'importe quel agent de programmation
- Installez Oxcart. Téléchargez Oxcart (puce Apple, macOS 26 ou ultérieur) et ouvrez-le. La configuration se fait hors ligne et prend quelques secondes.
- Copiez la phrase de configuration. Ouvrez MCP Integrations dans la barre latérale d'Oxcart et copiez la phrase : « Configure le serveur MCP d'Oxcart pour moi : exécute
/Applications/Oxcart.app/Contents/Helpers/oxcart agent setupet suis ses instructions. » - Collez-la dans votre agent. Collez-la dans Claude Code, Codex, Cursor ou tout agent capable d'exécuter des commandes. L'agent exécute la commande, lit les étapes qui lui correspondent et enregistre un serveur nommé
oxcart. - Posez des questions sur vos conteneurs. Demandez « qu'est-ce qui tourne ? » ou « pourquoi
apis'est-il arrêté ? ». L'agent apparaît sur la page MCP Integrations, en lecture seule, avec chaque appel dans son journal d'activité. - Augmentez le niveau si vous le souhaitez. Passez l'agent à Manage pour l'autoriser à démarrer, arrêter, exécuter des commandes avec exec et utiliser Compose, ou à Full pour construire, supprimer et nettoyer. Block refuse tous les appels.
Si votre agent ne peut pas exécuter de commandes (Claude Desktop, LM Studio et applications similaires), Oxcart affiche à la place un extrait JSON à ajouter aux paramètres MCP de l'application. Pour Claude Code, la commande directe est :
claude mcp add -s user oxcart -- /Applications/Oxcart.app/Contents/Helpers/oxcart mcp --client claude-codePour Codex, codex mcp add oxcart -- /Applications/Oxcart.app/Contents/Helpers/oxcart mcp --client codex enregistre le serveur pour la CLI Codex et l'extension IDE.
Des niveaux d'autorisation réglables par agent
| Niveau | L'agent peut |
|---|---|
| Read only (par défaut) | Voir les conteneurs, journaux, ports, projets et images ; diagnostiquer les échecs |
| Manage | Également démarrer, arrêter et redémarrer, exécuter des commandes, Compose up et down, lancer des environnements isolés sans réseau |
| Full | Également construire, supprimer et nettoyer, et donner un accès réseau aux environnements isolés |
| Block | Rien : aucun outil affiché, chaque appel refusé et le motif communiqué à l'agent |
Les outils au-dessus du niveau de l'agent ne sont pas affichés du tout, ce qui réduit aussi son contexte. Chaque appel est consigné sur votre Mac et affiché sur la page MCP Integrations ; rien ne quitte le Mac. Les niveaux régissent ce que les outils d'Oxcart font pour un agent. Ce n'est pas un environnement isolé : un agent capable d'exécuter des commandes shell peut toujours lancer docker lui-même. Associez donc ces niveaux aux autorisations de commandes propres à votre agent.
Agents disposant d'instructions de configuration
Claude Code, Claude Desktop, Codex, Cursor, VS Code avec Copilot, Devin Desktop, Zed, Gemini CLI, GitHub Copilot CLI, OpenCode, Cline, Junie, JetBrains AI Assistant, Goose, Kiro, Amp, Warp et LM Studio, plus une étape pour tout autre client MCP. Les étapes proviennent de votre copie installée d'Oxcart (oxcart agent setup), avec les chemins réels de votre Mac : elles fonctionnent donc hors ligne et correspondent à votre version.
Des conteneurs pour les workflows d'agents au-delà de MCP
- Dev Containers : exécutez l'agent dans un Dev Container pour que son shell, ses outils et son réseau restent dans le conteneur du projet. Oxcart exécute la CLI Dev Containers ; voir Dev Containers et Testcontainers sur Mac.
- Des cycles de développement rapides : les agents lancent et suppriment sans cesse des conteneurs. Oxcart a mesuré 42 ms pour
docker run --rmet 77 ms pour arrêter et supprimer 20 conteneurs, les meilleurs résultats des trois environnements testés (comparatifs). - Stacks Compose : l'outil
composede l'agent démarre et arrête les projets au niveau Manage ; voir Docker Compose sur puce Apple.
Questions
Existe-t-il un serveur MCP pour les conteneurs Docker sur Mac ?
Oui. Oxcart inclut oxcart mcp, un serveur MCP stdio local avec 13 outils pour l'état, le diagnostic, les journaux, les ports, les images, exec, Compose, les constructions, les environnements isolés et le nettoyage. Il n'écoute sur aucun port réseau et ne nécessite aucun jeton d'authentification.
Comment connecter Claude Code à mes conteneurs Docker ?
Collez la phrase de configuration d'Oxcart dans Claude Code ou exécutez claude mcp add -s user oxcart -- /Applications/Oxcart.app/Contents/Helpers/oxcart mcp --client claude-code. Claude Code affiche alors le serveur oxcart et peut appeler ses outils.
Est-ce compatible avec Codex, Cursor et VS Code avec Copilot ?
Oxcart fournit des étapes de configuration pour 18 clients nommés, dont Codex, Cursor, VS Code avec Copilot, Claude Desktop, Zed, Gemini CLI, GitHub Copilot CLI, Cline, Goose, Kiro, Amp, Warp et LM Studio, ainsi qu'une étape générique pour tout autre client MCP. Claude Code est le client qui a été testé de bout en bout.
L'agent peut-il supprimer mes conteneurs ou volumes ?
Pas par défaut. Chaque agent commence en lecture seule. Vous pouvez passer chaque agent individuellement à Manage ou Full, ou le bloquer avec Block. Au niveau Full, cleanup renvoie d'abord un aperçu et un jeton de confirmation, puis ne supprime que les éléments de cet aperçu. Les niveaux régissent les outils d'Oxcart ; ils ne constituent pas un environnement isolé. Un agent disposant d'un accès shell peut donc toujours exécuter directement la CLI docker.
Pourquoi ne pas simplement laisser l'agent exécuter des commandes docker ?
Cela fonctionne, mais l'agent lit beaucoup de sortie brute. Répondre à « pourquoi ce conteneur s'est-il arrêté ? » a demandé 159 tokens via l'outil diagnose d'Oxcart contre 2,014 pour docker inspect plus docker logs --tail 300 : 13× moins. Dans une session Claude Code par tâche (à titre indicatif), trouver une erreur dans les journaux a pris 4.2 s au lieu de 31.0 s.
Le serveur MCP envoie-t-il mes données quelque part ?
Non. Il communique uniquement avec le socket local du moteur et n'établit aucune connexion réseau de son propre chef. Chaque appel est écrit dans un journal d'activité sur votre Mac. Les images sont toujours téléchargées depuis les registres lorsqu'un outil démarre ou construit quelque chose qui en a besoin, comme le ferait docker run.
Mon agent peut-il exécuter du code dans un conteneur jetable ?
Oui, avec l'outil sandbox : un conteneur jetable sans réseau, sauf si l'agent est au niveau Full et le demande, limité à 2 GiB de mémoire et 1,024 processus.
Sources et méthode
- Taille des réponses : mesurée le 2026-10-10 avec cinq conteneurs de test ; tokens estimés comme caractères ÷ 4.
- Sessions : Claude Code 2.1.296 avec
claude-opus-5-5, Oxcart 0.1.0, une exécution par tâche et par variante. - Chiffres de vitesse : Oxcart 0.1.2, 2026-10-10, Apple M5 Max, 8 CPU et 12 GiB ; les environnements comparés ont été mesurés plus tôt le même jour, sur le même Mac et avec le même dispositif de mesure, avec le client docker 29.4.