Vue d'ensemble#
@lebureau/mcp@0.1.0 livre 18 outils, groupes par domaine. Chaque outil requiert une capability specifique sur la cle API que lb-mcp utilise.
Au demarrage, lb-mcp appelle /v1/me pour lire les capabilities attachees a votre cle. Il enregistre ensuite uniquement les outils dont la capability requise est presente sur la cle. Les outils que vous ne pouvez pas utiliser n'apparaissent jamais dans la liste d'outils de l'assistant. Cela garde la surface du prompt reduite et evite que l'assistant choisisse un outil qui ne ferait que retourner un 403.
Si vous changez les capabilities (en revoquant la cle et en en creant une nouvelle avec un autre jeu de scopes), redemarrez votre client MCP pour qu'il relance lb-mcp et relise /v1/me.
Bureaux -- lecture#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktops_list | desktop:read | Liste tous les bureaux appartenant a l'utilisateur authentifie. |
desktops_get | desktop:read | Recupere les details complets d'un bureau par son id. |
Bureaux -- cycle de vie#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktops_start | desktop:lifecycle | Demarre (ou reprend) un bureau arrete. |
desktops_stop | desktop:lifecycle | Arrete proprement un bureau en cours d'execution. Etat et disque preserves. |
desktops_restart | desktop:lifecycle | Redemarre un bureau en cours d'execution. |
Bureaux -- execution et capture#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktop_exec_python | desktop:control | Execute du code Python sur le runtime de l'agent du bureau. Renvoie stdout, stderr et le code de sortie. |
desktop_screenshot | desktop:control | Prend une capture d'ecran du bureau. Renvoie une image PNG. |
Bureaux -- controle souris et clavier#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktop_click | desktop:control | Clique aux coordonnees indiquees. |
desktop_type | desktop:control | Saisit du texte. |
desktop_key | desktop:control | Appuie sur une touche du clavier (nom xdotool, par exemple Return, ctrl+a). |
desktop_scroll | desktop:control | Fait defiler la vue. |
desktop_drag | desktop:control | Glisser-deposer souris d'un point de depart a un point d'arrivee. |
Chat#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktop_chat | desktop:chat | Envoie un message a l'agent IA qui tourne sur un bureau. Renvoie la reponse de l'assistant. |
Taches planifiees -- lecture#
| Outil | Scope requis | Ce qu'il fait |
|---|
scheduled_jobs_list | scheduled_jobs:read | Liste les taches planifiees, eventuellement filtrees par workspace et/ou par bureau. |
Taches planifiees -- ecriture#
| Outil | Scope requis | Ce qu'il fait |
|---|
scheduled_jobs_create | scheduled_jobs:write | Cree une nouvelle tache planifiee executant une commande sur une planification cron. |
scheduled_jobs_run_now | scheduled_jobs:write | Declenche une execution immediate d'une tache planifiee, independamment de sa planification cron. |
Base de connaissances#
| Outil | Scope requis | Ce qu'il fait |
|---|
kb_search | kb:read | Recherche plein texte dans la base de connaissances du workspace. Renvoie les resultats classes avec extraits. |
kb_read_note | kb:read | Lit le contenu complet d'une note (par chemin) depuis la base de connaissances d'un workspace. |
Ce qui est a venir#
Les operations destructrices sur les bureaux (creer de nouveaux bureaux, en detruire) et les outils reserves aux administrateurs sont prevus pour une version future de @lebureau/mcp. Ils ne sont pas exposes pour le moment et aucune date n'est engagee. En attendant, utilisez le tableau de bord pour les actions de creation et de suppression.
Pour le catalogue des capabilities que vous pouvez attacher a une cle, voir Capabilities API.