Підключення 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)

• Q: Чи буде перезаписана моя поточна MCP-конфігурація?
  • A: Ні, ServBay лише додає або оновлює вузол servbay, інші налаштування MCP Server залишаються без змін.
• Q: Чому клієнт показаний як «Не знайдено»?
  • A: Такий статус означає, що програму не знайдено на пристрої. Переконайтеся, що клієнт встановлений і запущений хоча б один раз, після чого повторіть підключення.
• Q: Чому після підключення AI не реагує?
  • A: Перевірте, що ServBay працює. Для клієнтів Claude Code / Codex, підключених через CLI, переконайтеся, що офіційний CLI доступний. За потреби спробуйте видалити підключення та підключити клієнт знову.
• Q: Що рекомендується зробити після підключення?
  • A: Рекомендуємо додатково встановити AI-правила, щоб AI міг правильно й пріоритетно використовувати ServBay MCP.

Висновок

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