Máy chủ MCP dùng chung

Claude Code lưu máy chủ MCP người dùng trong .claude.json, cũng là tệp chứa thông tin đăng nhập của tài khoản, nên tệp này không thể dùng chung giữa các tài khoản. ccam lưu các máy chủ dùng chung trong một tệp của nhóm, mcp.json, và trao nó cho mọi tài khoản trong nhóm khi khởi động. Hãy dùng ccam mcp để thêm một máy chủ một lần cho mọi tài khoản của bạn, và ccam mcp import để chuyển một máy chủ bạn đã thêm trong một phiên sang các tài khoản khác.

Cách dùng

ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code   # a local (stdio) server
ccam mcp add ctx --url https://mcp.context7.com/mcp --header 'Authorization: Bearer …'
ccam mcp add docs --url https://example.com/sse --transport sse
ccam mcp add db -e PGHOST=localhost -- pg-mcp                    # with an environment variable
ccam mcp add-json gh '{"type":"http","url":"https://api.githubcopilot.com/mcp/"}'
ccam mcp add tools -g team -- tools-mcp                           # into the group team
ccam mcp list                                                     # every group, and servers only one account has
ccam mcp remove ctx
ccam mcp import work                                              # move work's own servers into its group
ccam mcp import work gh --force                                   # replace the group's different gh

Một thay đổi có hiệu lực từ lần khởi động tiếp theo của mỗi tài khoản; các phiên đang chạy giữ các máy chủ mà chúng khởi động cùng:

$ ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
✓ fs added in group default — applies from the next launch
$ ccam mcp list
group default (work, side)
  ctx                  http https://mcp.context7.com/mcp
  fs                   stdio npx -y @modelcontextprotocol/server-filesystem /home/me/code
only in account work: pg

Thêm một tên mà nhóm đã có sẽ thay định nghĩa của nó và in ra updated thay vì added. Máy chủ chỉ đến được một tài khoản nếu tài khoản đó dùng chung MCP với nhóm (ccam share <name> --mcp on); khi chưa có tài khoản nào dùng chung MCP, add sẽ báo điều đó.

Tùy chọn

add cần một lệnh sau -- hoặc --url; nếu không, nó thất bại với a command to run (after --) or --url is required. --header áp dụng cho máy chủ --url, còn --env cho máy chủ dạng lệnh. add-json nhận cùng JSON như claude mcp add-json, và định nghĩa phải là một đối tượng có command hoặc url. import luôn dùng nhóm mà tài khoản dùng chung MCP qua, còn list hiển thị mọi nhóm, nên -g không thay đổi chúng.

Cách hoạt động

Các tệp liên quan:

• ~/.local/share/ccam/groups/<group>/mcp.json: các máy chủ dùng chung, {"mcpServers": {…}}, định dạng mà --mcp-config đọc. Tệp được ghi bằng fsutil.AtomicWrite với quyền 0600, vì các mục máy chủ thường chứa khóa API.
• ~/.local/share/ccam/profiles/<name>/.claude.json: tệp riêng của Claude Code chứa các máy chủ của tài khoản. ccam chỉ đọc giá trị mcpServers của nó bằng bộ quét profile.TopLevelValue và không bao giờ phân tích cả tệp trên đường khởi động.
• ~/.local/state/ccam/mcp/<name>/: tệp seen, sync-stamp và các bản sao lưu .claude.json.

Có hai chiến lược, được đặt bằng mcp_strategy trong ~/.config/ccam/config.toml. Mặc định là chiến lược flag:

1. launcher.applyMCP tìm nhóm MCP của tài khoản. mcp.FlagArgs kiểm tra bằng một lần stat rằng mcp.json của nhóm tồn tại, mà không phân tích nó.
2. Plan.InsertArgs đặt --mcp-config=<path> ngay sau claude, trước các đối số của bạn, nên --mcp-config hoặc --strict-mcp-config của riêng bạn vẫn được áp dụng chồng lên.
3. mcp.NewLocal kiểm tra .claude.json của tài khoản có thay đổi kể từ lần khởi động trước hay không, và chỉ khi đó mới phân tích các máy chủ của nó.
4. syscall.Exec thay ccam bằng Claude Code.

Đường dẫn được truyền dưới dạng một đối số, --mcp-config=<path>, chứ không phải hai. --mcp-config của Claude Code nhận nhiều giá trị, nên claude --mcp-config a.json "prompt" sẽ đọc lời nhắc như một tệp cấu hình thứ hai và thất bại với MCP config file not found. Dạng một đối số dừng lại ở đó, và lời nhắc hoặc lệnh con như mcp list theo sau vẫn hoạt động. Claude Code nạp các máy chủ từ --mcp-config bổ sung vào các máy chủ riêng của tài khoản; khi trùng tên, mục trong .claude.json được ưu tiên. Chiến lược flag chỉ ghi vào .claude.json cho Remote Control.

claude remote-control (rc) không nhận --mcp-config, và các phiên của nó chỉ đọc máy chủ từ .claude.json. Với ccam work rc, ccam bỏ cờ này đi và, khi có terminal, hỏi có sao chép các máy chủ của nhóm vào .claude.json hay không, kèm một bản sao lưu, như chiến lược sync vẫn làm. Nó hỏi cho đến khi có bản sao, sau đó chỉ hỏi lại khi mcp.json của nhóm thay đổi (Remote Control). Vì bản sao như vậy được ưu tiên hơn --mcp-config khi trùng tên, ccam mcp add, add-json, remove và import cập nhật các bản sao mà các tài khoản khác trong nhóm đang giữ:

