Claude MCP 連接 Linux 伺服器:SSH 設定方法

聯盟行銷揭露 Ver 3.1
聯盟行銷揭露 Ver 3.2(僅限行動版)

即使把 Linux 伺服器的工作交給 Claude,SSH 金鑰檔案也不會離開你的 PC。 Claude MCP Linux 伺服器連接,是透過 SSH 把 Claude 接到你 Linux 伺服器的終端機與檔案的方式,本文從哪些會傳送、哪些不會,到設定順序都整理好了。

Claude MCP(Model Context Protocol)是 Claude 連接外部工具與資料時使用的標準,而 MCP 伺服器則是依照這個標準提供功能的程式。概念與 Claude Desktop 連接器設定請看 Claude MCP 基本概念 這篇文章。

Ⅰ. Claude MCP Linux 伺服器是什麼?

在 Claude Desktop 接上 MCP 後,Claude 會讀取你 PC 上的檔案並執行工作。Claude MCP Linux 伺服器連接,是把這個工作對象透過 SSH 移到遠端 Linux 伺服器,指令在伺服器上執行,只有結果回到 Claude。

伺服器端不需要另外開放什麼。照樣使用平常的 SSH 與金鑰,唯一改變的是輸入指令的人從使用者變成 Claude。能執行、能看到什麼,由登入帳號的權限決定。

醒目顯示 Anthropic 伺服器路徑 Anthropic 伺服器 醒目顯示對話內容路徑 對話內容 我的 PC 醒目顯示 Claude Desktop Claude Desktop 醒目顯示 MCP 伺服器程式 MCP 伺服器程式 醒目顯示金鑰檔案路徑 金鑰檔案(.pem) 不會離開 PC SSH 醒目顯示指令方向 指令 醒目顯示輸出方向 輸出 Linux 伺服器 醒目顯示 Linux 伺服器 執行指令 只送回結果
點選方塊或箭頭,只有該部分會保持明亮。金鑰檔案方塊沒有任何一條線通到你的 PC 外面。 在窄螢幕上,請把圖左右滑動來看。
會傳送的
Claude 產生的一行指令
該指令在伺服器上輸出的結果
這兩者都是對話內容,所以會經過 Anthropic 的伺服器。如果伺服器上處理的資料很敏感,要先考慮這一點。
不會傳送的
金鑰檔案(.pem)的內容
建立 SSH 連線的是在你 PC 上執行的 MCP 伺服器程式。金鑰只由該程式讀取並用於驗證,Claude 既不會收到也看不到。
伺服器的全部檔案
只有指令讀出的部分會以輸出形式傳出,目錄不會整個被複製。
只有單向 伺服器沒有先主動找 Claude 說話的路徑。只有送出要求時,才會有回應回來。

Ⅱ. Claude MCP Linux 設定

設定分四個步驟,從 SSH 連線測試到連線錯誤檢查。需要準備的有 ⓐ Claude Desktop 應用程式、ⓑ 伺服器連線資訊(主機位址 · 帳號 · 連接埠)與金鑰檔案(.pem)、ⓒ 在 PC 上執行 MCP 伺服器套件的 Node.js。

1️⃣~4️⃣ 的內容可以在模擬器中一次看完,或從目錄確認。

🤖 Claude Desktop · SSH MCP 設定模擬器
1️⃣ SSH 連線測試
為了在 Claude 登記伺服器,先在 PC 上測試 SSH 連線並準備需要的東西。
~]#
ⓐ Claude Desktop 應用程式 MCP 運作的應用程式。只能在應用程式中登記,網頁版不行。
ⓑ 伺服器連線資訊 主機位址 · 帳號 · 連接埠與金鑰檔案(.pem)
ⓒ Node.js 在 PC 上執行 MCP 伺服器套件。
2️⃣ 登記 · Settings · Developer
開啟 Claude 應用程式後,前往 Settings · Developer,按下 [Edit Config]。只能在應用程式中登記,網頁版不行。
Claude 應用程式 Settings › Developer 畫面的本機 MCP 伺服器項目
2️⃣ 登記 · 設定檔資料夾
會開啟 claude_desktop_config.json 所在的資料夾。
claude_desktop_config.json 所在的資料夾
2️⃣ 登記 · 開啟 config 檔案
用記事本或 EditPlus 這類文字編輯器開啟檔案,確認內容。
用文字編輯器開啟 claude_desktop_config.json 檔案的畫面
2️⃣ 登記 · 貼上項目
在第 47 行的 } 後面輸入逗號(,),貼上下面的項目,再按 Ctrl + S 儲存。
    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "your-server-IP",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\path-to-key\\mykey.pem"
      ]
    }
