# Sabobin MCP da aka raba

> Riƙe jerin sabobin MCP ɗaya ga kowane rukuni da ccam mcp add, add-json, list, remove da import, ana miƙa su da --mcp-config ko ana daidaita su cikin kowane asusu.

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

Claude Code yana ajiye sabobin MCP na mai amfani a `.claude.json`, fayil ɗaya da ke riƙe shigar asusun, don haka ba za a iya raba fayil ɗin tsakanin asusai ba. ccam yana ajiye sabobin da aka raba a fayil na rukuni, `mcp.json`, kuma yana miƙa shi ga kowane asusun rukunin lokacin farawa. Yi amfani da `ccam mcp` don ƙara sabar sau ɗaya ga dukkan asusanka, da `ccam mcp import` don matsar da sabar da ka ƙara a cikin zama ɗaya zuwa sauran.

## Amfani

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

Canji yana aiki daga farawa ta gaba ta kowane asusu; zaman da ke gudana suna riƙe sabobin da suka fara da su:

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

Ƙara sunan da rukunin ya riga yana da shi yana maye gurbin ma'anarsa kuma yana buga `updated` maimakon `added`. Sabobin suna kai wa asusu ne kawai idan yana raba MCP da wannan rukunin (`ccam share <name> --mcp on`); idan babu asusun da ke raba MCP tukuna, `add` yana faɗin haka.

## Zaɓuɓɓuka

| Zaɓi | Abin da yake yi | Tsoho |
| --- | --- | --- |
| `-g`, `--group <group>` | rukunin da ake nufi don `add`, `add-json` da `remove` | rukuni ɗaya tilo da wani asusu ke raba MCP ta cikinsa, in ba haka ba `default` |
| `-- <command> [args…]` (`add`) | gudanar da wannan umarni a matsayin sabar stdio | |
| `--url <url>` (`add`) | URL na sabar nesa (http/sse) | |
| `--transport <stdio\|http\|sse>` (`add`) | hanyar sadarwa (transport) ta sabar `--url` | `http` |
| `--header <'Name: value'>` (`add`) | HTTP header, ana iya maimaitawa | babu |
| `-e`, `--env <KEY=VALUE>` (`add`) | mai canjin muhalli ga sabar stdio, ana iya maimaitawa | babu |
| `--force` (`import`) | maye gurbin sabar rukuni mai suna ɗaya da ta bambanta; ana ajiye kwafin tsohon `mcp.json` | a kashe |
| `--keep-local` (`import`) | riƙe shigarwar a `.claude.json` na asusun | a kashe |
| `-h`, `--help` | taimako ga kowane umarni | |
| `--dry-run` (na gaba ɗaya) | `mcp list` kaɗai ke karɓar sa; `add`, `add-json`, `remove` da `import` suna ƙin sa kuma ba sa canza komai | a kashe |

`add` yana buƙatar ko dai umarni bayan `--` ko `--url`; in ba haka ba yana gazawa da `a command to run (after --) or --url is required`. `--header` yana aiki ga sabobin `--url`, kuma `--env` ga sabobin umarni. `add-json` yana karɓar JSON iri ɗaya da `claude mcp add-json`, kuma dole ma'anar ta zama abu (object) mai `command` ko `url`. `import` koyaushe yana amfani da rukunin da asusun ke raba MCP ta cikinsa, kuma `list` yana nuna kowane rukuni, don haka `-g` ba ya canza su.

## Yadda yake aiki

Fayilolin da abin ya shafa:

- `~/.local/share/ccam/groups/<group>/mcp.json`: sabobin da aka raba, `{"mcpServers": {…}}`, tsarin da `--mcp-config` ke karantawa. Ana rubuta shi da `fsutil.AtomicWrite` da mode `0600`, domin shigarwar sabobi sau da yawa suna ɗauke da API keys.
- `~/.local/share/ccam/profiles/<name>/.claude.json`: fayil na Claude Code kansa mai sabobin asusun. ccam yana karanta ƙimar `mcpServers` ɗinsa kawai da scanner na `profile.TopLevelValue` kuma ba ya taɓa karanta dukkan fayil ɗin a hanyar farawa.
- `~/.local/state/ccam/mcp/<name>/`: fayil ɗin `seen`, `sync-stamp` da kwafin ajiya na `.claude.json`.

Akwai dabaru biyu, ana saita su ta `mcp_strategy` a `~/.config/ccam/config.toml`. Tsohuwar ita ce dabarar flag:

1. `launcher.applyMCP` yana nemo rukunin MCP na asusun. `mcp.FlagArgs` yana dubawa da `stat` ɗaya cewa `mcp.json` na rukunin yana nan, ba tare da karanta shi ba.
2. `Plan.InsertArgs` yana saka `--mcp-config=<path>` kai tsaye bayan `claude`, kafin arguments naka, don haka `--mcp-config` ko `--strict-mcp-config` naka har yanzu suna aiki a saman sa.
3. `mcp.NewLocal` yana duba ko `.claude.json` na asusun ya canza tun farawa ta ƙarshe, kuma sai a lokacin ne yake karanta sabobinsa.
4. `syscall.Exec` yana maye gurbin ccam da Claude Code.

Ana miƙa hanyar a matsayin argument ɗaya, `--mcp-config=<path>`, ba biyu ba. `--mcp-config` na Claude Code yana karɓar ƙima da dama, don haka `claude --mcp-config a.json "prompt"` zai karanta prompt ɗin a matsayin fayil ɗin saiti na biyu kuma ya gaza da `MCP config file not found`. Nau'in argument ɗaya yana tsayawa a nan, kuma prompt ko ƙaramin umarni kamar `mcp list` da ke biye yana aiki. Claude Code yana loda sabobin `--mcp-config` ƙari ga na asusun kansa; idan sunaye sun yi karo, shigarwar da ke `.claude.json` ce ke nasara. Dabarar flag ba ta taɓa rubuta `.claude.json` ba.

