Trình tạo cấu hình MCP
Chọn client và các server bạn muốn dùng. Bạn sẽ nhận được cấu hình đúng định dạng mà client đó yêu cầu, các lệnh CLI tương ứng nếu có và cảnh báo cho những thành phần không thể chạy.
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"playwright": {
"type": "stdio",
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
}
}
}
Hoặc thêm từ dòng lệnh
claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
Cấu hình đầu ra hoạt động như thế nào
Từ xa hoặc cục bộ
Máy chủ từ xa là URL mà client kết nối qua Streamable HTTP; nhà cung cấp vận hành máy chủ và bạn không cần cài đặt gì. Máy chủ cục bộ khởi chạy dưới dạng tiến trình con thông qua npx, uvx hoặc docker và chạy với quyền truy cập trên máy của bạn. Nếu máy chủ hỗ trợ cả hai, trình tạo sẽ ưu tiên máy chủ từ xa và cho phép bạn chuyển đổi.
Không lưu bí mật vào tệp
Trình tạo không bao giờ ghi khóa thật. Trình tạo dùng cú pháp tham chiếu riêng của từng client: ${VAR} trong Claude Code, ${env:VAR} trong Cursor và Windsurf, lời nhắc nhập liệu trong VS Code, $VAR trong Gemini CLI, env_vars trong Codex và ${{ secrets.VAR }} trong Continue. Với các client khác, trình tạo dùng ký hiệu giữ chỗ <VAR> để bạn điền.
OAuth khi dùng lần đầu
Hầu hết máy chủ từ xa ở đây dùng OAuth để đăng nhập. Client sẽ mở trình duyệt khi kết nối lần đầu hoặc khi bạn chạy bước đăng nhập: /mcp trong Claude Code, codex mcp login, devin mcp login hoặc openclaw mcp login. Slack, Asana và HubSpot chỉ chấp nhận client đã đăng ký trước, vì vậy hãy kiểm tra xem client của bạn có được hỗ trợ không.
Tải lại sau khi chỉnh sửa
Claude Desktop đọc tệp khi khởi động, vì vậy hãy thoát và mở lại ứng dụng sau khi thay đổi; trên macOS, nhật ký nằm trong ~/Library/Logs/Claude. Nếu máy chủ mới không xuất hiện trong client khác, hãy khởi động lại client hoặc tải lại cửa sổ. Trong OpenClaw, openclaw mcp doctor <name> --probe sẽ kiểm tra một máy chủ cụ thể.
Câu hỏi về cấu hình
Tệp mcp.json của Cursor và Claude Code nằm ở đâu?
Cursor đọc .cursor/mcp.json trong dự án hoặc ~/.cursor/mcp.json cho mọi dự án. Claude Code đọc .mcp.json ở thư mục gốc của repository để áp dụng trong phạm vi dự án, còn cấu hình cục bộ và cấu hình người dùng được lưu trong ~/.claude.json. VS Code dùng .vscode/mcp.json, còn Codex dùng ~/.codex/config.toml thay vì JSON.
Tại sao máy chủ từ xa không tải được từ claude_desktop_config.json?
Claude Desktop chỉ lấy máy chủ cục bộ từ tệp đó. Bạn cần thêm máy chủ từ xa dưới dạng connector tuỳ chỉnh trong Settings > Connectors, rồi dán URL và đăng nhập. Vì vậy, trình tạo liệt kê riêng các URL đó.
Làm cách nào để không đưa API key vào .mcp.json đã commit?
Hãy tham chiếu biến môi trường thay vì dán API key vào tệp. Claude Code mở rộng ${VAR} và ${VAR:-default}, Cursor mở rộng ${env:NAME}, còn VS Code có thể yêu cầu nhập secret thông qua mục inputs. Đặt biến trong shell hoặc trình quản lý secret trước khi khởi động client.
Tôi có thể dùng lại một cấu hình MCP cho nhiều client không?
Không thể dùng nguyên trạng: hầu hết client dùng khoá cấp cao nhất là mcpServers, nhưng .vscode/mcp.json dùng servers, Zed dùng context_servers và Codex dùng các bảng mcp_servers. Một số client có thể nhập cấu hình của client khác: VS Code tự tìm cấu hình của Claude Desktop, Cursor và Windsurf; Continue chấp nhận tệp mcp.json được thả vào; còn JetBrains AI Assistant có tuỳ chọn Import from Claude.
Tại sao npx không chạy được trong Claude Desktop trên Windows?
README của MCP servers chạy npx thông qua cmd trên Windows: command cmd, với /c, npx và tên package làm tham số. Khi bạn chọn Claude Desktop và Windows, trình tạo tự động thêm lớp bọc này.
Nên dùng phiên bản hosted hay phiên bản cục bộ của máy chủ?
Hosted đơn giản hơn: không cần cài runtime và OAuth thay thế token có thời hạn dài được lưu trên đĩa. Phiên bản cục bộ phù hợp khi máy chủ cần truy cập tệp hoặc thông tin xác thực trên máy của bạn, hoặc khi không có endpoint hosted, như với Filesystem, Playwright hoặc máy chủ AWS API.