Kết nối phần mềm với Claude Desktop qua MCP (Windows và Mac)

Muốn Claude Desktop điều khiển Blender, Excel hay trình duyệt, bạn thêm một máy chủ MCP vào file claude_desktop_config.json. Cách an toàn: cài máy chủ bằng uv tool install, gộp một khối vào mọi file cấu hình tìm thấy, thoát hẳn Claude rồi mở lại và kiểm tra nhãn Running.

Lấy API keyXem bảng giá

Cách hoạt động

API key RevidAPI chỉ đặt ở Claude Desktop (hoặc RevidAPI Code). Phần mềm bạn muốn điều khiển không cần API key; nó chỉ cần một máy chủ MCP nhỏ chạy trên máy. Mỗi máy chủ là một dòng khai báo trong claude_desktop_config.json: tên, lệnh chạy, tham số.

Bước 1 — Cài uv

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

Mở cửa sổ terminal mới rồi kiểm tra bằng uv --version.

Bước 2 — Cài máy chủ MCP thành lệnh cố định

Dùng uv tool install thay vì uvx. Claude Desktop bản Microsoft Store chạy uvx trong hộp cát và hay lỗi os error 32 khi tự cài thư viện; cài sẵn một lần thì Claude chỉ việc chạy file đã có.

uv tool install mcp-for-blender        # ví dụ: Blender
uv tool dir --bin                      # in ra thư mục chứa lệnh vừa cài

Windows: file nằm ở %USERPROFILE%\.local\bin\mcp-for-blender.exe. Kiểm tra bằng Test-Path "$env:USERPROFILE\.local\bin\mcp-for-blender.exe", phải ra True. Mac: ~/.local/bin/mcp-for-blender.

Bước 3 — Gộp khối cấu hình (đừng ghi đè file)

File cấu hình thường đã có sẵn nhiều cài đặt; chỉ được thêm vào mcpServers. Lệnh dưới tự tìm mọi vị trí Claude Desktop có thể dùng (bản thường, bản chế độ Gateway Claude-3p, thư mục ảo của bản Microsoft Store), sao lưu file cũ thành .bak rồi thêm khối. Đổi 2 dòng đầu cho phần mềm của bạn.

Windows — PowerShell:

$ten  = "blender"
$lenh = "$env:USERPROFILE\.local\bin\mcp-for-blender.exe"
$doi  = @()
$dirs = @("$env:APPDATA\Claude", "$env:LOCALAPPDATA\Claude-3p")
$dirs += Get-ChildItem "$env:LOCALAPPDATA\Packages" -Directory -Filter "Claude*" -ErrorAction SilentlyContinue | ForEach-Object { "$($_.FullName)\LocalCache\Local\Claude-3p"; "$($_.FullName)\LocalCache\Roaming\Claude" }
$utf8 = New-Object System.Text.UTF8Encoding $false
foreach ($d in $dirs) {
  $f = Join-Path $d "claude_desktop_config.json"
  if (-not (Test-Path $f)) { continue }
  Copy-Item $f "$f.bak" -Force
  $raw = [System.IO.File]::ReadAllText($f)
  if ($raw.Trim()) { $j = $raw | ConvertFrom-Json } else { $j = [pscustomobject]@{} }
  if (-not $j.mcpServers) { $j | Add-Member -NotePropertyName mcpServers -NotePropertyValue ([pscustomobject]@{}) }
  $j.mcpServers | Add-Member -NotePropertyName $ten -NotePropertyValue ([pscustomobject]@{ command = $lenh; args = @($doi) }) -Force
  [System.IO.File]::WriteAllText($f, ($j | ConvertTo-Json -Depth 20), $utf8)
  "Da cap nhat: $f"
}

macOS — Terminal:

python3 - <<'EOF'
import json, os, shutil
ten = "blender"
lenh = os.path.expanduser("~/.local/bin/mcp-for-blender")
doi = []
goc = os.path.expanduser("~/Library/Application Support")
tep_ds = [os.path.join(goc, d, "claude_desktop_config.json") for d in ("Claude", "Claude-3p")]
co = [t for t in tep_ds if os.path.exists(t)] or [tep_ds[0]]
for tep in co:
    os.makedirs(os.path.dirname(tep), exist_ok=True)
    if os.path.exists(tep): shutil.copy(tep, tep + ".bak")
    raw = open(tep, encoding="utf-8-sig").read().strip() if os.path.exists(tep) else ""
    j = json.loads(raw) if raw else {}
    j.setdefault("mcpServers", {})[ten] = {"command": lenh, "args": doi}
    open(tep, "w", encoding="utf-8").write(json.dumps(j, indent=2, ensure_ascii=False) + "\n")
    print("Da cap nhat:", tep)
EOF