反斜線每個都寫兩次。macOS 或 Linux 則在 command 直接寫 npx,並拿掉 /c。
1 / 2
claude_desktop_config.json 檔案的修改位置 在 EditPlus 修改 claude_desktop_config.json 檔案的畫面
3️⃣ 第一次執行 · 設定完成畫面
重新執行 Claude 應用程式。畫面沒有變化的話,在工作管理員強制結束後再執行。
Claude MCP Linux 設定完成的畫面
3️⃣ 第一次執行 · 執行 hostname
請 Claude 簡單執行 hostname 指令的畫面。
1 / 2
用 SSH MCP Server 執行 hostname 指令的畫面 1 用 SSH MCP Server 執行 hostname 指令的畫面 2
4️⃣ 錯誤檢查 · 未安裝 Node.js 的日誌
用 [View logs] 確認的結果,是因為沒有 Node.js 資料夾(C:\Program Files\nodejs)而發生的錯誤。
SSH MCP Server 連線錯誤日誌畫面
4️⃣ 錯誤檢查 · 安裝 Node.js
下載 Windows 用的 .msi 檔案並安裝。到了第 5 個畫面, 不要勾選,直接按 Next 繼續。這裡詢問的是 C/C++ 編譯工具,SSH MCP 套件不需要;勾選的話,Chocolatey 與 Visual Studio 建置工具也會一起安裝。
1 / 5
Windows 版 Node.js 下載畫面 Windows 版 Node.js 安裝過程 1 Windows 版 Node.js 安裝過程 2 安裝路徑 Windows 版 Node.js 安裝過程 3 Windows 版 Node.js 安裝過程 4 選擇附加工具
Windows 用的 .msi 檔案請從官方下載頁面下載。
Node.js 下載頁面
4️⃣ 錯誤檢查 · 伺服器未連線 · CMD
安裝 Node.js 後,把 Claude 連同背景程式都結束再重新執行,日誌就會變成「未連線」的內容。在 CMD 視窗輸入指令來找出原因。
1 / 2
SSH MCP Server 伺服器未連線日誌畫面 在 CMD 視窗輸入排解問題指令的畫面
把下方本文說明的四個步驟集中在一處。點選左側選單來瀏覽, 點選畫面圖片可以放大來看。
Claude MCP Linux 設定畫面

1️⃣ SSH 連線測試

為了在 Claude 登記伺服器,先在 PC 上測試 SSH 連線並準備需要的東西。

 ~]# 

2️⃣ 登記 SSH MCP Server

SSH MCP Server 只能在應用程式中登記,網頁版不行。開啟 Claude 應用程式後,前往 [Settings › Developer]。

Claude MCP 連接 Linux 伺服器:SSH 設定方法

按下 [Edit Config]。

Claude MCP 連接 Linux 伺服器:SSH 設定方法

會開啟 claude_desktop_config.json 所在的資料夾。

Claude MCP Linux 設定 1 - claude_desktop_config.json 檔案__

用記事本或 EditPlus 這類文字編輯器開啟檔案確認。

Claude MCP 連接 Linux 伺服器:SSH 設定方法

在圖片第 47 行的 [}] 後面輸入逗號(,),再貼上項目。

要貼上的項目如下。把 [--host] 換成伺服器位址、[--port] 換成 SSH 連接埠(預設 22)、[--username] 換成登入帳號、[--privateKey] 換成金鑰檔案(.pem)的完整路徑。

    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "your-server-IP",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\path-to-key\\mykey.pem"
      ]
    }

