Как установить Ox MCP в VS Code

Чтобы установить Ox MCP в VS Code, нажмите кнопку установки ниже (deep-link) — VS Code откроется и подключит сервер. Правка JSON не нужна.

Ссылка установки

vscode:mcp/install?eyJuYW1lIjoib3giLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkByaGVvcHlyaW4vb3gtbWNwIl0sImVudiI6eyJPWF9NQ1BfQUNDT1VOVFMiOiIiLCJPWF9NQ1BfQ0FMREFWX0FQUF9QQVNTV09SRCI6IiIsIk9YX01DUF9DQUxEQVZfU0VSVkVSIjoiIiwiT1hfTUNQX0NBTERBVl9VU0VSIjoiIiwiT1hfTUNQX0RFRkFVTFRfU0VSVkVSIjoiIiwiT1hfTUNQX0VOQUJMRV9DQUxEQVYiOiIiLCJPWF9NQ1BfRU5BQkxFX0NBTEVOREFSX1JFU1BPTkRfRVZFTlQiOiIiLCJPWF9NQ1BfRU5BQkxFX0VNQUlMX1NFTkQiOiIiLCJPWF9NQ1BfTUFJTF9BUFBfUEFTU1dPUkQiOiIiLCJPWF9NQ1BfTUFJTF9TRVJWRVIiOiIiLCJPWF9NQ1BfTUFJTF9VU0VSIjoiIiwiT1hfTUNQX1BFUlNPTkFMX0NBTERBVl9BUFBfUEFTU1dPUkQiOiIiLCJPWF9NQ1BfUEVSU09OQUxfQ0FMREFWX1NFUlZFUiI6IiIsIk9YX01DUF9QRVJTT05BTF9DQUxEQVZfVVNFUiI6IiIsIk9YX01DUF9XT1JLX0VOQUJMRV9DQUxFTkRBUl9DUkVBVEVfRVZFTlQiOiIiLCJPWF9NQ1BfV09SS19NQUlMX0FQUF9QQVNTV09SRCI6IiIsIk9YX01DUF9XT1JLX01BSUxfU0VSVkVSIjoiIiwiT1hfTUNQX1dPUktfTUFJTF9VU0VSIjoiIn19

Установить в 1 клик через Unyly

1
Нажмите кнопку установки
VS Code откроется автоматически.
2
Подтвердите
Разрешите добавление MCP-сервера.
3
Готово
Сервер подключён, перезапуск обычно не нужен.

Где лежит конфиг

VS Code хранит MCP в пользовательском settings.json (глобально) или .vscode/mcp.json в рабочей области (только этот проект). Ссылка установки добавляет запись на уровне пользователя.

Область: проект или глобально

Пользовательские настройки — везде; воркспейсный .vscode/mcp.json ограничивает сервер этим проектом и шарится через git.

API-ключи и переменные окружения

Этому серверу нужны переменные окружения: OX_MCP_ACCOUNTS, OX_MCP_CALDAV_APP_PASSWORD, OX_MCP_CALDAV_SERVER, OX_MCP_CALDAV_USER, OX_MCP_DEFAULT_SERVER, OX_MCP_ENABLE_CALDAV, OX_MCP_ENABLE_CALENDAR_RESPOND_EVENT, OX_MCP_ENABLE_EMAIL_SEND, OX_MCP_MAIL_APP_PASSWORD, OX_MCP_MAIL_SERVER, OX_MCP_MAIL_USER, OX_MCP_PERSONAL_CALDAV_APP_PASSWORD, OX_MCP_PERSONAL_CALDAV_SERVER, OX_MCP_PERSONAL_CALDAV_USER, OX_MCP_WORK_ENABLE_CALENDAR_CREATE_EVENT, OX_MCP_WORK_MAIL_APP_PASSWORD, OX_MCP_WORK_MAIL_SERVER, OX_MCP_WORK_MAIL_USER. Вставь реальные значения в блок env (Cursor / VS Code / Claude Desktop) или флагами -e KEY=value (Claude Code). Держи их в env, а не в args — иначе секреты попадут в логи.

Проверить, что работает

Открой MCP-панель в VS Code — сервер появится после подключения. Наведи на него, чтобы увидеть тулзы.

Если инструменты не появились

· Перезапусти VS Code полностью (не просто окно).
· Проверь команду/конфиг на опечатки; JSON — валидатором.
· Убедись, что установлен Node.js или uv (для npx/uvx-серверов).
· Посмотри логи VS Code — сервер мог упасть на старте (нет env-переменной, битый токен).

Сколько серверов — не много ли

Каждый подключённый сервер добавляет свои инструменты в контекст модели. После ~40–60 инструментов точность выбора падает. Держи включёнными только нужные серверы или доставай весь каталог через шлюз — одно подключение вместо десятков.

Удалить Ox

Удали сервер из settings.json (или .vscode/mcp.json), либо отключи в MCP-панели.

Установить Ox в другом клиенте

Cursor Claude Code Claude Desktop

Частые вопросы

Нужно ли вручную редактировать JSON?

Нет. В VS Code установка идёт командой или deep-link’ом; на Unyly кнопка Install записывает конфиг за вас.

Где лежит конфиг VS Code?

VS Code хранит MCP-серверы во внутренних настройках — при установке командой/кнопкой править файл вручную не нужно.

MCP не появился — что делать?

Перезапустите VS Code, проверьте, что команда/конфиг без опечаток, и что установлены Node.js/пакетный менеджер, если сервер запускается через npx/uvx.

Как обновить Ox?

Серверы через npx/uvx подтягивают свежую версию при запуске. Иначе — переустановите тем же способом.

Безопасно ли ставить Ox?

MCP-сервер работает с правами вашего клиента и доступом к его данным. Ставьте с той же осторожностью, что и любой npm-пакет: проверяйте источник, а секреты держите в env. Verified-серверы на Unyly прошли security-скан.

Сколько стоит Ox?

Установка и просмотр на Unyly бесплатны. Сам сервер может требовать API-ключ стороннего сервиса — это оплачивается у того сервиса, не у Unyly.

Можно ли подключить Ox в ChatGPT или claude.ai?

Напрямую нет: Ox — локальный (stdio) сервер, а ChatGPT/claude.ai принимают только remote-MCP. Обойти можно через шлюз Unyly — он превращает локальные серверы в один remote-эндпоинт.

Command Palette