Vue d'ensemble du serveur MCP

Ce que c'est#

@spineos/mcp est un serveur Model Context Protocol publié sur npm. Il permet aux clients compatibles MCP -- Claude Desktop, Claude Code, et tout autre assistant compatible MCP -- d'appeler l'API REST de SpineOS comme des outils natifs. Une fois installé, votre assistant peut lire, contrôler et orchestrer vos bureaux cloud directement depuis une conversation, sans quitter le client.

Le paquet est public sur npmjs.com/package/@spineos/mcp. Installez-le avec npx -y @spineos/mcp@latest -- le binaire s'appelle spineos-mcp.

Ce que l'assistant peut faire#

Après connexion, l'assistant gagne un ensemble d'outils pour opérer SpineOS pour votre compte. Il peut lister vos bureaux, les démarrer ou les arrêter, prendre des captures d'écran, envoyer des entrées clavier et souris, exécuter du code Python sur le runtime de l'agent du bureau, discuter avec l'agent IA qui vit sur chaque bureau, gérer les tâches planifiées, et rechercher dans la base de connaissances de votre workspace. Dix-huit outils sont livrés dans la version 0.1.0 ; voir Outils MCP pour la liste complète.

Comment il se connecte#

Le chemin des données est court. Votre client MCP lance spineos-mcp comme sous-processus local et parle MCP via stdio. spineos-mcp appelle ensuite l'API REST de SpineOS à https://www.spinestudio.dev/v1/ en HTTPS, en s'authentifiant avec votre clé API. Aucune requête et aucune réponse ne transitent par un tiers. Stdio est le seul transport dans 0.1.0 ; le HTTP distant est reporté à une version future.

Modèle de capabilities#

Chaque clé API porte une liste explicite de capabilities -- une liste blanche côté serveur des opérations que la clé peut effectuer. Au démarrage, spineos-mcp appelle /v1/me pour lire les capabilities attachées à votre clé, puis enregistre uniquement les outils que votre clé est autorisée à appeler. Les outils que vous ne pouvez pas utiliser ne sont jamais exposés à l'assistant, ce qui garde la surface du prompt réduite et prévient les invocations accidentelles. Voir Capabilities API pour le catalogue complet.

Non inclus dans v0.1.0#

Les opérations destructrices -- créer ou détruire des bureaux, supprimer des tâches planifiées -- ne sont pas disponibles via le serveur MCP dans cette version. Les outils réservés aux administrateurs sont également mis de côté. Les deux groupes sont prévus pour une version future ; aucune date n'est engagée.