Vue d'ensemble#
@spineos/mcp@0.1.0 livre 18 outils, groupés par domaine. Chaque outil requiert une capability spécifique sur la clé API que spineos-mcp utilise.
Au démarrage, spineos-mcp appelle /v1/me pour lire les capabilities attachées à votre clé. Il enregistre ensuite uniquement les outils dont la capability requise est présente sur la clé. 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 réduite et évite que l'assistant choisisse un outil qui ne ferait que retourner un 403.
Si vous changez les capabilities (en révoquant la clé et en en créant une nouvelle avec un autre jeu de scopes), redémarrez votre client MCP pour qu'il relance spineos-mcp et relise /v1/me.
Bureaux -- lecture#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktops_list | desktop:read | Liste tous les bureaux appartenant à l'utilisateur authentifié. |
desktops_get | desktop:read | Récupère les détails complets d'un bureau par son id. |
Bureaux -- cycle de vie#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktops_start | desktop:lifecycle | Démarre (ou reprend) un bureau arrêté. |
desktops_stop | desktop:lifecycle | Arrête proprement un bureau en cours d'exécution. État et disque préservés. |
desktops_restart | desktop:lifecycle | Redémarre un bureau en cours d'exécution. |
Bureaux -- exécution et capture#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktop_exec_python | desktop:control | Exécute 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'écran du bureau. Renvoie une image PNG. |
Bureaux -- contrôle souris et clavier#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktop_click | desktop:control | Clique aux coordonnées indiquées. |
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 défiler la vue. |
desktop_drag | desktop:control | Glisser-déposer souris d'un point de départ à un point d'arrivée. |
Chat#
| Outil | Scope requis | Ce qu'il fait |
|---|
desktop_chat | desktop:chat | Envoie un message à l'agent IA qui tourne sur un bureau. Renvoie la réponse de l'assistant. |
Tâches planifiées -- lecture#
| Outil | Scope requis | Ce qu'il fait |
|---|
scheduled_jobs_list | scheduled_jobs:read | Liste les tâches planifiées, éventuellement filtrées par workspace et/ou par bureau. |
Tâches planifiées -- écriture#
| Outil | Scope requis | Ce qu'il fait |
|---|
scheduled_jobs_create | scheduled_jobs:write | Crée une nouvelle tâche planifiée exécutant une commande sur une planification cron. |
scheduled_jobs_run_now | scheduled_jobs:write | Déclenche une exécution immédiate d'une tâche planifiée, indépendamment de sa planification cron. |
Base de connaissances -- lecture#
| Outil | Scope requis | Ce qu'il fait |
|---|
kb_search | kb:read | Recherche plein texte dans la base de connaissances du workspace. Renvoie les résultats 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. |
Base de connaissances -- écriture#
| Outil | Scope requis | Ce qu'il fait |
|---|
kb_write_note | kb:write | Crée ou écrase une note markdown (par chemin) dans la base de connaissances d'un workspace. |
Workspaces -- écriture#
| Outil | Scope requis | Ce qu'il fait |
|---|
workspace_create | workspaces:write | Crée un nouveau workspace appartenant à l'utilisateur authentifié. Amorce le modèle de base de connaissances par défaut. |
Centre de Mission -- écriture#
| Outil | Scope requis | Ce qu'il fait |
|---|
mission_create_task | mission:write | Crée une tâche Centre de Mission pour l'agent IA du bureau, ponctuelle ou planifiée, avec approbation optionnelle. |
Ce qui est à venir#
Les opérations destructrices sur les bureaux (créer de nouveaux bureaux, en détruire) et les outils réservés aux administrateurs sont prévus pour une version future de @spineos/mcp. Ils ne sont pas exposés pour le moment et aucune date n'est engagée. En attendant, utilisez le tableau de bord pour les actions de création et de suppression.
Pour le catalogue des capabilities que vous pouvez attacher à une clé, voir Capabilities API.