سرورهای MCP مشترک

Claude Code سرورهای MCP کاربر را در .claude.json نگه می‌دارد، همان فایلی که ورود حساب را در خود دارد، بنابراین این فایل را نمی‌توان بین حساب‌ها به اشتراک گذاشت. ccam سرورهای مشترک را در یک فایل گروه، mcp.json، نگه می‌دارد و هنگام اجرا آن را به همه حساب‌های گروه می‌دهد. با ccam mcp یک سرور را یک بار برای همه حساب‌هایتان اضافه کنید و با ccam mcp import سروری را که داخل یک نشست اضافه کرده‌اید به حساب‌های دیگر منتقل کنید.

نحوه استفاده

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

هر تغییر از اجرای بعدی هر حساب اعمال می‌شود؛ نشست‌های در حال اجرا سرورهایی را که با آن‌ها شروع شده‌اند نگه می‌دارند:

$ 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

افزودن نامی که گروه از قبل دارد، تعریف آن را جایگزین می‌کند و به‌جای added، updated چاپ می‌کند. سرورها فقط به حسابی می‌رسند که MCP را با آن گروه به اشتراک بگذارد (ccam share <name> --mcp on)؛ وقتی هنوز هیچ حسابی MCP را به اشتراک نمی‌گذارد، add این را اعلام می‌کند.

گزینه‌ها

add یا به یک فرمان پس از -- نیاز دارد یا به --url؛ در غیر این صورت با a command to run (after --) or --url is required شکست می‌خورد. --header برای سرورهای --url و --env برای سرورهای فرمانی است. add-json همان JSON فرمان claude mcp add-json را می‌پذیرد و تعریف باید شیئی با command یا url باشد. import همیشه از گروهی استفاده می‌کند که حساب MCP را از طریق آن به اشتراک می‌گذارد و list همه گروه‌ها را نشان می‌دهد، بنابراین -g روی آن‌ها اثری ندارد.

چگونه کار می‌کند

فایل‌های درگیر:

• ~/.local/share/ccam/groups/<group>/mcp.json: سرورهای مشترک، {"mcpServers": {…}}، همان قالبی که --mcp-config می‌خواند. این فایل با fsutil.AtomicWrite و حالت 0600 نوشته می‌شود، چون ورودی‌های سرور اغلب کلیدهای API دارند.
• ~/.local/share/ccam/profiles/<name>/.claude.json: فایل خود Claude Code با سرورهای حساب. ccam فقط مقدار mcpServers آن را با پویشگر profile.TopLevelValue می‌خواند و هرگز کل فایل را در مسیر اجرا تجزیه نمی‌کند.
• ~/.local/state/ccam/mcp/<name>/: فایل seen، فایل sync-stamp و نسخه‌های پشتیبان .claude.json.

دو راهبرد وجود دارد که با mcp_strategy در ~/.config/ccam/config.toml تعیین می‌شوند. پیش‌فرض، راهبرد flag است:

1. launcher.applyMCP گروه MCP حساب را پیدا می‌کند. mcp.FlagArgs با یک stat بررسی می‌کند که mcp.json گروه وجود دارد، بدون اینکه آن را تجزیه کند.
2. Plan.InsertArgs گزینه --mcp-config=<path> را درست پس از claude و پیش از آرگومان‌های خود شما قرار می‌دهد، بنابراین --mcp-config یا --strict-mcp-config خود شما همچنان روی آن اعمال می‌شوند.
3. mcp.NewLocal بررسی می‌کند که آیا .claude.json حساب از اجرای قبلی تغییر کرده است و فقط در آن صورت سرورهای آن را تجزیه می‌کند.
4. syscall.Exec ccam را با Claude Code جایگزین می‌کند.

مسیر به‌صورت یک آرگومان، --mcp-config=<path>، داده می‌شود نه دو آرگومان. --mcp-config در Claude Code چند مقدار می‌پذیرد، بنابراین claude --mcp-config a.json "prompt" پرامپت را به‌عنوان فایل پیکربندی دوم می‌خواند و با MCP config file not found شکست می‌خورد. شکل تک‌آرگومانی همان‌جا تمام می‌شود و پرامپت یا زیرفرمانی مانند mcp list که پس از آن بیاید کار می‌کند. Claude Code سرورهای --mcp-config را علاوه بر سرورهای خود حساب بارگذاری می‌کند؛ در صورت تداخل نام، ورودی .claude.json برنده است. راهبرد flag هرگز در .claude.json نمی‌نویسد.

سروری که داخل یک نشست با claude mcp add اضافه شود فقط در .claude.json همان حساب قرار می‌گیرد. ccam در آن لحظه نمی‌تواند آن را ببیند، چون Claude Code جای آن را گرفته است، بنابراین در اجرای بعدی بررسی می‌کند. فایل seen زمان تغییر .claude.json و نام سرورهایی را که قبلاً گزارش شده‌اند نگه می‌دارد. وقتی زمان متفاوت باشد، ccam نام‌ها را با گروه مقایسه می‌کند و برای هر سرور جدید یک بار یک راهنمایی چاپ می‌کند، بدون اینکه منتظر ورودی بماند:

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

