Server MCP bersama

Claude Code menyimpan server MCP pengguna di .claude.json, file yang sama yang menyimpan login akun, sehingga file itu tidak dapat dibagikan antarakun. ccam menyimpan server bersama di file grup, mcp.json, dan menyerahkannya ke setiap akun dalam grup saat peluncuran. Gunakan ccam mcp untuk menambahkan server sekali untuk semua akun Anda, dan ccam mcp import untuk memindahkan server yang Anda tambahkan di dalam satu sesi ke akun-akun lain.

Penggunaan

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

Perubahan berlaku mulai peluncuran berikutnya dari setiap akun; sesi yang sedang berjalan tetap memakai server yang dipakainya saat dimulai:

$ 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

Menambahkan nama yang sudah dimiliki grup akan mengganti definisinya dan menampilkan updated alih-alih added. Server hanya sampai ke akun yang membagikan MCP dengan grup tersebut (ccam share <name> --mcp on); jika belum ada akun yang membagikan MCP, add akan memberitahukannya.

Opsi

add memerlukan perintah setelah -- atau --url; jika tidak, perintah ini gagal dengan a command to run (after --) or --url is required. --header berlaku untuk server --url dan --env untuk server perintah. add-json menerima JSON yang sama dengan claude mcp add-json, dan definisinya harus berupa objek dengan command atau url. import selalu memakai grup yang dipakai akun untuk membagikan MCP, dan list menampilkan setiap grup, sehingga -g tidak mengubah keduanya.

Cara kerjanya

File yang terlibat:

• ~/.local/share/ccam/groups/<group>/mcp.json: server bersama, {"mcpServers": {…}}, format yang dibaca --mcp-config. File ini ditulis dengan fsutil.AtomicWrite dan mode 0600, karena entri server sering membawa kunci API.
• ~/.local/share/ccam/profiles/<name>/.claude.json: file milik Claude Code sendiri yang berisi server akun. ccam hanya membaca nilai mcpServers-nya dengan pemindai profile.TopLevelValue dan tidak pernah mem-parse seluruh file di jalur peluncuran.
• ~/.local/state/ccam/mcp/<name>/: file seen, sync-stamp, dan cadangan .claude.json.

Ada dua strategi, diatur oleh mcp_strategy di ~/.config/ccam/config.toml. Default-nya adalah strategi flag:

1. launcher.applyMCP mencari grup MCP milik akun. mcp.FlagArgs memeriksa dengan satu stat bahwa mcp.json milik grup ada, tanpa mem-parse-nya.
2. Plan.InsertArgs menempatkan --mcp-config=<path> tepat setelah claude, sebelum argumen Anda sendiri, sehingga --mcp-config atau --strict-mcp-config milik Anda tetap berlaku di atasnya.
3. mcp.NewLocal memeriksa apakah .claude.json milik akun berubah sejak peluncuran terakhir, dan hanya dalam hal itu mem-parse servernya.
4. syscall.Exec mengganti ccam dengan Claude Code.

Path diteruskan sebagai satu argumen, --mcp-config=<path>, bukan dua. --mcp-config milik Claude Code menerima beberapa nilai, sehingga claude --mcp-config a.json "prompt" akan membaca prompt sebagai file konfigurasi kedua dan gagal dengan MCP config file not found. Bentuk satu argumen berhenti di situ, sehingga prompt atau subperintah seperti mcp list yang mengikutinya tetap berfungsi. Claude Code memuat server --mcp-config sebagai tambahan dari server milik akun; jika ada nama yang bentrok, entri di .claude.json yang menang. Strategi flag tidak pernah menulis .claude.json.

Server yang ditambahkan di dalam sesi dengan claude mcp add hanya masuk ke .claude.json milik akun itu. ccam tidak dapat melihatnya saat itu, karena Claude Code sudah menggantikannya, sehingga ccam memeriksanya pada peluncuran berikutnya. File seen menyimpan waktu modifikasi .claude.json dan nama server yang sudah dilaporkan. Jika waktunya berbeda, ccam membandingkan nama-nama itu dengan grup dan menampilkan petunjuk untuk setiap server baru satu kali, tanpa menunggu input:

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

