LeServiteur Desk centre d'aide

Présentation : comment ça marche

LeServiteur Desk permet à votre client IA (Claude Desktop ou Claude Code) de travailler sur votre ordinateur : il pilote des pages web dans Chrome et, sur le bureau, regarde l'écran et manipule les fenêtres. Il s'exécute sur votre propre machine.

Une licence est un petit fichier (leserviteur-license.jwt). Le logiciel refuse de démarrer sans licence valide. Une licence couvre une machine.

1. Achetez une licence dans le portail client. Durées : mensuel 33,20 $, trimestriel 87,15 $, annuel 249 $.
2. Ouvrez la page produit de votre tableau de bord et téléchargez le fichier de licence et l'installateur de votre système.
3. Installez, puis placez le fichier de licence là où le logiciel l'attend.
4. Au premier démarrage, la machine active la licence auprès de notre service de licences et lui est rattachée. Ensuite, le logiciel vérifie la licence de temps en temps.
5. Pointez votre client IA vers LeServiteur et demandez-lui une tâche à faire sur votre bureau.

Retour en haut

Configuration requise

• Windows : Windows 11 x64. Windows 10 n'est pas testé. Node et Python sont inclus, rien à installer.
• Linux : Ubuntu ou Debian, x64, installation avec apt, dans une session X11. Les sessions Wayland ne sont pas prises en charge.
• Un client MCP : Claude Desktop ou Claude Code. L'installateur Windows enregistre LeServiteur dans Claude Desktop pour vous.
• Google Chrome, uniquement pour les outils navigateur. Le contrôle du bureau fonctionne sans.
• Un fichier de licence issu du portail.
• Un accès Internet pour l'activation et la vérification de la licence.

Retour en haut

Acheter et télécharger

1. Connectez-vous au portail et ouvrez Produits, puis LeServiteur Desk. Choisissez une durée et payez. Une licence est valable pour une machine.
2. Une fois l'achat terminé, la même page affiche votre licence avec un bouton Download licence. Il enregistre le fichier leserviteur-license.jwt.
3. À côté se trouvent deux boutons : Download for Windows (.exe) et Download for Linux (.deb). Le paquet Linux est destiné à Ubuntu et Debian x64 avec une session X11.
4. Les installateurs ne sont proposés que tant que vous détenez une licence active. Les téléchargements sont limités à 10 par heure et par compte.

Conservez le fichier de licence. Vous pouvez le télécharger à nouveau depuis la même page tant que la licence est active.

Retour en haut

Installer sous Windows

1. Lancez l'installateur téléchargé (leserviteur-setup-<version>-client.exe). Il demande les droits administrateur car il s'installe pour tous les utilisateurs et enregistre une tâche à l'ouverture de session.
2. Si LeServiteur est déjà installé, on vous demande quoi faire : conserver mes paramètres et ma licence (par défaut, mise à jour sur place), le supprimer complètement d'abord, ou le supprimer complètement et quitter.
3. Acceptez le contrat de licence.
4. Sur la page du jeton de licence, choisissez votre fichier .jwt. Si vous la laissez vide, l'installation se termine mais le serveur ne démarrera pas tant que le fichier n'est pas dans %USERPROFILE%\.leserviteur\license.jwt. Les versions antérieures à 1.12.8 utilisaient %USERPROFILE%\.gnomemcp ; installer 1.12.8 ou plus récent le déplace pour vous.
5. Choisissez comment LeServiteur voit l'écran : utiliser Claude Code sur cette machine (rien à télécharger ; le clic par coordonnées en pixels n'est pas disponible dans ce mode), télécharger un modèle et l'exécuter ici (environ 2,5 Go, une seule fois), utiliser notre modèle hébergé, ou pointer vers un endpoint compatible OpenAI que vous exploitez déjà. Modifiable plus tard dans le tableau de bord.
6. Laissez l'accès réseau local désactivé, sauf si un serveur MCP sur un autre hôte doit piloter cette machine. Activé : l'agent de bureau écoute sur toutes les interfaces et ouvre une règle de pare-feu sur le port 8889. Désactivé : cette machine uniquement.
7. Terminez l'assistant. L'installateur crée un jeton d'agent propre à la machine, enregistre une tâche à l'ouverture de session et ajoute une entrée leserviteur à %APPDATA%\Claude\claude_desktop_config.json sans toucher à vos autres serveurs MCP.

