Общие 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. По умолчанию используется стратегия с флагом:

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. Он ждёт до 2 секунд и считает блокировку старше 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, синхронизация оставляет его нетронутым и сообщает об ошибке. Если блокировку не удаётся взять за 2 секунды, ccam сообщает could not lock … (Claude Code is writing the file).
• Аккаунты, которые не делят MCP. import отказывается работать и предлагает сначала выполнить ccam share side --mcp on.
• Имена групп. -g принимает только имя группы; оно становится папкой внутри groups/, поэтому имена вроде ../x отклоняются.

См. также

• Общий доступ между аккаунтами
• Общие MCP-серверы, настройки и история
• Копирование существующей настройки
• Все команды