1. Frictions : MCP et Skills ne se résument pas à deux fichiers
(1) Ordre de chargement opaque : sans hiérarchie claire entre /skills du workspace, dossiers utilisateur et skills embarqués, vous modifiez le disque pendant que l’agent lit encore une copie ancienne.(2) Snapshots Gateway en mémoire : certaines versions gardent des métadonnées en RAM ; un redémarrage partiel masque les changements disque.(3) Volume des schémas MCP : plusieurs serveurs injectent des descriptions d’outils énormes et saturent des fenêtres 16k–32k avant même le prompt utilisateur.(4) PATH du démon : sous launchd, les shims nvm/fnm de votre shell interactif disparaissent. Sur un Mac distant 24/7, l’écart est plus difficile à voir sans terminal ouvert en parallèle.
2. Priorité des répertoires Skills
Les éditeurs renomment parfois les chemins entre versions. Le tableau reflète l’intuition habituelle : les lignes supérieures doivent l’emporter. Croisez toujours avec la documentation de votre build exact et les journaux Gateway pour les chemins résolus.
| Couche (haut→bas) | Rôle | Point de contrôle |
|---|---|---|
/skills workspace ou skills projet | Flux d’équipe, automatisation repo | Le cwd Gateway pointe-t-il sur le bon workspace ? |
| Skills utilisateur | Expérimentation personnelle | Une indentation YAML incorrecte peut faire ignorer tout le fichier |
| Défauts fournis | Capacités produit | Lire les notes de version après upgrade |
3. MCP : boucle minimale et budget de jetons
Branchez d’abord un seul serveur MCP, validez auth, santé et un appel d’outil minimal. Ajoutez ensuite les autres en mesurant la longueur sérialisée des définitions. Quand system+tools approche du plafond, réduisez la surface par profils par canal, déportez des outils vers des sous-agents ou changez de modèle—plutôt que d’empiler des connecteurs et d’accuser le modèle de base.
4. Check-list en cinq étapes
Étape 1 : noter dans les logs la racine workspace et les dossiers Skills scannés.Étape 2 : insérer une chaîne visible dans une SKILL, redémarrer complètement Gateway, vérifier citation dans le chat.Étape 3 : désactiver tous les MCP, n’en activer qu’un, mesurer les jetons tools, puis réactiver un par un.Étape 4 : comparer PATH/variables du job supervisé (launchctl print) avec votre shell interactif.Étape 5 : forcer l’expiration OAuth en préproduction et observer si l’échec est bruyant ou silencieux.
5. Matrice symptômes après redémarrage
| Symptôme | Cause probable | Action |
|---|---|---|
| Modifs SKILL ignorées | Autre couche prioritaire | Journaliser le chemin de recherche ; grep marqueur unique |
| Nombre d’outils instable | Échec MCP avalé | Niveau debug ; activer serveur par serveur |
| Outil manquant par intermittence | Jeton/OAuth expiré | Réauthentifier ; vérifier refresh dans l’environnement démon |
| Contexte plein sans long prompt | Empilement de gros schémas | Réduire MCP ; fragmenter sessions ; changer modèle |
Repères opérationnels :
- Sur modèles 16k, les descriptions MCP non filtrées dépassent souvent 10k jetons au total.
- Pour l’hébergement continu, coder des chemins absolus d’interpréteurs dans la plist.
- Chaque nouveau canal public (bot IM, webhook) doit déclencher un réaudit des outils exposés.
6. Analyse : la gouvernance des outils devient l’exploitation
Le MCP rend les intégrations composables mais gonfle consommation de contexte et surface d’autorisation. Contrairement aux microservices classiques, le LLM peut reprogrammer les outils à chaque tour ; si les filtres de politique retardent sur l’enregistrement des schémas, vous payez deux fois—en jetons et en risque. macOS sur Apple Silicon accueille bien les gateways silencieuses, mais la mémoire unifière ressent aussi canaux multiples et sessions longues : ce n’est pas la même charge que quelques onglets de chat, car les définitions d’outils persistent côté system.
Séparer le portable créatif (itérations rapides) de la passerelle de production (MCP figés) réduit le rayon d’explosion tout en conservant la stack macOS/Metal. Le portable reste idéal pour prototyper, mais il mélange veille, logiciels personnels et bande montante variable avec des SLA partagés.
Quand la bande montante stable, l’hygiène des démons et la supervision 24/7 deviennent le goulot, héberger OpenClaw sur des nœuds Mac distants MACGPU préserve le même écosystème tout en clarifiant PATH et disponibilité ; la facturation à l’usage facilite les canaris avant engagement fixe. Ce n’est pas une injonction marketing : pour workflows graphiques et IA continues, un Mac distant dédié simplifie souvent les SLA par rapport à un laptop quotidien.