Lệnh in ra Da cap nhat: … cho từng file đã sửa. Nếu không in dòng nào, app chưa tạo file cấu hình: mở Claude Desktop → Settings → Developer → Edit Config một lần rồi chạy lại.

Bước 4 — Thoát hẳn Claude rồi mở lại

Bản Microsoft Store chạy ngầm dù đã đóng cửa sổ, nên đóng cửa sổ là chưa đủ.

Windows:

Stop-Process -Name claude -Force -ErrorAction SilentlyContinue

Mac: Cmd+Q. Mở lại app.

Mở lại Claude Desktop (Windows: từ menu Start; Mac: từ Launchpad), vào Settings → Developer. Mục Local MCP servers phải hiện tên phần mềm với nhãn Running. Bấm View logs nếu thấy Failed.

Máy chủ nên thử

Phần mềmLệnh càiGhi chú
Blenderuv tool install mcp-for-blenderCài addon và bấm Start MCP Server trong Blender. Hướng dẫn Blender
Excel (.xlsx)uv tool install excel-mcp-serverKhông cần cài Microsoft Excel. Hướng dẫn Excel
Trình duyệt (Playwright)npx @playwright/mcp@latestCần Node.js 18 trở lên. Windows dùng cmd với tham số /c npx -y @playwright/mcp@latest.
Thư mục và filenpx -y @modelcontextprotocol/server-filesystem <thư mục>Chỉ truy cập các thư mục bạn liệt kê.
SketchUpuv tool install sketchup-mcp --with "mcp==1.3.0"Phải ghim mcp==1.3.0. Hướng dẫn SketchUp
Revitcmd /c npx -y mcp-server-for-revitChỉ Windows, cần add-in. Hướng dẫn Revit

Trên Mac, npx đôi khi không nằm trong PATH của app; chạy which npx rồi điền đường dẫn đầy đủ vào lệnh.

Sửa lỗi thường gặp

Triệu chứngCách xử lý
Edit Config báo "Vị trí không sẵn dùng" (đường dẫn …\Claude-3p)Bản Microsoft Store dùng thư mục ảo trong %LOCALAPPDATA%\Packages\Claude_…\LocalCache. Lệnh gộp ở bước 3 đã tự tìm thư mục đó.
Settings → Developer báo No servers addedChưa thoát hẳn Claude (bước 4), hoặc lệnh gộp không tìm thấy file. Chạy lại lệnh và xem file nào được in ra.
Failed / Server disconnected, nhật ký có Failed to install: pywin32 … os error 32Đang dùng uvx trong bản Store. Đổi sang uv tool install và trỏ command tới file .exe như bước 2–3.
Chạy tay máy chủ thấy Invalid JSONBình thường: máy chủ MCP chỉ nói chuyện qua stdin. Bấm Ctrl+C để dừng, đừng bấm Enter.
spawn … ENOENT / not foundĐiền đường dẫn đầy đủ của lệnh vào command (where.exe trên Windows, which trên Mac).
Vẫn không hiện ở chế độ GatewayDùng RevidAPI Code: Cài đặt → Phần mềm kết nối (MCP) → Thêm.

Đã kiểm chứng trên Windows 10 với Claude Desktop bản Microsoft Store và chế độ Gateway. Các bước trên Mac tương tự nhưng chưa thử trên máy Mac thật; nếu gặp lỗi, nhắn Zalo admin.

Lấy API keyXem bảng giá

Câu hỏi thường gặp

Máy chủ MCP có cần API key RevidAPI không?

Không. API key chỉ đặt ở Claude Desktop hoặc RevidAPI Code.

Vì sao dùng uv tool install thay vì uvx?

Bản Claude Desktop cài từ Microsoft Store chạy uvx trong hộp cát và có thể lỗi os error 32; cài sẵn bằng uv tool install thì chạy ổn định.

File cấu hình nằm ở đâu?

Windows: %APPDATA%\Claude hoặc %LOCALAPPDATA%\Claude-3p, bản Store nằm trong Packages\Claude_…\LocalCache. Mac: ~/Library/Application Support/Claude.

Thanh toán thế nào?

Khách Việt quét QR ngân hàng (VNĐ), khách nước ngoài trả PayPal hoặc thẻ Visa/Mastercard (USD). Gói nhỏ nhất 99.000đ, credit không hết hạn.

Chọn model nào thì chạy đúng model đó?

Đúng. RevidAPI không tự đổi sang model khác rẻ hơn.

Xem thêm

Video hướng dẫn

Xem tất cả video trên kênh YouTube Revid API →

Cần cài đặt giúp?Admin cài API key vào Claude Code, Cursor, Codex, n8n giúp bạn — nhắn trực tiếp:
Zalo 0978 382 335Nhóm Zalo