MCP 서버, 설정, 대화 내역 공유

로그인 정보는 계정마다 따로 유지됩니다. 그 밖의 항목은 하나씩 골라 공유할 수 있습니다. ccam은 계정의 파일이나 폴더를 공유 그룹 폴더에 링크하므로, 한 계정에서 바꾼 내용이 같은 그룹의 모든 계정에 반영됩니다.

공유할 수 있는 항목

새 계정은 대화 내역을 제외한 모든 항목을 공유합니다.

로그인 파일인 .credentials.json과 .claude.json은 절대 공유되지 않습니다. ccam은 정해진 목록에 있는 경로만 링크하는데, 이 두 파일은 그 목록에 없습니다.

그룹

on은 default 그룹을 뜻합니다. 그룹 이름을 직접 지정하면 일부 계정끼리만 항목을 공유할 수 있습니다.

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

이제 work와 side는 서로 대화를 공유하지만, 다른 계정과는 공유하지 않습니다.

공유 켜기

계정에서 어떤 항목의 공유를 시작하면 ccam은 다음 순서로 진행합니다.

1. 옮기거나 복사하거나 링크할 파일을 모두 보여 주는 계획을 출력하고, 시작하기 전에 확인을 받습니다.
2. 그룹이 아직 비어 있으면 계정의 파일을 그룹 폴더로 옮기고, 그렇지 않으면 그룹에 없는 파일만 추가합니다.
3. 같은 파일인데 내용이 다르면 그룹의 버전을 유지할지, 내 버전을 쓸지, JSON을 병합할지 묻습니다.
4. 원본은 계정 폴더 안의 .ccam-backup/<time>/에 보관합니다.
5. 원본이 있던 자리에 그룹을 가리키는 링크를 둡니다.

대화 파일 이름은 세션 ID를 따르므로, 여러 계정의 대화 내역을 합쳐도 충돌하지 않습니다.

Claude Code가 그 계정으로 실행 중일 때는 ccam이 공유 설정을 바꾸지 않습니다. 세션이 옮기려는 파일에 계속 쓰기 때문입니다. 먼저 세션을 종료하세요.

공유 끄기

ccam share work --history off

링크가 제거되고, 계정은 그룹의 현재 내용을 복사한 자체 사본을 갖게 됩니다. 빈 상태로 새로 시작하려면 --fresh를 붙이세요. 그룹의 내용은 다른 계정을 위해 그대로 남습니다.

기존 설정 복사하기

ccam을 쓰기 전에 Claude Code를 써 왔다면 설정이 ~/.claude에 있습니다. ccam migrate는 이 설정을 공유 그룹으로 복사하므로, 그 항목을 공유하는 모든 계정이 같은 설정을 쓰게 됩니다.

ccam migrate

터미널에서는 ccam이 먼저 항목 체크리스트를 보여 줍니다. 대화 내역을 제외한 모든 항목이 선택되어 있으며, Space로 항목 선택을 바꾸고 Enter를 누르면 계획을 볼 수 있습니다. 폴더에 해당 내용이 없는 항목에는 not found가 표시됩니다.

복사하는 항목은 다음과 같습니다.

• settings.json과 전역 CLAUDE.md
• 확장 기능 agents/, commands/, skills/, plugins/, output-styles/, rules/
• 사용자 MCP 서버(~/.claude.json의 mcpServers 항목). 그룹의 mcp.json으로 복사됩니다.
• 복사하는 MCP 서버에 저장된 로그인 정보(OAuth). 각 계정 자체의 로그인 파일로 복사됩니다.
• 대화 내역(projects/와 history.jsonl). --history를 붙였을 때만 복사됩니다.

원본 폴더는 읽기만 합니다. 그 안의 어떤 것도 옮기거나 링크하거나 바꾸지 않으므로, claude를 그냥 실행해도 이전과 똑같이 동작합니다. 로그인 파일인 .credentials.json과 .claude.json은 그룹으로 절대 복사하지 않습니다.

