Прокси-реконнект для MCP-клиента 1С

client_mcp_vanessa_proxy

Stdio-прокси между Claude Code и MCP-сервером client_mcp внутри 1С, который сам переподключается после рестарта 1С без ручной команды /mcp

MCP-серверРоссийский стек

jimmo910/client_mcp_vanessa_proxyАвтор:Jimmo910

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/client-mcp-vanessa-proxy

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio vanessa -- uvx run --script '/путь/к/mcp-proxy-reconnect.py'

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"vanessa","type":"stdio","command":"uvx","args":["run","--script","/путь/к/mcp-proxy-reconnect.py"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "vanessa": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add vanessa -- uvx run --script '/путь/к/mcp-proxy-reconnect.py'

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.vanessa]
command = "uvx"
args = ["run", "--script", "/путь/к/mcp-proxy-reconnect.py"]

Если файл уже есть, допишите блок в конец.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "vanessa": {
      "type": "local",
      "command": [
        "uvx",
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "vanessa": {
      "command": "uvx",
      "args": [
        "run",
        "--script",
        "/путь/к/mcp-proxy-reconnect.py"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MCP_BACKEND_URLнеобязательная: URL MCP backend сервера, например http://localhost:9874/mcp
MCP_PROXY_LOGнеобязательная: Путь к лог-файлу прокси
MCP_PROXY_WAIT_TOOLS_MINнеобязательная: Минимальное количество инструментов для готовности backend
MCP_PROXY_WAIT_TOOLS_TIMEOUTнеобязательная: Таймаут ожидания регистрации инструментов backend
MCP_PROXY_INIT_PROBEнеобязательная: Время ожидания ответа backend при старте перед offline-stub
MCP_PROXY_INIT_CACHEнеобязательная: Путь к кэшу последнего успешного initialize
MCP_PROXY_TOOLS_CACHEнеобязательная: Путь к кэшу последнего успешного tools/list
MCP_SERVER_LABELнеобязательная: Имя сервера в offline-stub
MCP_START_HINTнеобязательная: Команда запуска 1С, которую прокси подсказывает при выключенной 1С

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 7f05a3e.

Текст для агента

Поставь uv, скачай mcp-proxy-reconnect.py из репозитория Jimmo910/client_mcp_vanessa_proxy и добавь его в .mcp.json как stdio-сервер vanessa с command равным пути к uv и args ["run", "--script", "путь/к/mcp-proxy-reconnect.py"], затем запусти 1С с параметром /C"runMcp;mcpPort=9874".

Другие способы из описания автора

git clone https://github.com/Jimmo910/client_mcp_vanessa_proxy.git

Или скачать один файл: wget https://raw.githubusercontent.com/Jimmo910/client_mcp_vanessa_proxy/main/mcp-proxy-reconnect.py. Нужен установленный uv.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скрипт встает между Claude Code и MCP-сервером, который поднимается внутри клиента 1С расширением client_mcp (onec-client-mcp-devkit и совместимые сборки). Сам клиент 1С перезапускается по многу раз за сессию разработки, и каждый раз старый Mcp-Session-Id умирает, а Claude Code сам не переподключается и требует ручной команды /mcp. Прокси ловит эту ошибку, сбрасывает протухшую сессию, заново отправляет закэшированный initialize и повторяет исходный запрос с новым session id, так что для Claude Code сервер выглядит постоянно подключенным. Если 1С в момент запуска Claude Code вообще не поднята, прокси сразу отдает закэшированный список инструментов вместо таймаута, а на вызов инструмента возвращает понятную инструкцию, чем запустить 1С.

Для кого. Для разработчиков расширений 1С, которые ведут агентную разработку через MCP-сервер в клиенте 1С и устали нажимать /mcp после каждого рестарта.

Подходит, если

Разрабатываете расширение 1С с MCP-сервером client_mcp и 1С часто перезапускается
Хотите, чтобы Claude Code не спрашивал /mcp после каждого DESIGNER /LoadCfg
Нужен плавный переход, когда 1С еще не запущена в начале сессии

Не подходит, если

У вас другой backend MCP, не связанный с client_mcp.cfe и портом 1С
Нужен сам MCP-сервер для 1С, а не только прокси поверх него

Пример запроса к агенту

Подключись к тестовому клиенту 1С через vanessa и запусти сценарий Vanessa Automation заново

Ограничения

Прокси решает только удержание сессии Claude Code, сам MCP-сервер внутри 1С все равно должен поднять client_mcp.cfe. Для полностью автоматического цикла нужна сборка client_mcp из ветки master с динамической регистрацией инструментов, в релизах 0.6.x инструменты Vanessa Automation регистрируются только ручным кликом в форме. Состояние backend (открытая feature, подключенный TestClient) при рестарте 1С теряется, агенту может понадобиться заново выполнить шаги подключения. Автор проверял на macOS с 1С:Предприятие 8.3.27 и Vanessa Automation 1.2, под другой конфигурацией может понадобиться подстроить порог ожидания инструментов.

Как отключить. Удалите запись vanessa из mcpServers в .mcp.json Claude Code или отключите сервер командой /mcp.

MCP

Транспорт: stdio
Авторизация: не нужна

Переменные окружения
Переменные окружения
MCP_BACKEND_URL	Адрес backend MCP-сервера 1С, по умолчанию http://localhost:9874/mcp
MCP_START_HINT	Команда старта 1С, которую прокси подскажет агенту, если база выключена
MCP_PROXY_WAIT_TOOLS_TIMEOUT	Сколько ждать регистрации инструментов backend после рестарта 1С, по умолчанию 120 секунд

Проверка безопасности

Только проксирует JSON-RPC между Claude Code и уже настроенным MCP-сервером 1С, сам никаких действий в 1С не выполняет

Коротко о README

README подробно объясняет проблему: при рестарте client_mcp.cfe выдает новый Mcp-Session-Id, а Claude Code не умеет переподключаться сам, поэтому за сессию разработки набегает десяток ручных /mcp. Показана схема работы прокси, офлайн-заглушка на случай выключенной 1С, полная таблица переменных окружения с дефолтами и пример скрипта запуска 1С с ожиданием готовности через curl. Отдельно объяснено отличие от общего mcp-proxy и указана история: баг зафиксирован как issue в апстриме onec-client-mcp-devkit.

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

Чем это отличается от sparfenyuk/mcp-proxy?

Тот прокси общего назначения не обрабатывает HTTP 404 Session not found переинициализацией, а просто пробрасывает ошибку клиенту. Этот прокси создан для восстановления сессии после рестарта 1С.

Нужно ли что-то настраивать для стандартной установки?

Нет, все переменные окружения опциональны и рассчитаны на локальную 1С на порту 9874, менять их нужно только при нестандартной конфигурации.

Superpowers

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.

Скиллы Мэтта Покока для инженеров

Skills For Real Engineers

Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.

Spec Kit

Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

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

Похожие

Superpowers

Скиллы Мэтта Покока для инженеров

Spec Kit

Референсные MCP-серверы