خوادم 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

إضافة اسم تملكه المجموعة بالفعل تستبدل تعريفه، وتطبع updated بدلًا من added. ولا تصل الخوادم إلى حساب إلا إذا كان يشارك 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. والافتراضية هي استراتيجية الخيار:

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. ولا تكتب استراتيجية الخيار في .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. وينتظر حتى ثانيتين، ويعدّ القفل الذي عمره أكثر من 10 ثوانٍ قديمًا، كما تفعل مكتبة القفل في Claude Code.
3. يحفظ ملف .claude.json الحالي في backups/ داخل مجلد الحالة، ويحتفظ بأحدث 5 نسخ.
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): … ويستمر التشغيل رغم ذلك. أما التلميح الخاص بالخوادم المضافة داخل جلسة فيخص استراتيجية الخيار وحدها.

ينقل 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، أو انسخ تسجيلات الدخول من ~/.claude باستخدام ccam migrate. ولا تتلقى المجموعة أي ملف تسجيل دخول أبدًا.
• الحسابات التي تعمل. ينسخ 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 والإعدادات والسجل
• نسخ إعداد موجود
• كل الأوامر