Après l'installation

• Ouvrez une session sur le bureau Windows. Rien de ce qui regarde l'écran ne fonctionne avant : l'agent de bureau s'exécute à l'ouverture de session, dans votre session, volontairement.
• Ouvrez le tableau de bord local depuis l'icône LeServiteur de la barre des tâches, Open dashboard. Il montre le serveur, l'agent de bureau, le modèle de vision et la licence, et permet d'installer ou de remplacer la licence sans réinstaller.
• Redémarrez Claude Desktop pour qu'il relise sa configuration.

Désinstaller

Paramètres, Applications, LeServiteur, ou l'entrée Uninstall LeServiteur du menu Démarrer. Elle demande une seule fois s'il faut supprimer %USERPROFILE%\.leserviteur et votre dossier de données. La réponse par défaut est Non.

Retour en haut

Installer sous Linux (autonome)

C'est le paquet proposé par le portail : leserviteur_<version>_amd64.deb. Le serveur s'exécute sur votre machine et votre client MCP le lance à la demande.

1. Ouvrez une session X11. Wayland n'est pas pris en charge.
2. Installez le paquet depuis le dossier où vous l'avez enregistré :

sudo apt install ./leserviteur_<version>_amd64.deb

3. Placez votre fichier de licence :

mkdir -p ~/.leserviteur
cp ~/Downloads/leserviteur-license.jwt ~/.leserviteur/license.jwt

Le paquet recommande tesseract-ocr, ffmpeg, xinput, tmux et libnotify-bin, qu'apt installe par défaut. Ils servent à des outils optionnels comme la lecture de texte à l'écran et l'enregistrement. Un outil dont l'auxiliaire manque le signale au lieu d'échouer.

Sous Linux, il n'y a ni icône de barre des tâches, ni tableau de bord, ni service en arrière-plan : le serveur démarre quand votre client MCP lance /usr/bin/leserviteur-mcp. Pour le retirer : sudo apt remove leserviteur. Votre dossier ~/.leserviteur est conservé.

Retour en haut

Édition cloud pour Linux

L'édition cloud donne à un serveur LeServiteur hébergé la main sur votre bureau X11. C'est un autre paquet, leserviteur-cloud, qui ne peut pas être installé avec le paquet autonome leserviteur. Le bouton de téléchargement du portail propose le paquet autonome ; si on vous a remis le paquet cloud, suivez ces étapes.

1. Installez-le :

sudo apt install ./leserviteur-cloud_<version>_amd64.deb

