# Server MCP bersama

> Simpan satu daftar server MCP per grup dengan ccam mcp add, add-json, list, remove, dan import, yang diteruskan lewat --mcp-config atau disinkronkan ke setiap akun.

Source: https://ccam.dev/id/features/mcp/ · Updated 2026-10-19

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

```sh
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:

```console
$ 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

| Opsi | Fungsinya | Default |
| --- | --- | --- |
| `-g`, `--group <group>` | grup tujuan untuk `add`, `add-json`, dan `remove` | satu-satunya grup yang dipakai akun untuk membagikan MCP, jika tidak `default` |
| `-- <command> [args…]` (`add`) | menjalankan perintah ini sebagai server stdio | |
| `--url <url>` (`add`) | URL server jarak jauh (http/sse) | |
| `--transport <stdio\|http\|sse>` (`add`) | transport untuk server `--url` | `http` |
| `--header <'Name: value'>` (`add`) | header HTTP, bisa diulang | tidak ada |
| `-e`, `--env <KEY=VALUE>` (`add`) | variabel environment untuk server stdio, bisa diulang | tidak ada |
| `--force` (`import`) | mengganti server grup bernama sama yang berbeda; `mcp.json` lama dicadangkan | nonaktif |
| `--keep-local` (`import`) | mempertahankan entri di `.claude.json` milik akun | nonaktif |
| `-h`, `--help` | bantuan untuk setiap perintah | |
| `--dry-run` (global) | hanya dihormati oleh `mcp list`; `add`, `add-json`, `remove`, dan `import` menolaknya dan tidak mengubah apa pun | nonaktif |

`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:

```console
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:

```console
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`](https://ccam.dev/id/features/migrate.md). 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](https://ccam.dev/id/features/share.md)
- [Berbagi server MCP, pengaturan, dan riwayat](https://ccam.dev/id/docs/sharing.md)
- [Menyalin penyiapan yang sudah ada](https://ccam.dev/id/features/migrate.md)
- [Semua perintah](https://ccam.dev/id/docs/commands.md)