在 Windows 上, command 要設成 cmd 而不是 npx,並在 args 的第一個項目放 /c。macOS 或 Linux 則在 command 直接寫 npx,拿掉 /c 即可。

如果檔案裡沒有 mcpServers 項目,就沒有地方可以貼上。這時請把整個檔案改成下面的形式。

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "your-server-IP",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\path-to-key\\mykey.pem"
      ]
    }
  }
}
Claude MCP Linux 設定 2 - 修改 claude_desktop_config.json 檔案(EditPlus)

設定完成後按 Ctrl + S 儲存。

3️⃣ 工具權限與第一次執行

重新執行 Claude 應用程式。畫面沒有變化的話,在工作管理員強制結束後再執行;出現錯誤就看 4️⃣。

Claude MCP Linux 設定「完成」_

簡單請 Claude 執行了 hostname 指令。

Claude MCP Linux_用 SSH MCP Server 執行 hostname 指令 1
Claude MCP Linux_用 SSH MCP Server 執行 hostname 指令 2_

4️⃣ 連線錯誤:未安裝 Node.js

Claude MCP 連接 Linux 伺服器:SSH 設定方法

用 [View logs] 確認後,發現是因為沒有安裝 Node.js 資料夾(C:\Program Files\nodejs)而發生的錯誤。

要安裝 Node.js,請前往 https://nodejs.org/ko/download。

Claude MCP 連接 Linux 伺服器:SSH 設定方法

下載 Windows 用的 .msi 檔案後進行安裝。

Windows 版 Node.js 安裝過程 1
Claude MCP 連接 Linux 伺服器:SSH 設定方法
Claude MCP 連接 Linux 伺服器:SSH 設定方法
Windows 版 Node.js 安裝過程 4

不勾選,直接按 Next。 這裡詢問是否要另外安裝 C/C++ 編譯工具,SSH MCP 套件不需要,勾選的話 Chocolatey 與 Visual Studio 建置工具也會一起安裝。

把 Claude 連同背景程式都結束後再重新執行。

Claude MCP 連接 Linux 伺服器:SSH 設定方法

再次確認日誌,訊息已經變成未連線。

SSH MCP Server 連線錯誤 3_在 CMD 輸入指令_

在 CMD 視窗輸入排解問題的指令,找出原因。

從這裡開始,問 Claude AI 就足以解決,所以建議直接確認錯誤,和 Claude 一起排解。

Ⅲ. FAQ

網頁版不行。SSH MCP Server 是在你 PC 裡執行的程式,要由 Claude 直接啟動這個程式才能連線。瀏覽器無法執行 PC 上的程式,網頁版能接上的只有具備網路位址的遠端服務。

執行指令前會跳出許可視窗,裡面原原本本顯示將要執行的指令。使用者不允許就不會執行。執行範圍本身也不會超過登入帳號的權限。SSH MCP 套件有 [--whitelist] 選項,可以讓它拒絕用正規表示式指定以外的所有指令。

把登入帳號指定為伺服器允許的帳號即可。AWS 系列的預設帳號是 ec2-user,Ubuntu 映像是 ubuntu。這些帳號有 sudo 權限,需要管理員權限的工作,就請 Claude 在指令前加上 sudo 執行。想直接以 root 登入,就得同時修改伺服器的 sshd 設定與 root 帳號的金鑰檔案。

ℹ️ 聯盟行銷說明
本站內容包含聯盟行銷連結。訪客透過這些連結購買商品或服務時,本站會從賣家獲得佣金。在這個過程中,購買者支付的金額(遇到活動折扣時金額會降低↓)並不會因此提高。刊登的價格、折扣與庫存資訊以撰寫當時為準,可能與實際情況不同,購買前請向賣家做最後確認。商品的挑選與評價依本站自訂的標準撰寫,是否支付佣金不會影響介紹順序或評價內容。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

Prove your humanity: 8   +   6   =