$ ccam mcp add ctx --url https://mcp.context7.com/mcp
✓ ctx added in group default — applies from the next launch
✓ Updated the copy in account side's .claude.json (made for Remote Control)

Một máy chủ được thêm trong phiên bằng claude mcp add chỉ nằm trong .claude.json của tài khoản đó. ccam không thể thấy nó vào lúc đó, vì Claude Code đã thay thế ccam, nên nó kiểm tra ở lần khởi động tiếp theo. Tệp seen lưu thời điểm sửa đổi của .claude.json và tên các máy chủ đã được báo. Khi thời điểm khác đi, ccam so sánh các tên với nhóm và in ra một gợi ý cho mỗi máy chủ mới một lần, mà không chờ đầu vào:

ccam: MCP servers only account work has: pg
      To share them with other accounts: ccam mcp import work pg

Với mcp_strategy = "sync", các máy chủ xuất hiện trong claude mcp list và /mcp như máy chủ người dùng thông thường, và ccam ghi chúng vào .claude.json của từng tài khoản trước khi khởi động:

1. mcp.Sync so sánh thời điểm sửa đổi của mcp.json của nhóm với sync-stamp. Nếu nó chưa thay đổi, .claude.json của tài khoản không được mở.
2. Nó lấy khóa riêng của Claude Code, tức thư mục .claude.json.lock cạnh tệp, được tạo bằng mkdir. Nó chờ tối đa 2 giây và coi một khóa cũ hơn 10 giây là đã hết hiệu lực, giống như thư viện khóa của Claude Code.
3. Nó lưu .claude.json hiện tại vào backups/ trong thư mục trạng thái và giữ 5 bản mới nhất.
4. Nó đặt mọi máy chủ của nhóm vào mcpServers, xóa các máy chủ nó đã ghi trước đó mà nhóm không còn có, giữ các máy chủ riêng của tài khoản, và ghi tệp một cách nguyên tử với quyền ban đầu của nó.
5. Nó ghi lại dấu thời gian mới và các tên nó quản lý, rồi Claude Code khởi động mà không có --mcp-config.

Việc đồng bộ bị bỏ qua, với ccam: account work is already running, skipping MCP sync, khi có một phiên của tài khoản đang chạy, vì Claude Code ghi lại .claude.json trong lúc chạy. Đồng bộ thất bại sẽ in ra ccam: MCP sync failed (launching anyway): … và vẫn khởi động. Gợi ý về các máy chủ được thêm trong phiên chỉ thuộc về chiến lược flag.

ccam mcp import chuyển các máy chủ riêng của một tài khoản vào nhóm của nó:

ccam đọc các máy chủ của tài khoản bằng mcp.LocalServers và so sánh từng máy chủ với máy chủ cùng tên của nhóm bằng mcp.SameDef, hàm này bỏ qua thứ tự khóa và khoảng trắng. Máy chủ mà nhóm chưa có hoặc có với cùng định nghĩa sẽ được sao chép. Máy chủ khác định nghĩa sẽ bị bỏ qua, vì định nghĩa của nhóm là thứ mọi tài khoản khác đang dùng:

Skipped gh: group default already has a different gh (`ccam mcp import work gh --force` replaces it)
✓ Copied to group default: pg
✓ Removed account work's own entries (.claude.json backed up)

Với --force, máy chủ của nhóm bị thay thế, và mcp.json trước đó được lưu trước vào .ccam-backup/<time>/mcp.json bên trong thư mục nhóm. Sau đó mcp.RemoveLocal xóa các mục đã sao chép khỏi .claude.json của tài khoản, dưới cùng khóa đó và sau khi sao lưu vào thư mục trạng thái. Việc này là cần thiết vì khi trùng tên, mục của tài khoản sẽ được ưu tiên hơn mục của nhóm. --keep-local giữ lại chúng.

An toàn và các trường hợp đặc biệt

• Đăng nhập. Các máy chủ đăng nhập bằng OAuth giữ token trong .credentials.json của từng tài khoản (mcpOAuth), không phải trong danh sách máy chủ, nên dùng chung một máy chủ không có nghĩa là dùng chung thông tin đăng nhập của nó. Hãy đăng nhập một lần cho mỗi tài khoản bằng /mcp, hoặc sao chép thông tin đăng nhập từ ~/.claude bằng ccam migrate. Nhóm không bao giờ nhận tệp đăng nhập.
• Tài khoản đang chạy. import sao chép vào nhóm nhưng giữ nguyên các mục riêng của tài khoản đang chạy và báo điều đó; hãy chạy lại sau khi phiên kết thúc. Việc đồng bộ bỏ qua các tài khoản đang chạy.
• Bản sao cho Remote Control. Bản sao của tài khoản đang chạy không bị động đến: Note: account side is running, so the copy in its .claude.json stays as it was until its next Remote Control launch. Với mcp_strategy = "sync" thì không cần cập nhật gì, vì mỗi lần khởi động đều đồng bộ.
• Tệp bị hỏng. Nếu .claude.json không phải JSON hợp lệ, việc đồng bộ không động đến nó và báo lỗi. Nếu không lấy được khóa trong 2 giây, ccam báo could not lock … (Claude Code is writing the file).
• Tài khoản không dùng chung MCP. import từ chối và yêu cầu bạn chạy ccam share side --mcp on trước.
• Tên nhóm. -g chỉ nhận tên nhóm; tên này trở thành một thư mục trong groups/, nên các tên như ../x bị từ chối.

Liên quan

• Dùng chung giữa các tài khoản
• Dùng chung máy chủ MCP, cài đặt và lịch sử
• Sao chép thiết lập hiện có
• Tất cả các lệnh