Dùng chung máy chủ MCP, cài đặt và lịch sử

Mỗi tài khoản giữ thông tin đăng nhập riêng. Mọi thứ khác đều có thể dùng chung theo từng mục: ccam liên kết tệp hoặc thư mục của tài khoản đến một thư mục nhóm dùng chung, nên thay đổi thực hiện ở một tài khoản sẽ xuất hiện ở mọi tài khoản trong nhóm đó.

Những gì có thể dùng chung

Tài khoản mới dùng chung mọi thứ trừ lịch sử hội thoại.

Các tệp đăng nhập .credentials.json và .claude.json không bao giờ được dùng chung. ccam chỉ liên kết các đường dẫn nằm trong một danh sách cố định, và hai tệp này không có trong danh sách đó.

Nhóm

on nghĩa là nhóm default. Bạn cũng có thể đặt một tên nhóm, để chỉ một số tài khoản dùng chung một mục:

ccam share work --history team
ccam share side --history team

Giờ đây work và side dùng chung hội thoại với nhau, nhưng không dùng chung với các tài khoản khác của bạn.

Bật dùng chung

Khi một tài khoản bắt đầu dùng chung một mục, ccam sẽ:

1. in ra kế hoạch gồm mọi tệp nó sẽ di chuyển, sao chép hoặc liên kết, và hỏi bạn trước khi bắt đầu;
2. chuyển các tệp của tài khoản vào thư mục nhóm nếu nhóm vẫn còn trống, hoặc thêm những tệp mà nhóm chưa có;
3. khi cùng một tệp có nội dung khác nhau, hỏi bạn muốn giữ phiên bản của nhóm, dùng phiên bản của bạn, hay gộp JSON;
4. giữ bản gốc của bạn trong .ccam-backup/<time>/ bên trong thư mục tài khoản;
5. thay bản gốc bằng một liên kết đến nhóm.

Các tệp hội thoại được đặt tên theo ID phiên, nên lịch sử từ nhiều tài khoản được gộp lại mà không xung đột.

ccam không thay đổi việc dùng chung khi Claude Code đang chạy bằng tài khoản đó, vì phiên vẫn tiếp tục ghi vào các tệp đang được di chuyển. Hãy thoát phiên trước.

Tắt dùng chung

ccam share work --history off

Liên kết bị gỡ bỏ và tài khoản nhận một bản sao riêng của nội dung hiện tại trong nhóm. Thêm --fresh để bắt đầu từ trạng thái trống thay vào đó. Nhóm vẫn giữ nội dung của nó cho các tài khoản khác.

Sao chép thiết lập hiện có

Nếu bạn đã dùng Claude Code trước khi có ccam, cài đặt của bạn nằm trong ~/.claude. ccam migrate sao chép chúng vào một nhóm, để mọi tài khoản dùng chung các mục đó đều có chúng:

ccam migrate

Trên terminal, ccam trước tiên hiển thị một danh sách kiểm (checklist) các mục. Mọi thứ trừ lịch sử hội thoại đều được đánh dấu; nhấn Space để thay đổi một mục và Enter để xem kế hoạch. Những mục mà thư mục không có gì được ghi là not found.

Những gì được sao chép:

• settings.json và CLAUDE.md toàn cục;
• các tiện ích mở rộng agents/, commands/, skills/, plugins/, output-styles/ và rules/;
• máy chủ MCP người dùng của bạn, tức mục mcpServers trong ~/.claude.json, vào mcp.json của nhóm;
• thông tin đăng nhập đã lưu (OAuth) của các máy chủ MCP được sao chép, vào tệp đăng nhập riêng của từng tài khoản;
• lịch sử hội thoại (projects/ và history.jsonl), nhưng chỉ khi bạn thêm --history.

Thư mục nguồn chỉ được đọc: không có gì bên trong bị di chuyển, liên kết hay thay đổi, và lệnh claude thông thường vẫn hoạt động như trước. Các tệp đăng nhập .credentials.json và .claude.json không bao giờ được sao chép vào nhóm.

Các máy chủ MCP đăng nhập bằng OAuth giữ token trong thông tin đăng nhập, không phải trong danh sách máy chủ. Để bạn không phải đăng nhập lại vào chúng, ccam sao chép các thông tin đăng nhập đó vào tệp đăng nhập của mọi tài khoản nhận máy chủ qua nhóm, trừ khi tài khoản đã có thông tin riêng. Nó bỏ qua các tài khoản đang chạy, chưa đăng nhập, được đăng ký tại chỗ bằng ccam import, hoặc lưu thông tin đăng nhập trong Chuỗi khóa (Keychain) của macOS, và nêu tên các tài khoản đó; hãy đăng nhập vào các máy chủ ở đó bằng /mcp. Tài khoản bắt đầu dùng chung máy chủ MCP về sau sẽ nhận được thông tin đăng nhập khi bạn chạy lại ccam migrate.