OAuth로 로그인하는 MCP 서버는 토큰을 서버 목록이 아니라 로그인 정보에 보관합니다. 서버에 다시 로그인하지 않아도 되도록, ccam은 그룹을 통해 서버를 받는 모든 계정의 로그인 파일로 이 로그인 정보를 복사합니다. 단, 계정에 이미 자체 로그인 정보가 있으면 복사하지 않습니다. 실행 중인 계정, 아직 로그인하지 않은 계정, ccam import로 제자리에 등록한 계정, macOS 키체인에 로그인 정보를 보관하는 계정은 건너뛰고 그 이름을 알려 줍니다. 이런 계정에서는 /mcp로 서버에 로그인하세요. 나중에 MCP 서버를 공유하기 시작한 계정은 ccam migrate를 다시 실행하면 로그인 정보를 받습니다.

ccam은 무엇이든 복사하기 전에 계획을 출력하고 확인을 받습니다.

$ 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

마지막에는 항목마다 이 그룹을 통해 공유하는 계정을 보여 줍니다. 아직 공유하지 않는 계정이 있으면 공유를 켜는 ccam share 명령도 함께 출력합니다.

그룹에 내용이 다른 같은 파일이 이미 있으면, 공유를 켤 때와 마찬가지로 그룹의 사본을 유지할지 내 사본을 쓸지 묻습니다. settings.json 같은 JSON 파일은 병합할 수도 있고, history.jsonl은 줄 단위로 병합할 수 있습니다. 그룹에 있던 이전 사본은 그룹 폴더 안의 .ccam-backup/<time>/에 보관됩니다.

ccam --dry-run migrate처럼 명령 앞에 --dry-run을 붙이면 아무것도 복사하지 않고 계획만 보여 줍니다. 다른 폴더에서 복사하려면 폴더를 지정하세요(예: ccam migrate ~/.claude-work --group work).

MCP 서버

Claude Code는 MCP 서버를 로그인 정보와 함께 .claude.json에 저장하므로, 이 파일은 공유할 수 없습니다. ccam은 공유 서버를 그룹의 mcp.json에 두고, --mcp-config=<group>/mcp.json 옵션으로 Claude Code를 시작합니다. 직접 지정한 --mcp-config 옵션도 그 위에 그대로 적용됩니다.

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

세션 안에서 claude mcp add로 추가한 서버는 해당 계정에만 저장됩니다. 다음에 그 계정을 시작하면 ccam이 서버 이름과 함께, 그 서버를 그룹으로 옮기는 명령을 알려 줍니다.

ccam mcp import work gh

그룹에 같은 이름의 다른 서버가 이미 있으면 ccam은 그 서버를 건너뛰고 그 사실을 알려 줍니다. --force를 붙이면 그룹의 서버를 바꾸고, 이전 mcp.json은 그룹의 .ccam-backup/ 폴더에 보관합니다.

OAuth로 로그인하는 MCP 서버는 토큰을 계정의 로그인 정보와 함께 저장하므로, 계정마다 한 번씩 인증하거나 ccam migrate로 ~/.claude의 로그인 정보를 복사해야 합니다.

서버를 claude mcp list와 /mcp에서 일반 사용자 서버로 보고 싶다면 ~/.config/ccam/config.toml에 mcp_strategy = "sync"를 설정하세요. 그러면 ccam이 시작 전에 각 계정의 .claude.json에 서버를 기록합니다. 이때 Claude Code의 파일 잠금을 그대로 사용하고 백업도 남깁니다.

같은 폴더에서 두 계정 쓰기

대화 내역을 공유하는 계정들은 같은 파일에 기록합니다. 같은 그룹의 다른 계정이 이미 실행 중인 폴더에서 Claude Code를 하나 더 시작하면, ccam이 경고를 보여 주고 계속할지 묻습니다.

문제가 생겼을 때

ccam doctor
ccam doctor --fix

예를 들어 백업을 직접 복원해서 공유 경로가 일반 파일로 바뀌었다면, ccam은 Claude Code를 시작하기 전에 멈추고 ccam doctor --fix를 실행하라고 안내합니다. 이 명령은 그 파일을 그룹에 병합하고 백업을 남깁니다.