Sabar da aka ƙara a cikin zama da `claude mcp add` tana sauka a `.claude.json` na wannan asusun kawai. ccam ba zai iya ganin ta a lokacin ba, domin Claude Code ya maye gurbinsa, don haka yana dubawa a farawa ta gaba. Fayil ɗin `seen` yana riƙe lokacin gyaran `.claude.json` da sunayen sabobin da aka riga aka sanar. Idan lokacin ya bambanta, ccam yana kwatanta sunayen da rukunin kuma yana buga shawara ga kowace sabuwar sabar sau ɗaya, ba tare da jiran shigarwa ba:

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

Da `mcp_strategy = "sync"`, sabobin suna bayyana a `claude mcp list` da `/mcp` a matsayin sabobin mai amfani na yau da kullum, kuma ccam yana rubuta su cikin `.claude.json` na kowane asusu kafin farawa:

1. `mcp.Sync` yana kwatanta lokacin gyaran `mcp.json` na rukunin da `sync-stamp`. Idan bai canza ba, ba a buɗe `.claude.json` na asusun.
2. Yana ɗaukar kullen Claude Code kansa, foldar `.claude.json.lock` kusa da fayil ɗin, wadda aka ƙirƙira da `mkdir`. Yana jira har zuwa daƙiƙa 2 kuma yana ɗaukar kullen da ya wuce daƙiƙa 10 a matsayin tsoho (stale), kamar yadda laburaren kulle na Claude Code ke yi.
3. Yana ajiye `.claude.json` na yanzu a `backups/` a foldar state kuma yana riƙe sababbi 5.
4. Yana saita kowace sabar rukuni a `mcpServers`, yana cire sabobin da ya rubuta a baya waɗanda rukunin ba shi da su yanzu, yana riƙe sabobin asusun kansa, kuma yana rubuta fayil ɗin a atomic da mode ɗinsa na asali.
5. Yana rubuta sabon stamp da sunayen da yake sarrafawa, kuma Claude Code yana farawa ba tare da `--mcp-config` ba.

Ana tsallake sync, da `ccam: account work is already running, skipping MCP sync`, idan zaman asusun yana gudana, domin Claude Code yana sake rubuta `.claude.json` yayin da yake aiki. Sync da ya gaza yana buga `ccam: MCP sync failed (launching anyway): …` kuma yana farawa duk da haka. Shawarar sabobin da aka ƙara a cikin zama ta dabarar flag ce kawai.

`ccam mcp import` yana matsar da sabobin asusu na kansa cikin rukuninsa:

ccam yana karanta sabobin asusun da `mcp.LocalServers` kuma yana kwatanta kowacce da sabar rukunin mai suna ɗaya ta amfani da `mcp.SameDef`, wanda ke watsi da tsarin maɓallai da sarari. Ana kwafar sabar da rukunin ba shi da ita ko yake da ita da ma'ana ɗaya. Ana tsallake wadda ta bambanta, domin ma'anar rukunin ce kowane sauran asusu ke amfani da ita:

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

Da `--force` ana maye gurbin sabar rukunin, kuma ana fara ajiye `mcp.json` na baya a `.ccam-backup/<time>/mcp.json` a cikin foldar rukunin. Sannan `mcp.RemoveLocal` yana cire shigarwar da aka kwafa daga `.claude.json` na asusun, ƙarƙashin kulle ɗaya kuma bayan ajiya a foldar state. Ana buƙatar wannan domin shigarwar asusun za ta yi nasara a kan ta rukunin idan sunaye sun yi karo. `--keep-local` yana barin su.

## Tsaro da yanayi na musamman

- **Shiga.** Sabobin da ke shiga da OAuth suna ajiye token ɗinsu a `.credentials.json` na kowane asusu (`mcpOAuth`), ba a jerin sabobin ba, don haka raba sabar ba ya raba shigarta. Shiga sau ɗaya a kowane asusu da `/mcp`, ko kwafi bayanan shiga daga `~/.claude` da [`ccam migrate`](https://ccam.dev/ha/features/migrate.md). Rukunin ba ya taɓa samun fayil ɗin shiga.
- **Asusan da ke aiki.** `import` yana kwafa zuwa rukunin amma yana barin shigarwar asusun da ke aiki kuma yana faɗin haka; sake gudanar da shi bayan zaman ya ƙare. Sync yana tsallake asusan da ke aiki.
- **Fayilolin da suka lalace.** Idan `.claude.json` ba ingantaccen JSON ba ne, sync yana barin sa yadda yake kuma yana bayar da rahoton kuskuren. Idan ba za a iya ɗaukar kullen cikin daƙiƙa 2 ba, ccam yana bayar da rahoton `could not lock … (Claude Code is writing the file)`.
- **Asusan da ba sa raba MCP.** `import` yana ƙi kuma yana gaya maka ka fara gudanar da `ccam share side --mcp on`.
- **Sunayen rukunoni.** `-g` yana karɓar sunan rukuni kawai; yana zama folda ƙarƙashin `groups/`, don haka ana ƙin sunaye kamar `../x`.

## Masu alaƙa

- [Rabawa tsakanin asusai](https://ccam.dev/ha/features/share.md)
- [Raba sabobin MCP, saituna da tarihi](https://ccam.dev/ha/docs/sharing.md)
- [Kwafar saitin da ke akwai](https://ccam.dev/ha/features/migrate.md)
- [Dukkan umarnai](https://ccam.dev/ha/docs/commands.md)