Документация
Общие настройки MCP для Claude Code и Codex
Храните выбранное описание MCP в Hub и подключайте к нему свои клиенты. Agent Hub собирает существующие описания и создаёт записи запуска в нужном каждому клиенту формате, сохраняя посторонние настройки. Поддерживается и DeepSeek Harness.
В этом руководстве речь об общих настройках. Это не объединение подписок, не перенос входа к провайдерам и не подключение всех клиентов к одному запущенному процессу MCP.
Проверьте существующие настройки
Установите Hub по быстрому старту. Посмотрите текущую настройку без запуска серверов MCP:
ahub status
ahub uiВ All data → MCP servers выберите сервер. Сравните копии Hub и клиентов. Приватные значения скрыты. У серверов с одинаковым именем могут различаться учётные данные, аргументы или область действия; одного имени недостаточно, чтобы решить объединить копии.
Выберите и подключите один сервер
- Если нужное описание находится в клиенте, выберите его настройки для Hub и проверьте импорт.
- Выберите Use Hub settings для клиента назначения и проверьте план подключения этого сервера.
- Примените проверенное изменение, затем повторите для остальных нужных клиентов.
- Перезапустите затронутые сессии, чтобы они загрузили запись, и ответьте на запросы доверия самого клиента.
Каждый план показывает направление и файлы. Импорт в Hub и подключение клиента — отдельные действия. Uses Hub settings означает, что существующая запись запуска уже указывает на этот Hub; различие только в пути Node или пакета само по себе не требует разрешать конфликт.
Для первой общей настройки инструментов, навыков и инструкций подготовьте план:
ahub quick --dry-runКогда будете готовы, запустите интерактивную настройку:
ahub quickQuick меняет больше, чем подключение одного сервера. Прочитайте план перед подтверждением; явный dry run и неинтерактивный вызов ничего не применяют.
Отдельно проверьте подключение
Используйте Test the connection для выбранного сервера или выполните:
ahub doctorDoctor запускает подключения MCP и получает список инструментов, не вызывая их. Совпадение настроек не доказывает доступность сервиса; успешное получение списка инструментов не доказывает работоспособность каждой операции backend или нужных прав.
Учитывайте последующие изменения
Меняйте основное описание в Hub, затем проверяйте новый план подключения выбранных клиентов. Если вы отдельно изменили копию клиента, изучите различие и выберите, какую копию оставить. Автоматического двустороннего согласования всех изменений MCP сейчас нет.
Политики разрешений самого клиента остаются отдельными. Внешние инструменты не соблюдают рекомендательную блокировку Hub, поэтому во время записи настроек затронутые клиенты должны бездействовать. Устаревший план нужно построить заново; не применяйте старую команду после изменения файлов.
Восстановите состояние или выберите более простой подход
Результат применения содержит сведения для восстановления. Перед использованием проверьте записанный restore или undo: последующие изменения могут блокировать небезопасный откат. Одно удаление CLI не восстанавливает настройки клиентов и не удаляет записи запуска. См. восстановление.
Для одного-двух серверов можно вручную поддерживать настройки в форматах клиентов. Другие варианты — шаблоны в Git и инструменты вроде Rulesync. Не связывайте целиком несовместимые файлы настроек. Hub полезен, если сбор описаний, проверка подключения и восстановление экономят работу по сравнению с вашим текущим подходом.