---

name: configure-mcp-server locale: wenyan-ultra source_locale: en source_commit: 82c77053 fence_basis_commit: 82c77053 translator: "Julius Brussee homage — caveman" translation_date: "2026-04-19" description: > Configure MCP (Model Context Protocol) servers for Claude Code and Claude Desktop. Covers mcptools setup, Hugging Face integration, WSL path handling, and multi-client configuration. Use when setting up Claude Code to connect to R via mcptools, configuring Claude Desktop with MCP servers, adding Hugging Face or other remote MCP servers, or troubleshooting MCP connectivity between clients and servers. license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: mcp-integration complexity: intermediate language: multi tags: mcp, claude-code, claude-desktop, mcptools, configuration

配 MCP 服

設 MCP 服連於 Claude Code（WSL）與 Claude Desktop（Win）。

用

• 設 Claude Code 經 mcptools 連 R
• 配 Claude Desktop 含 MCP 服
• 加 Hugging Face 或他遠 MCP 服
• 除具間 MCP 連

入

• 必：MCP 服類（mcptools、Hugging Face、自）
• 必：客戶（Claude Code、Claude Desktop、俱）
• 可：鑑 token
• 可：自服實

行

一：裝 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（Win）

編 %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"
      }
    }
  }
}

要：Win 含空格之目錄用 8.3 短路（PROGRA~1 非 Program Files）。token 用環變，非 --header 參。

得： %APPDATA%\Claude\claude_desktop_config.json 之 JSON 有效含正服項。Claude Desktop 重啟後示 MCP 服指示。

敗： 以 linter 驗 JSON（如 jq . < config.json）。Win 路徑含空致析錯→用 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 服指示。

得： Rscript 行 mcptools::mcp_server() 無錯輸。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 具於會中現於具列

忌

• Win 路徑空格：用 8.3 短名或正引路。各具析路異。
• token 於令參：Win 上 --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 設前置