ccam in ra kế hoạch và hỏi trước khi sao chép bất cứ thứ gì:

$ ccam migrate
Copy from /home/me/.claude into group default (/home/me/.local/share/ccam/groups/default):
  mcp         ~/.claude.json  new: context7, fs
  settings    settings.json   new: 80 B
  memory      CLAUDE.md       new: 31 B
  extensions  agents/         add 1 file the group lacks (17 B)
              commands/       add 1 file the group lacks (15 B)
              skills/         add 1 file the group lacks (32 B)
              not found, skipped: plugins/, output-styles/, rules/
  Conversation history (projects/, history.jsonl) is not included; add --history to copy it.
Copy these into group default? [y/N] y
✓ Copied into group default: 2 MCP servers, settings.json, CLAUDE.md, agents/, commands/, skills/
Accounts that share these through group default:
  mcp         personal
  settings    personal
  memory      personal
  extensions  personal

Cuối cùng, ccam liệt kê các tài khoản dùng chung từng mục qua nhóm đó. Nếu có tài khoản chưa dùng chung, nó in ra các lệnh ccam share để bật dùng chung cho những tài khoản đó.

Khi nhóm đã có một bản khác của một tệp, ccam hỏi bạn, giống như khi bật dùng chung: giữ bản của nhóm hay dùng bản của bạn. settings.json và các tệp JSON khác còn có thể được hợp nhất, và history.jsonl có thể được hợp nhất theo từng dòng. Các bản trước đó của nhóm được lưu trong .ccam-backup/<time>/ bên trong thư mục nhóm.

Đặt --dry-run trước lệnh, như ccam --dry-run migrate, để xem kế hoạch mà không sao chép gì. Để sao chép từ thư mục khác, hãy nêu tên thư mục đó: ccam migrate ~/.claude-work --group work.

Máy chủ MCP

Claude Code lưu máy chủ MCP trong .claude.json, cùng với thông tin đăng nhập, nên tệp đó không thể dùng chung. ccam giữ các máy chủ dùng chung trong mcp.json của nhóm và khởi động Claude Code với --mcp-config=<group>/mcp.json. Các tùy chọn --mcp-config của riêng bạn vẫn được áp dụng thêm bên trên.

ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp list

Máy chủ bạn thêm trong một phiên bằng claude mcp add chỉ được lưu cho tài khoản đó. Lần tới khi bạn khởi động tài khoản đó, ccam sẽ nêu tên máy chủ và lệnh để chuyển nó sang nhóm:

ccam mcp import work gh

Nếu nhóm đã có một máy chủ khác cùng tên, ccam sẽ bỏ qua và thông báo cho bạn. --force thay máy chủ của nhóm và giữ mcp.json cũ trong thư mục .ccam-backup/ của nhóm.

Các máy chủ MCP đăng nhập bằng OAuth lưu token cùng với thông tin đăng nhập của tài khoản, vì vậy hãy cấp quyền cho chúng một lần trong mỗi tài khoản, hoặc sao chép thông tin đăng nhập từ ~/.claude bằng ccam migrate.

Nếu bạn muốn 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, hãy đặt mcp_strategy = "sync" trong ~/.config/ccam/config.toml. Khi đó ccam ghi chúng vào .claude.json của từng tài khoản trước khi khởi động, dưới khóa tệp của chính Claude Code và có bản sao lưu.

Hai tài khoản trong cùng một thư mục

Các tài khoản dùng chung lịch sử hội thoại sẽ ghi vào cùng các tệp. Nếu bạn khởi động một Claude Code thứ hai trong thư mục mà một tài khoản khác cùng nhóm đang chạy, ccam sẽ cảnh báo và hỏi bạn có muốn tiếp tục không.

Khi có sự cố

ccam doctor
ccam doctor --fix

Nếu một đường dẫn dùng chung đã trở thành tệp thông thường, ví dụ sau khi bạn tự khôi phục một bản sao lưu, ccam sẽ dừng trước khi khởi động Claude Code và chỉ bạn đến ccam doctor --fix, lệnh này gộp tệp vào nhóm và giữ một bản sao lưu.