Интеграция AI-клиентов (IDE Integration)

ServBay позволяет в один клик подключить встроенный MCP Server к вашим основным AI-клиентам, автоматически прописывая необходимые настройки MCP — вам не нужно вручную редактировать файлы конфигураций. В этой статье рассказывается, как выполнить подключение, какие клиенты поддерживаются и каким образом происходит интеграция.

Предварительные требования

• ServBay установлен и запущен.
• Целевой AI-клиент установлен (ServBay определяет возможность подключения по его настройкам).

Подключение в один клик

Перейдите в ServBay Настройки (Settings) → Интеграция AI-клиентов (IDE Integrations), найдите нужный клиент в списке, нажмите Интегрировать (Integrate). ServBay выполнит следующие действия:

1. Найдет встроенный в дистрибутив исполняемый файл servbay-mcp (отдельная установка не требуется).
2. Добавит или обновит MCP-конфигурацию в соответствии с требованиями выбранного клиента (только добавляет/обновляет узел servbay, сохраняя все ваши прочие настройки MCP).
3. Покажет статус подключения.

Чтобы отменить интеграцию, нажмите Удалить (Remove).

Статус подключения

Для каждого клиента будет отображен его статус подключения относительно текущего экземпляра ServBay на вашем компьютере:

Статус	Описание
Подключено	Клиент настроен на использование servbay-mcp из данной установки ServBay
Подключено (другой путь)	Клиент настроен на servbay, но указывает на другой путь (например, другую копию ServBay)
Не подключено	Клиент обнаружен, но еще не интегрирован
Не обнаружено	Клиент на этом компьютере не найден

Поддерживаемые клиенты и способы интеграции

Клиент	Способ интеграции	Место хранения конфигурации
Claude Code	Официальная CLI: claude mcp add --scope user --transport stdio servbay -- <bin>	Пользовательская MCP-конфигурация Claude Code
Codex	Официальная CLI: codex mcp add (если CLI недоступна, запись в ~/.codex/config.toml)	Конфигурация Codex
Cursor	Запись в ~/.cursor/mcp.json (верхний уровень — mcpServers)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Запись в пользовательский mcp.json (верхний уровень — servers, type: stdio)	Пользовательский mcp.json VS Code
Claude Desktop	Запись в claude_desktop_config.json (верхний уровень — mcpServers)	claude_desktop_config.json

Отличия схем конфигурации

В разных клиентах верхний уровень MCP-конфигурации называется по-разному: VS Code использует servers, а Cursor / Claude Desktop — mcpServers. ServBay автоматически вставляет правильный ключ в зависимости от клиента, вам не нужно об этом заботиться.

Проверка подключения

После интеграции отправьте через AI-клиент команду, связанную с вашей средой разработки (например, «показать список текущих сервисов ServBay»). Если AI выдаст актуальный список сервисов, подключение выполнено успешно.

Часто задаваемые вопросы (FAQ)

• В: Перезапишет ли интеграция мои существующие настройки MCP?
  • О: Нет. ServBay только добавляет или обновляет узел servbay, сохраняя все ваши существующие MCP Server.
• В: В списке отображается «Не обнаружено»?
  • О: Это значит, что клиент не найден на вашем компьютере. Установите и запустите его хотя бы один раз перед интеграцией.
• В: После интеграции AI не работает?
  • О: Убедитесь, что ServBay запущен. Для Claude Code / Codex, использующих CLI, проверьте доступность официального CLI. Можно попробовать удалить интеграцию и подключить заново.
• В: Что рекомендуется сделать после интеграции?
  • О: Рекомендуем установить AI-правила, чтобы правильно и приоритетно использовать ServBay MCP.

Итог

Благодаря «Интеграции AI-клиентов» вы можете быстро подключить ServBay MCP к любому популярному AI-инструменту — без ручного редактирования конфигураций и без потери текущих настроек. После подключения, с использованием AI-правил, вы сможете легко передать управление вашей локальной средой разработки системе искусственного интеллекта.