add-mcp CLI
add-mcp одной командой прописывает MCP-сервер в конфигурации 25 агентов: Claude Code, Codex, Cursor, VS Code, Zed и других
- 321 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Правит конфигурационные файлы агентов, в том числе глобальные в домашней папке
- Значения из `--env` и `--header` записываются в конфигурацию агента, для общего репозитория есть флаг `--gitignore`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/add-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Правит конфигурационные файлы агентов, в том числе глобальные в домашней папке
- Значения из `--env` и `--header` записываются в конфигурацию агента, для общего репозитория есть флаг `--gitignore`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
add-mcp — консольная утилита, которая записывает MCP-сервер в конфигурационные файлы нескольких агентов за один вызов. На вход идет адрес удаленного сервера, имя пакета npm или команда запуска, например `npx add-mcp https://mcp.context7.com/mcp`. Утилита определяет агентов по файлам проекта (`.cursor/`, `.vscode/`, `.mcp.json`), показывает выбор и пишет запись в формат каждого агента. По умолчанию установка идет в проект, а с флагом `-g` в домашнюю папку. Флаги `--env`, `--header` и `--transport` задают переменные окружения, заголовки и тип связи (http или sse). Команда `find` ищет серверы в реестре add-mcp, `list` показывает установленные, `remove` удаляет, `sync` выравнивает имена между агентами. Флаг `--auto-approve` включает автоодобрение инструментов в Codex и Claude Code. Для встраивания в свои утилиты есть программная функция `upsertServer`.
Для кого. Разработчикам, которые подключают одни и те же MCP-серверы к нескольким агентам и не хотят править JSON и TOML вручную.
Подходит, если
- Сразу в Claude Code, Cursor и Codex требуется подключить один сервер одной командой
- В репозитории лежит общий `.mcp.json`, и команда хочет ставить серверы единообразно
- Подходящий сервер ищут по слову: `npx add-mcp find vercel`
- Имена одних и тех же серверов в разных агентах разошлись, и команда `sync` возвращает их к общему виду
Не подходит, если
- Агента нет в списке из 25 поддерживаемых, и свои MCP-конфиги он не читает
- Сервер уже подключен через плагин агента, и вторая запись в конфигурации ни к чему
- Нужен каталог серверов с оценками и проверкой безопасности: add-mcp записывает то, что вы укажете
Пример запроса к агенту
Подключи MCP-сервер Context7 командой add-mcp сразу в Claude Code и Cursor для этого проектаОграничения
- Не каждое поле понимают все агенты: `--timeout`, `--scopes` и `--bearer-token-env` применяются выборочно, остальным агентам утилита выводит предупреждение и поле отбрасывает.
- Для Pi нужен адаптер `pi-mcp-adapter`, а Kimi Code читает проектный `.kimi-code/mcp.json` только после того, как вы доверите папку.
- Запущенной сессии нужна перезагрузка конфигурации: у Hermes Agent это `/reload-mcp`, у fx `/mcp reload`, у Pi `/reload`.
- Для fx проектный файл не работает: сервер читается только из `~/.fx/mcp.json`.
Как отключить. Удалите сервер командой `npx add-mcp remove` с именем сервера или вручную из файлов конфигурации агентов. Реестр, сохраненный при первом поиске, лежит в `~/.config/add-mcp/config.json`.
Частые вопросы
Как добавить MCP-сервер в Claude Code и Cursor одной командой?
Выполните `npx add-mcp ссылка-на-сервер -a claude-code -a cursor`. Без флага `-a` утилита определит агентов по файлам проекта и покажет выбор.
Чем add-mcp отличается от `mcpm`?
add-mcp только записывает сервер в конфигурации агентов, а `mcpm` ведет реестр и обновляет серверы. Первый удобнее для разовой установки, второй для сопровождения набора.
Как посмотреть, что уже установлено?
Команда `npx add-mcp list` показывает серверы во всех найденных агентах. Команда `list-agents` выводит поддерживаемых агентов с их областями, проект и глобальная.
Как установить MCP-сервер глобально?
Добавьте флаг `-g`: `npx add-mcp https://mcp.example.com/mcp -g -a claude-code -y`. Без него запись попадет в файлы текущего проекта.
Как передать серверу ключ API?
Для локального сервера используйте `--env "API_KEY=значение"`, для удаленного `--header "Authorization: Bearer ..."`. Значения попадут в файлы конфигурации агентов, поэтому для общего репозитория добавьте `--gitignore`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструменты1MCP Agent
1mcp-agent
Один сервер MCP вместо многих: агент объединяет подключенные серверы и отдает их клиенту через единый адрес. Версия бета
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
Легкий CLI, чтобы находить, смотреть и вызывать инструменты MCP-серверов прямо из командной строки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| add-mcp (эта карточка) | нет | 321 | ||
| MCPM | нет | 1 021 | менеджер пакетов и реестр MCP, который еще и обновляет серверы | |
| mcp-installer | нет | не нужна | 1 536 | MCP-сервер, который по просьбе агента ставит другие серверы из npm и PyPI |
Коротко о README
README открывается командой установки и примером с Context7, затем описывает поиск в реестре, таблицу из 25 агентов с путями к проектным и глобальным файлам и особенности отдельных клиентов. Дальше идут области установки, автоопределение агентов, команды `find`, `list`, `remove` и `sync`, примеры флагов и таблица полей, которые понимают не все агенты.