跳至主要內容
MCP · RemoteCommand

代理程式離線與 MCP 連線問題

排除裝置離線、找不到 npx、OAuth 登入失敗、MCP 連線問題與被權限政策拒絕的命令。

裝置顯示離線

確認本機代理程式仍在執行且網路正常。檢查代理程式版本與裝置清單的狀態。必要時使用相同的作業系統帳戶重新啟動。離線裝置無法執行新的遠端請求。

npx -y @lhtsoft/remotecommand-agent@latest doctor
指南

使用步驟

  1. 裝置顯示離線

    確認本機代理程式仍在執行且網路正常。檢查代理程式版本與裝置清單的狀態。必要時使用相同的作業系統帳戶重新啟動。離線裝置無法執行新的遠端請求。

  2. 重新啟動或更新代理程式

    完成手邊工作後按 Ctrl+C 停止代理程式。以最初註冊裝置的同一作業系統帳戶重新執行最新版。不要在同一裝置同時執行兩個代理程式。原有註冊資料可以繼續使用。

    npx -y @lhtsoft/remotecommand-agent@latest run
  3. 命令遭拒或找不到 npx

    COMMAND_BLOCKED 可能是裝置安全政策正常阻止操作的結果,請檢查權限設定與允許的資料夾。若找不到 npx,請安裝 Node.js LTS、重新開啟終端機並確認 node 和 npm 可以執行。

    node --version
    npm --version

以唯讀操作確認

請 AI 助理呼叫 list_devices,選擇上線的裝置,再查看允許資料夾中的檔案。裝置上線不代表具有終端機執行權限。若操作遭拒,應檢查裝置政策而不是繞過限制。

list_devices

常見問題

指令遭到封鎖或 npx 無法執行時怎麼辦?

COMMAND_BLOCKED 可能是裝置安全政策正常阻止操作的結果,請檢查權限設定與允許的資料夾。若找不到 npx,請安裝 Node.js LTS、重新開啟終端機並確認 node 和 npm 可以執行。

下一步

安裝並連線