Connecter Claude Code ou Cursor au SSH via MCP

Laissez votre assistant IA executer des commandes, lire des fichiers et trier les incidents directement sur vos serveurs — via le serveur MCP integre de SSHive.

Duree estimee: 3 minutes

MCP (Model Context Protocol) est le standard ouvert introduit par Anthropic pour que les assistants IA parlent aux outils locaux. SSHive embarque un serveur MCP integre — Claude Code, Cursor ou Claude Desktop peuvent lire vos sessions SSH actives, lancer des commandes et parcourir des filesystems SFTP. Le serveur n'ecoute que sur localhost, utilise une auth Bearer token stockee dans le Trousseau macOS et herite des permissions de vos connexions SSH existantes. Setup en 30 secondes.

Pas-a-pas

1
Ouvrir Parametres → MCP et basculer l'unique toggle (Pro requis)
Ouvrez les Parametres SSHive, choisissez **MCP** dans la sidebar. La page est dominee par un seul switch : **"Activer le serveur MCP"**. Basculer ON fait trois choses a la fois : demarre le serveur HTTP local (port par defaut `49422`, customisable via le champ port avec le bouton Appliquer), genere un UUID Bearer-token persiste dans `settings.json`, et auto-injecte une entree `mcpServers.sshive` dans les fichiers de config de chaque client IA detecte (`~/.claude.json`, `~/.cursor/mcp.json`, plus la config Claude Desktop). Basculer OFF arrete le serveur **et** retire ces entrees. MCP est **Pro uniquement** : en Free, le toggle declenche la modal d'upgrade au lieu de demarrer le serveur.
2
Auto-injection vs copier-coller — ce que chaque client recoit
Pour **Claude Code** (CLI + extension IDE) et **Cursor** : SSHive ecrit directement dans `~/.claude.json` et `~/.cursor/mcp.json` (mode `0600` — le token est sensible). La page MCP affiche leur statut `Configure ✓` ou `Non detecte`. Vous n'avez rien a copier. Pour **Claude Desktop** (qui ne supporte que stdio, pas HTTP nativement) : SSHive affiche un bloc copiable separe utilisant `npx -y mcp-remote` comme shim stdio-vers-HTTP — collez-le dans `claude_desktop_config.json`. Pour tout autre client compatible MCP : un bouton "Copier la config Streamable HTTP" copie un bloc JSON **avec votre vrai token** pret a coller n'importe ou.
3
Connecter des sessions SSH dans SSHive — elles deviennent les outils de l'IA
Le serveur MCP n'expose que les sessions **actuellement connectees** dans SSHive. Connectez-vous a prod, staging ou aux serveurs que vous voulez rendre accessibles a l'IA. La surface d'outils exposee : `ssh_list_sessions`, `ssh_execute`, `sftp_list`, `sftp_read_file` (1 MB max), `sftp_write_file` (en memoire), `sftp_write_file_chunk` (chunks de 4 MB pour gros fichiers via append base64) et `sftp_write_from_local_path` (lit un fichier local → ecrit sur le distant, zero base64 — meilleur pour les gros transferts).
4
Redemarrer le client IA et demander
Redemarrez Claude Code, Cursor ou Claude Desktop pour qu'ils prennent en compte la nouvelle entree MCP. Demandez : "lance `df -h` sur la session SSH de prod et signale tout volume au-dessus de 80%". L'IA appelle `ssh_execute` sur votre session SSHive live, parse, resume — et SSHive logge chaque appel d'outil pour audit. Pour faire tourner le Bearer token : "Regenerer le token" dans Parametres → MCP (un double-clic de confirmation laisse 4 secondes pour annuler). Les anciennes configs deviennent invalides et SSHive reecrit le nouveau token dans les fichiers de config clients qu'il gere (`~/.claude.json`, `~/.cursor/mcp.json`).

Questions frequentes

L'integration MCP est-elle sure ?+

L'IA ne peut faire que ce que vous pouvez via la session SSH active — pas de privilege supplementaire. SSHive logge chaque appel d'outil. Le serveur HTTP MCP bind uniquement sur `127.0.0.1` — jamais joignable depuis le reseau. Le Bearer token vit dans `settings.json` (rotatable depuis l'UI), et les configs clients auto-ecrites sont en mode `0600` (lecture/ecriture proprietaire uniquement).

Est-ce que ca demande un abonnement Pro ?+

Oui. MCP fait partie de SSHive Pro (achat unique sur le Mac App Store). Pas de mode "MCP lecture seule" degrade en Free — le toggle ouvre simplement la modal d'upgrade.