配置 MCP 伺服器

為 Claude Code（WSL）與 Claude Desktop（Windows）設 MCP 伺服器連接。

適用時機

• 配 Claude Code 以 mcptools 連 R
• 配 Claude Desktop 含 MCP 伺服器
• 加 Hugging Face 或他遠端 MCP 伺服器
• 診工具間之 MCP 連通性

輸入

• 必要：MCP 伺服器類（mcptools、Hugging Face、自訂）
• 必要：客戶端（Claude Code、Claude Desktop、或兩者）
• 選擇性：認證令牌
• 選擇性：自訂伺服器實作

步驟

步驟一：裝 MCP 伺服器包

R（mcptools）：

install.packages("remotes")
remotes::install_github("posit-dev/mcptools")

Hugging Face：

npm install -g mcp-remote

預期： mcptools 自 GitHub 裝且於 R 中無誤載入。mcp-remote 全域可達（which mcp-remote 或 npm list -g mcp-remote）。

失敗時： mcptools 先確 remotes 已裝。若 GitHub 限速，於 ~/.Renviron 設 GITHUB_PAT。mcp-remote 確 Node.js 與 npm 已裝且於 PATH。

步驟二：配 Claude Code（WSL）

R mcptools 伺服器：

claude mcp add r-mcptools stdio \
  "/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe" \
  -- -e "mcptools::mcp_server()"

Hugging Face 伺服器：

claude mcp add hf-mcp-server \
  -e HF_TOKEN=your_token_here \
  -- mcp-remote https://huggingface.co/mcp

驗配置：

claude mcp list
claude mcp get r-mcptools

預期： claude mcp list 顯 r-mcptools 與 hf-mcp-server（或所加之伺服器）。claude mcp get r-mcptools 顯正確命令與參數。

失敗時： 若伺服器未見於列，驗 ~/.claude.json 含正確項。若 claude 命令未找到，加入 PATH：export PATH="$HOME/.claude/local/node_modules/.bin:$PATH"。

步驟三：配 Claude Desktop（Windows）

編輯 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "r-mcptools": {
      "command": "C:\\PROGRA~1\\R\\R-45~1.0\\bin\\x64\\Rscript.exe",
      "args": ["-e", "mcptools::mcp_server()"]
    },
    "hf-mcp-server": {
      "command": "mcp-remote",
      "args": ["https://huggingface.co/mcp"],
      "env": {
        "HF_TOKEN": "your_token_here"
      }
    }
  }
}

要：Windows 含空格之目錄用 8.3 短路徑（PROGRA~1 非 Program Files）。令牌用環境變數，非 --header 參數。

預期： %APPDATA%\Claude\claude_desktop_config.json 之 JSON 配置有效，含正確伺服器項。重啟後 Claude Desktop 顯 MCP 伺服器指示。

失敗時： 以 linter 驗 JSON（如 jq . < config.json）。若 Windows 路徑空格致解析錯，用 8.3 短路徑（PROGRA~1）。確 Claude Desktop 全重啟（非僅最小化）。

步驟四：配 R 會話於 MCP

加於項目 .Rprofile：

if (requireNamespace("mcptools", quietly = TRUE)) {
  mcptools::mcp_session()
}

此於 RStudio 開項目時自啟 MCP 會話。

預期： .Rprofile 於項目於 RStudio 開時有條件啟 mcptools::mcp_session()，令 MCP 工具自動可用。

失敗時： 若會話始時 mcptools 未找到，驗其已裝於 RStudio 用之庫（查 .libPaths()）。若用 renv，確 mcptools 於 renv 庫中。

步驟五：驗連接

自 WSL 測 R MCP：

"/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe" -e "mcptools::mcp_server()"

自 Claude Code 內測：

啟 Claude Code 並用 MCP 工具——其宜現於工具列。

測 Claude Desktop：

配置改後重啟 Claude Desktop。察 UI 中之 MCP 伺服器指示。

預期： 以 mcptools::mcp_server() 行 Rscript 生輸出而無誤。MCP 工具於活會話中見於 Claude Code 工具列。Claude Desktop 重啟後顯伺服器態。

失敗時： 若 Rscript 命令敗，查全路徑正確（ls "/mnt/c/Program Files/R/" 以驗 R 版本）。若工具未現於 Claude Code，重啟會話。Claude Desktop 則查防火牆設。

步驟六：多伺服器配置

Claude Code 與 Claude Desktop 皆支同時多 MCP 伺服器：

# Claude Code: add multiple servers
claude mcp add r-mcptools stdio "/path/to/Rscript.exe" -- -e "mcptools::mcp_server()"
claude mcp add hf-mcp-server -e HF_TOKEN=token -- mcp-remote https://huggingface.co/mcp
claude mcp add custom-server stdio "/path/to/server" -- --port 3001

預期： 多 MCP 伺服器同時配且可達。claude mcp list 顯所有伺服器。每伺服器之工具於同 Claude Code 會話可用。

失敗時： 若伺服器衝突，查各有獨名於配置中。若一伺服器阻他者，驗伺服器用非阻塞 I/O（stdio 傳輸自動處）。

驗證

• claude mcp list 顯所有已配伺服器
• R MCP 伺服器回應工具呼叫
• Hugging Face MCP 伺服器認證並回應
• Claude Code 與 Claude Desktop 皆可連（若兩者皆配）
• MCP 工具見於會話之工具列

常見陷阱

• Windows 路徑空格：用 8.3 短名或妥引用。不同工具解析路徑各異
• 令牌於命令參數中：Windows 上 --header "Authorization: Bearer token" 因解析而敗。改用環境變數
• 混淆 Claude Code 與 Claude Desktop 配置：此乃分之工具含分之配置檔（~/.claude.json vs %APPDATA%\Claude\）
• npx vs 全域裝：npx mcp-remote 於 Claude Desktop 脈絡或敗。以 npm install -g mcp-remote 全域裝
• mcptools 版本：確 mcptools 最新。其需 ellmer 包為依賴

相關技能

• build-custom-mcp-server - 建自訂 MCP 伺服器
• troubleshoot-mcp-connection - 調連接問題
• setup-wsl-dev-environment - WSL 設之前置