Aller au contenu principal
Obtenir
macOS uniquement · Pro
L'app de bureau d'Anthropic pour discuter avec Claude

Claude Desktop + SSH via le serveur MCP de SSHive

Par Lucas Russo, développeur de SSHive · Mis à jour le

Posez vos questions sur vos serveurs à Claude Desktop et laissez-le vérifier par lui-même, via les sessions SSH et SFTP ouvertes dans SSHive. Une extension en un clic, un jeton à coller.

Télécharger SSHive gratuitementVoir la page MCP
Claude Desktop est l'app d'Anthropic pour discuter avec Claude hors de tout IDE, et elle sait charger des serveurs MCP. Elle convient aux questions sur vos serveurs plutôt qu'aux sessions de code : ouvrez-la, demandez ce qui s'est mal passé sur prod cette nuit, et Claude lance par SSHive les commandes dont il a besoin avant de répondre. Pas d'éditeur, pas de modification de code, juste une conversation qui peut aller vérifier. SSHive fournit une extension pour Claude Desktop. Dans Paramètres > MCP, « Installer l'extension » la confie à Claude Desktop, qui vous demande de confirmer et de coller le jeton de SSHive. Aucun fichier à modifier, et pas besoin de Node.js sur votre Mac. Si vous préférez vous en passer, SSHive affiche aussi un bloc qui lance npx mcp-remote vers son point d'accès SSE ; cette voie-là demande Node.js. La présentation du serveur MCP détaille ce que l'assistant peut faire, et ne peut pas faire, une fois connecté.

Configurer Claude Desktop avec SSHive en 4 étapes

  1. 1

    Activez le serveur MCP et copiez le jeton

    Dans SSHive, ouvrez Paramètres > MCP, activez « Activer le serveur MCP », puis copiez le jeton Bearer affiché. L'extension vous le demandera. MCP fait partie de Pro.

  2. 2

    Installez l'extension de SSHive

    Toujours dans Paramètres > MCP, cliquez sur « Installer l'extension ». Claude Desktop ouvre l'extension SSHive et vous demande de confirmer l'installation. Collez le jeton dans le champ prévu. Le champ du port vaut 49422 par défaut : ne le changez que si vous avez changé le port de SSHive.

  3. 3

    Vérifiez que Claude Desktop voit SSHive

    Dans une conversation, cliquez sur le bouton + en bas de la zone de saisie, puis ouvrez la liste des connecteurs : SSHive doit y figurer, avec ses outils. Sinon, quittez complètement Claude Desktop (Cmd+Q) et rouvrez-le.

  4. 4

    Ouvrez les sessions que Claude doit utiliser

    Dans SSHive, ouvrez les sessions que Claude doit utiliser. Posez ensuite votre question dans Claude Desktop, avec vos mots : Claude trouve la bonne session avec ssh_list_sessions et choisit la commande à lancer, et Claude Desktop vous demande votre accord avant qu'un outil s'exécute.

Sans l'extension : le bloc mcp-remote

À la place de l'étape 2, vous pouvez utiliser le bloc que Paramètres > MCP affiche pour Claude Desktop : il lance npx mcp-remote vers le point d'accès SSE de SSHive, avec votre jeton déjà inséré (celui ci-dessous porte <your-token> à sa place). Dans Claude Desktop, Settings > Developer > Edit Config ouvre claude_desktop_config.json : ajoutez l'entrée sshive dans mcpServers en gardant vos autres serveurs, enregistrez, puis quittez Claude Desktop (Cmd+Q) et rouvrez-le avant de passer aux étapes 3 et 4. Cette voie demande Node.js sur votre Mac, pour npx, et SSHive doit être ouvert quand Claude Desktop s'y connecte.

À copier
{
  "mcpServers": {
    "sshive": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:49422/sse",
        "--header",
        "Authorization:Bearer <your-token>",
        "--transport",
        "sse"
      ]
    }
  }
}

Que demander à Claude Desktop

Vous demandez

« Est-ce que quelque chose a planté sur prod depuis ce matin ? »

Ce qui se passe

Claude lance systemctl --failed par ssh_execute, puis journalctl -p err --since today --no-pager pour les erreurs en cause, et vous dit ce qui a cassé et quand.