با mcp_strategy = "sync"، سرورها در claude mcp list و /mcp به شکل سرورهای عادی کاربر دیده می‌شوند و ccam پیش از اجرا آن‌ها را در .claude.json هر حساب می‌نویسد:

1. mcp.Sync زمان تغییر mcp.json گروه را با sync-stamp مقایسه می‌کند. اگر تغییری نکرده باشد، .claude.json حساب باز نمی‌شود.
2. قفل خود Claude Code را می‌گیرد، یعنی پوشه .claude.json.lock کنار فایل که با mkdir ساخته می‌شود. تا ۲ ثانیه صبر می‌کند و قفلی را که بیش از ۱۰ ثانیه از عمرش گذشته باشد کهنه در نظر می‌گیرد، همان کاری که کتابخانه قفل Claude Code انجام می‌دهد.
3. .claude.json فعلی را در backups/ در پوشه وضعیت ذخیره می‌کند و ۵ نسخه جدیدتر را نگه می‌دارد.
4. همه سرورهای گروه را در mcpServers قرار می‌دهد، سرورهایی را که قبلاً نوشته و گروه دیگر ندارد حذف می‌کند، سرورهای خود حساب را نگه می‌دارد و فایل را به‌صورت اتمی با حالت اصلی‌اش می‌نویسد.
5. مهر زمانی جدید و نام‌هایی را که مدیریت می‌کند ثبت می‌کند و Claude Code بدون --mcp-config شروع می‌شود.

وقتی نشستی از حساب در حال اجرا باشد، همگام‌سازی با پیام ccam: account work is already running, skipping MCP sync انجام نمی‌شود، چون Claude Code در حین اجرا .claude.json را بازنویسی می‌کند. همگام‌سازی ناموفق ccam: MCP sync failed (launching anyway): … را چاپ می‌کند و با این حال اجرا را ادامه می‌دهد. راهنمایی درباره سرورهایی که داخل نشست اضافه شده‌اند فقط مربوط به راهبرد flag است.

ccam mcp import سرورهای خود یک حساب را به گروه آن منتقل می‌کند:

ccam سرورهای حساب را با mcp.LocalServers می‌خواند و هر کدام را با سرور هم‌نام گروه با استفاده از mcp.SameDef مقایسه می‌کند، که ترتیب کلیدها و فاصله‌ها را نادیده می‌گیرد. سروری که گروه ندارد یا با همان تعریف دارد کپی می‌شود. سرور متفاوت رد می‌شود، چون تعریف گروه همان چیزی است که همه حساب‌های دیگر از آن استفاده می‌کنند:

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)

با --force سرور گروه جایگزین می‌شود و mcp.json قبلی ابتدا در .ccam-backup/<time>/mcp.json داخل پوشه گروه ذخیره می‌شود. سپس mcp.RemoveLocal ورودی‌های کپی‌شده را از .claude.json حساب حذف می‌کند، با همان قفل و پس از گرفتن پشتیبان در پوشه وضعیت. این کار لازم است، چون در صورت تداخل نام، ورودی حساب بر ورودی گروه برنده می‌شود. --keep-local آن‌ها را باقی می‌گذارد.

ایمنی و حالت‌های خاص

• ورودها. سرورهایی که با OAuth وارد می‌شوند توکن‌های خود را در .credentials.json هر حساب (mcpOAuth) نگه می‌دارند، نه در فهرست سرورها، بنابراین اشتراک یک سرور ورود آن را به اشتراک نمی‌گذارد. در هر حساب یک بار با /mcp وارد شوید، یا ورودها را با ccam migrate از ~/.claude کپی کنید. گروه هرگز فایل ورود دریافت نمی‌کند.
• حساب‌های در حال اجرا. import در گروه کپی می‌کند، اما ورودی‌های خود حسابی را که در حال اجراست باقی می‌گذارد و این را اعلام می‌کند؛ پس از پایان نشست آن را دوباره اجرا کنید. همگام‌سازی از حساب‌های در حال اجرا می‌گذرد.
• فایل‌های خراب. اگر .claude.json JSON معتبر نباشد، همگام‌سازی به آن دست نمی‌زند و خطا را گزارش می‌کند. اگر قفل در ۲ ثانیه گرفته نشود، ccam پیام could not lock … (Claude Code is writing the file) را گزارش می‌کند.
• حساب‌هایی که MCP را به اشتراک نمی‌گذارند. import رد می‌کند و از شما می‌خواهد ابتدا ccam share side --mcp on را اجرا کنید.
• نام گروه‌ها. -g فقط نام گروه می‌پذیرد؛ این نام به پوشه‌ای زیر groups/ تبدیل می‌شود، بنابراین نام‌هایی مانند ../x رد می‌شوند.

مطالب مرتبط

• اشتراک‌گذاری بین حساب‌ها
• اشتراک‌گذاری سرورهای MCP، تنظیمات و تاریخچه
• کپی کردن یک پیکربندی موجود
• همه فرمان‌ها