Installer le serveur MCP

Prérequis#

• Node.js 20 ou plus récent. Vérifiez avec node --version.
• Un compte SpineOS.

Récupérer une clé API#

1. Connectez-vous au tableau de bord.
2. Ouvrez Paramètres -- Clés API.
3. Cliquez sur Créer une clé API, donnez-lui un nom descriptif (par exemple claude-desktop-laptop), et choisissez ses capabilities dans la grille de cases à cocher. La sélection par défaut est volontairement étroite ; n'ajoutez des scopes que si vous en avez vraiment besoin.
4. Copiez la clé immédiatement. Elle n'est affichée qu'une seule fois et commence par sk_live_. Stockez-la dans un gestionnaire de mots de passe ou dans le trousseau de votre OS. Ne la commitez jamais dans un dépôt.

Si vous perdez la clé, révoquez-la depuis le même onglet et générez-en une nouvelle.

Lancer le serveur via npx#

@spineos/mcp est publié sur npm. Vous ne le lancez normalement pas à la main -- votre client MCP s'en charge. La commande est :

npx -y @spineos/mcp@latest

Le binaire s'appelle spineos-mcp. Le drapeau -y accepte l'invite d'installation et @latest garantit que vous tirez la version publiée la plus récente à chaque lancement.

Configurer Claude Desktop#

Ouvrez claude_desktop_config.json et ajoutez une entrée sous mcpServers :

{
  "mcpServers": {
    "spineos": {
      "command": "npx",
      "args": ["-y", "@spineos/mcp@latest"],
      "env": {
        "SPINEOS_API_KEY": "sk_live_..."
      }
    }
  }
}

Sauvegardez le fichier et redémarrez Claude Desktop. Les outils SpineOS apparaîtront dans la prochaine conversation.

Configurer Claude Code#

Même structure, dans .mcp.json à la racine de votre projet (ou dans votre configuration utilisateur) :

{
  "mcpServers": {
    "spineos": {
      "command": "npx",
      "args": ["-y", "@spineos/mcp@latest"],
      "env": {
        "SPINEOS_API_KEY": "sk_live_..."
      }
    }
  }
}

Redémarrez Claude Code après avoir sauvegardé.

Vérifier que ça fonctionne#

Démarrez une nouvelle conversation et demandez :

Liste mes bureaux.

L'assistant doit appeler l'outil desktops_list et renvoyer vos bureaux actuels. Si rien ne se passe, voir Dépannage ci-dessous.

Variables d'environnement#

Dépannage#