↓ Skip to main content
BisaCloud Docs

Menghubungkan AI ke Server dengan SSH-MCP

·2 mins
AI AI
Table of Contents

SSH MCP Server adalah server lokal yang mengimplementasikan protokol Model Context Protocol (MCP). Tool ini berfungsi sebagai jembatan antara Large Language Model (LLM) atau MCP client dengan sistem operasi target, sehingga AI dapat menjalankan perintah shell secara aman melalui koneksi SSH pada server Linux maupun Windows.

Dengan SSH MCP Server, AI dapat berinteraksi langsung dengan infrastruktur server untuk melakukan administrasi, menjalankan command, serta mengelola proses secara remote tanpa perlu akses manual melalui terminal.

Fitur Utama
#

  • Eksekusi Perintah Jarak Jauh: Menjalankan perintah shell pada server yang dapat diakses melalui SSH.

  • Autentikasi Aman dan Fleksibel: Mendukung beberapa metode autentikasi SSH:

    • Password
    • SSH key

  • Manajemen Proses dengan Timeout Menyediakan konfigurasi timeout untuk membatasi durasi eksekusi perintah. Jika proses berjalan terlalu lama, sistem akan menghentikan proses secara otomatis sebelum koneksi SSH ditutup.

Tool yang Tersedia
#

  • exec: Digunakan untuk menjalankan perintah shell standar pada server remote.
  • sudo-exec: Digunakan untuk menjalankan perintah dengan hak akses tinggi (root/sudo).
    • Fitur sudo dapat dinonaktifkan sepenuhnya menggunakan flag --disableSudo
    • Jika sudo membutuhkan autentikasi password, gunakan --sudoPassword

Instalasi dan Konfigurasi
#

SSH MCP Server dapat dijalankan menggunakan npx tanpa perlu instalasi global.

Contoh konfigurasi MCP:

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "npx",
      "args": [
        "ssh-mcp",
        "-y",
        "--",
        "--host=1.2.3.4",
        "--port=22",
        "--user=root",
        "--password=pass",
        "--key=path/to/key",
        "--timeout=30000",
        "--maxChars=none"
      ]
    }
  }
}

Keterangan konfigurasi:

Parameter Fungsi
--host Alamat server SSH tujuan
--port Port SSH (default: 22)
--user Username SSH
--password Password SSH
--key Lokasi file SSH key
--timeout Batas waktu eksekusi command
--maxChars Batas output karakter

Integrasi dengan Claude Code
#

Tambahkan SSH MCP Server ke Claude Code menggunakan perintah berikut:

claude mcp add --transport stdio ssh-mcp -- npx -y ssh-mcp -- --host=YOUR_HOST --user=YOUR_USER --password=YOUR_PASSWORD

Setelah berhasil terhubung, Claude Code dapat menjalankan perintah pada server remote menggunakan instruksi bahasa natural.

Contoh:

Jalankan perintah "ls -la" pada server remote.

Claude akan menerjemahkan permintaan tersebut menjadi eksekusi command melalui SSH MCP Server.

Related