Guides

Cinq étapes, dans cet ordre

1. Installer et vérifier : le serveur, depuis un paquet ou un clone, testé. Sur un clone, la vérification est scripts/smoke_test.py, qui affiche result: conforming ; le paquet ne livre pas ce script.
2. Le navigateur : votre navigateur sur un profil qui lui est propre, son port de débogage sur l’interface de boucle locale, lancé par mcp-server-diwall-browser-setup browser ou par vous. Vérification : ss -ltn "sport = :9222" n’affiche que 127.0.0.1:9222 ou [::1]:9222.
3. Le répertoire chiffré et les identifiants : où le serveur écrit, et où il lit les mots de passe ; mcp-server-diwall-browser-setup le crée et l’ouvre. Vérification, une fois l’étape 5 faite : status indique mounted.
4. Le profil de l’opérateur : les sites que le serveur peut lire et sur lesquels il peut agir. Vérification, une fois l’étape 5 faite : status indique configured: true.
5. Brancher un client MCP : les quatorze outils, dans l’agent que vous choisissez. Vérification : status, appelé par le modèle, indique attached: true et confirmation_channel: native.

Les étapes 2 et 3 dépendent l’une de l’autre : le navigateur garde son profil dans le répertoire chiffré, il ne démarre donc qu’une fois le répertoire ouvert ; l’assistant d’installation les prend dans cet ordre. Chaque guide donne les commandes de son étape et vous renvoie à la section du guide de l’opérateur qui détient toutes les options. La disposition de chaque fichier que le serveur lit et écrit est en tête de ce guide : la disposition finale.

Étape 2 : le navigateur sur un profil qui lui est propre

Le serveur se rattache seulement à un navigateur lancé sur un profil dédié, jamais sur votre profil habituel, et il ne le lance ni ne le ferme. Le navigateur est lancé par vous ou, sur votre ordre, par l’assistant d’installation : le répertoire chiffré étant ouvert, mcp-server-diwall-browser-setup browser le lance sur le profil du volume, détaché de votre terminal. À la main, le répertoire du profil est dans le répertoire chiffré ouvert et le port de débogage est celui de votre profil d’opérateur :

google-chrome \
  --user-data-dir="$HOME/Vaults/Main/mcp-server-diwall-browser/browser-profile/chrome" \
  --remote-debugging-port=9222

chromium et brave-browser acceptent les deux mêmes options. Remplacez ~/Vaults/Main par l’endroit où vous ouvrez votre répertoire chiffré ; --user-data-dir doit être le browser.profile_dir de votre profil d’opérateur, et le port son browser.debug_port.

N’ajoutez jamais --remote-debugging-address : le port serait joignable depuis le réseau, et quiconque l’atteint contrôle le navigateur. Vérifiez qu’il écoute seulement sur l’interface de boucle locale :

ss -ltn "sport = :9222"

L’adresse locale doit être 127.0.0.1:9222 ou [::1]:9222, rien d’autre. Le serveur fait la même vérification, sur /proc/net/tcp et /proc/net/tcp6, à chaque rattachement, et refuse un port joignable de l’extérieur (debug_endpoint_not_loopback) ou un navigateur qui tourne sur son profil par défaut (profile_dir_is_default).

Connectez-vous ensuite une fois à chacun de vos sites dans ce navigateur, comme dans votre navigateur habituel. Le serveur travaille dans ces sessions.