Il installe deux unités systemd utilisateur, leserviteur-agent (capture d'écran et saisie dans votre session graphique) et leserviteur-connector (relie ce bureau au serveur hébergé), les active pour tous les utilisateurs et fournit /usr/bin/leserviteur-mcp. Ce sont des unités utilisateur volontairement : la capture et la saisie doivent vivre dans votre session graphique.

2. Placez votre licence dans ~/.leserviteur/license.jwt et créez ~/.leserviteur/config.json avec l'adresse de votre serveur hébergé (les versions antérieures à 1.12.8 utilisaient ~/.gnomemcp ; à partir de 1.12.8 il est déplacé au premier démarrage) :

{
  "edition": "cloud",
  "serverUrl": "https://<adresse-de-votre-serveur>"
}

3. Redémarrez le connecteur :

systemctl --user restart leserviteur-connector

Tant que les deux fichiers n'existent pas, le connecteur est ignoré au lieu de boucler en erreur. L'agent crée son propre jeton (~/.leserviteur/agent.token) au premier démarrage. Le connecteur active votre licence auprès de https://mcp.leserviteur.net et se signale régulièrement par un heartbeat.

Vérifiez que les deux tournent :

systemctl --user status leserviteur-agent leserviteur-connector

Une unité qui échoue à chaque démarrage s'arrête après 5 essais en 60 secondes. Corrigez la cause, puis exécutez systemctl --user reset-failed et redémarrez-la.

Retour en haut

Activer la licence et connecter votre client IA

Activation

L'activation se fait toute seule la première fois que le logiciel démarre avec votre fichier de licence sur une machine connectée à Internet. Le service de licences enregistre la machine et lui remet un bail de courte durée que le logiciel renouvelle pendant son exécution. Vous n'avez rien d'autre à saisir.

La page de votre licence dans le portail affiche ensuite la machine sous Activated machines.

Claude Code

Sous Linux, enregistrez le lanceur comme serveur MCP, puis redémarrez Claude Code :

claude mcp add leserviteur --scope user -- /usr/bin/leserviteur-mcp

Claude Desktop et autres clients

Sous Windows, l'installateur a déjà ajouté l'entrée : redémarrez Claude Desktop. Pour tout autre client qui lit une configuration mcpServers, utilisez le lanceur comme commande (sous Linux, les paquets autonome et cloud fournissent tous deux /usr/bin/leserviteur-mcp) :

{
  "mcpServers": {
    "leserviteur": {
      "command": "/usr/bin/leserviteur-mcp"
    }
  }
}

Les clients MCP lisent leur liste de serveurs au démarrage : redémarrez le client lui-même après modification, pas seulement la conversation.

Vérifier que ça marche

Demandez à votre client quelque chose que seul le bureau peut répondre, par exemple : Fais une capture de mon bureau et dis-moi quelles fenêtres sont ouvertes. Pour le navigateur : Ouvre https://example.com, fais un snapshot et dis-moi ce que dit la page. Vous n'appelez pas les outils à la main : vous demandez, le client choisit l'outil.

Si le client dit qu'un outil n'existe pas, cette famille d'outils n'est pas activée ou le client n'a pas été redémarré.

Retour en haut

Machines, renouvellement et révocation

Machines

• Une licence est rattachée à une machine.
• Le changement de machine est limité : une licence peut changer de machine deux fois par année de licence, comptée à partir de sa date d'émission.
• Pour libérer une machine que vous n'utilisez plus (portable hors service, réinstallation), ouvrez la licence dans le portail et cliquez sur Release seat à côté de la machine sous Activated machines. La machine doit s'activer à nouveau pour utiliser la licence.
• Une machine qui échoue au contrôle de concurrence attend 900 secondes (15 minutes) avant de pouvoir réessayer.

Renouvellement

• Le renouvellement s'ouvre avant l'expiration de la licence : 7 jours avant pour une licence mensuelle, 14 jours pour une trimestrielle, 30 jours pour une annuelle. La page de la licence indique la date.
• Un renouvellement commence une nouvelle période le jour du paiement ; il n'est donc proposé que lorsque la période en cours touche à sa fin.
• Lorsqu'il est disponible, la page de la licence propose aussi un interrupteur de renouvellement automatique.
• Après renouvellement, téléchargez le nouveau fichier de licence et remplacez l'ancien : sous Windows depuis le tableau de bord (installer ou remplacer la licence) ou dans %USERPROFILE%\.leserviteur\license.jwt, sous Linux dans ~/.leserviteur/license.jwt. Puis redémarrez votre client MCP.

Révocation

Si une licence est révoquée dans le portail, les machines s'arrêtent à leur prochaine vérification de licence (au moins une fois par jour). Une machine qui ne peut pas joindre le service de licences continue de fonctionner au plus 30 jours après sa dernière vérification réussie, ou jusqu'à l'expiration de la licence si elle arrive avant.

Retour en haut

Dépannage

Les messages d'erreur sont affichés en anglais par le logiciel ; ils sont reproduits tels quels.

Retour en haut

Contact

Écrivez à contact@leserviteur.com ou utilisez la page de contact. Indiquez le nom de la licence affiché dans le portail, votre système d'exploitation et le message exact affiché. N'envoyez jamais le fichier de licence lui-même.

Retour en haut