Vous demandez

« Combien de connexions actives a mon postgres en ce moment ? »

Ce qui se passe

Claude lance sudo -n -u postgres psql -c "SELECT count(*) FROM pg_stat_activity" sur la session db-master par ssh_execute et vous donne le nombre, avec son contexte.

Vous demandez

« Lis l'unité systemd de nginx et dis-moi si elle a des réglages inhabituels. »

Ce qui se passe

Claude lit /etc/systemd/system/nginx.service (ou l'endroit où se trouve l'unité) avec sftp_read_file, examine les réglages ExecStart, ExecReload et Restart, et signale tout ce qui sort de l'ordinaire.

Pourquoi Claude Desktop avec SSHive (plutôt que Claude Code ou Cursor)

Claude Desktop est le client à choisir quand la tâche n'est pas « écrire du code » mais « dis-moi ce qui se passe sur mes serveurs » : démêler une alerte en soirée, relire la configuration d'un serveur à la recherche de risques, résumer ce qui paraît anormal dans les journaux d'hier. Rien de tout cela ne demande d'éditeur. Il faut une conversation capable d'aller voir, dans une fenêtre qui reste ouverte à côté de votre travail. Pour modifier du code à partir des mêmes sessions, Claude Code et Cursor utilisent le même serveur SSHive. L'autre raison, c'est la combinaison. Claude Desktop peut faire tourner plusieurs extensions côte à côte, tirées de son propre répertoire dans Settings > Extensions. Avec SSHive à côté, par exemple, d'un connecteur pour votre outil de suivi d'erreurs, Claude peut rapprocher une alerte d'un journalctl -u myservice sur l'hôte concerné, dans la même conversation. Gardez à l'esprit que tout ce que Claude lit ainsi, d'un côté comme de l'autre, entre dans la conversation que Claude Desktop envoie à Anthropic.

Questions fréquentes

Faut-il modifier claude_desktop_config.json ?+
Pas avec l'extension : « Installer l'extension », dans SSHive, s'occupe de tout, et vous n'avez qu'à coller le jeton. Le fichier ne compte que pour la voie mcp-remote. Sur macOS, c'est claude_desktop_config.json, dans ~/Library/Application Support/Claude/, et Claude Desktop l'ouvre pour vous depuis Settings > Developer > Edit Config.
Claude Desktop ne liste pas SSHive, ou ses appels échouent : que faire ?+
Vérifiez trois points. Le serveur est-il activé dans Paramètres > MCP ? L'extension lance SSHive s'il est fermé ; avec mcp-remote, SSHive doit déjà être ouvert. Le jeton est-il à jour ? Un redémarrage de SSHive le conserve ; seul « Régénérer » le change, et le nouveau doit alors aller dans les réglages de l'extension de Claude Desktop (Settings > Extensions) ou dans le bloc mcp-remote. Avec mcp-remote, Node.js est-il installé ? npx en a besoin. Les journaux MCP de Claude Desktop, dans ~/Library/Logs/Claude, nomment l'erreur.
Claude Desktop voit-il tout mon Mac, ou seulement les sessions SSHive ?+
Seulement ce que les outils de SSHive atteignent : les sessions ouvertes dans SSHive et les chemins sur ces serveurs. Aucun outil de SSHive ne lance de commande sur votre Mac. Deux d'entre eux touchent tout de même des fichiers locaux, puisque c'est leur rôle : sftp_write_from_local_path envoie un fichier du Mac vers un serveur, et sftp_download_to_local_path enregistre un fichier du serveur sur le Mac. Pour le reste, parcourir vos propres dossiers par exemple, il faut une autre extension, que vous installeriez vous-même.

Autres clients et pages liées

Claude Code + SSH via le serveur MCP de SSHive

L'assistant de code d'Anthropic, dans le terminal et dans l'IDE

Cursor + SSH via le serveur MCP de SSHive

L'éditeur de code centré sur l'IA, bâti sur VS Code

Serveur MCP

Un environnement SSH de développeur pensé pour macOS

Essayer SSHive gratuitement sur macOS

Obtenez le client tout-en-un SSH, SFTP, RDP et VNC pour Mac. Téléchargement gratuit, sans inscription.

Télécharger SSHive gratuitement