Dengan mcp_strategy = "sync", server muncul di claude mcp list dan /mcp sebagai server pengguna biasa, dan ccam menulisnya ke .claude.json setiap akun sebelum peluncuran:

1. mcp.Sync membandingkan waktu modifikasi mcp.json milik grup dengan sync-stamp. Jika tidak berubah, .claude.json milik akun tidak dibuka.
2. Fungsi ini mengambil lock milik Claude Code sendiri, yaitu folder .claude.json.lock di samping file, yang dibuat dengan mkdir. Fungsi ini menunggu paling lama 2 detik dan menganggap lock yang berumur lebih dari 10 detik sudah basi, seperti yang dilakukan pustaka lock milik Claude Code.
3. Fungsi ini menyimpan .claude.json saat ini ke backups/ di folder state dan mempertahankan 5 yang terbaru.
4. Fungsi ini mengatur setiap server grup di mcpServers, menghapus server yang pernah ditulisnya tetapi kini tidak dimiliki grup, mempertahankan server milik akun sendiri, dan menulis file secara atomik dengan mode aslinya.
5. Fungsi ini mencatat stamp baru dan nama-nama yang dikelolanya, lalu Claude Code dimulai tanpa --mcp-config.

Sinkronisasi dilewati, dengan ccam: account work is already running, skipping MCP sync, jika ada sesi akun yang sedang berjalan, karena Claude Code menulis ulang .claude.json selama berjalan. Sinkronisasi yang gagal menampilkan ccam: MCP sync failed (launching anyway): … dan tetap meluncurkan. Petunjuk untuk server yang ditambahkan di dalam sesi hanya ada pada strategi flag.

ccam mcp import memindahkan server milik akun sendiri ke grupnya:

ccam membaca server akun dengan mcp.LocalServers dan membandingkan masing-masing dengan server grup bernama sama menggunakan mcp.SameDef, yang mengabaikan urutan kunci dan spasi. Server yang belum dimiliki grup, atau dimiliki dengan definisi yang sama, disalin. Server yang berbeda dilewati, karena definisi milik grup itulah yang dipakai setiap akun lain:

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)

Dengan --force, server grup diganti, dan mcp.json sebelumnya terlebih dahulu disimpan ke .ccam-backup/<time>/mcp.json di dalam folder grup. Lalu mcp.RemoveLocal menghapus entri yang sudah disalin dari .claude.json milik akun, di bawah lock yang sama dan setelah membuat cadangan di folder state. Ini perlu karena entri milik akun akan menang atas entri milik grup jika namanya bentrok. --keep-local membiarkannya.

Keamanan dan kasus khusus

• Info masuk. Server yang masuk dengan OAuth menyimpan tokennya di .credentials.json setiap akun (mcpOAuth), bukan di daftar server, sehingga membagikan server tidak ikut membagikan info masuknya. Masuk sekali per akun dengan /mcp, atau salin info masuk dari ~/.claude dengan ccam migrate. Grup tidak pernah menerima file login.
• Akun yang sedang berjalan. import menyalin ke grup tetapi membiarkan entri milik akun yang sedang berjalan dan memberitahukannya; jalankan lagi setelah sesi berakhir. Sinkronisasi melewati akun yang sedang berjalan.
• File rusak. Jika .claude.json bukan JSON yang valid, sinkronisasi tidak menyentuhnya dan melaporkan galatnya. Jika lock tidak dapat diambil dalam 2 detik, ccam melaporkan could not lock … (Claude Code is writing the file).
• Akun yang tidak membagikan MCP. import menolak dan meminta Anda menjalankan ccam share side --mcp on terlebih dahulu.
• Nama grup. -g hanya menerima nama grup; nama itu menjadi folder di bawah groups/, sehingga nama seperti ../x ditolak.

Terkait

• Berbagi antarakun
• Berbagi server MCP, pengaturan, dan riwayat
• Menyalin penyiapan yang sudah ada
• Semua perintah