Mcp 1с - что важно знать

Подключи MCP 1С к Claude Code или Codex через готовый сервер-посредник и начни с учебной базы. Затем проверь один вызов чтения структуры. В варианте feenlace/mcp-1c агент запускает отдельную программу, которая обращается к HTTP-сервису расширения 1С. Одной настройки агента недостаточно: сначала должен отвечать сервис базы.

Проверено: 22 октября 2026 года по репозиторию feenlace/mcp-1c и инструкции его автора. Команды ниже сверены с документацией; подключение к живой 1С в этом разборе не выполнялось.

Как выбрать mcp 1с под свою задачу?

Выбери конкретный репозиторий и следуй его инструкции. Протокол MCP определяет способ связи с агентом, но не список доступных действий в базе.

Это возможности, описанные авторами проектов на 22.10.2026, а не результат сравнительного тестирования. У ROCTUP среди инструментов есть execute_code, то есть выполнение кода 1С. Не считай любой такой сервер доступом только на чтение.

Расширение - дополнительный модуль внутри 1С. HTTP-сервис - адрес базы, на который программа отправляет запросы и получает ответы; прокси - посредник между этой базой и агентом.

Дальше один маршрут: открытый feenlace/mcp-1c. В его README execute_query ограничен запросами SELECT/ВЫБРАТЬ, есть get_metadata_tree для структуры конфигурации. Возможности остальных редакций нам для первого подключения не нужны.

Как подготовить учебную базу и проверить сервис?

Если у тебя нет права устанавливать расширения или настраивать веб-сервер, остановись на подготовке: передай этот раздел администратору 1С. Копирование команды в Claude Code не создаёт недостающие права.

1. Возьми учебную копию без реальных контактов, зарплат и коммерческих данных. Перед установкой расширения сохрани резервную копию. Не начинай эксперимент на рабочей бухгалтерии.
2. Открой инструкцию установки проекта, скачай программу для своей системы через ссылку Releases в репозитории. На macOS и Linux автор указывает chmod +x mcp-1c для разрешения запуска.
3. На машине с базой установи расширение по инструкции. Например, в Windows автор использует следующую команду; путь здесь нужно заменить на папку своей учебной базы:

mcp-1c --install "C:\путь\к\вашей\базе"

Этот образец рассчитан на программу, доступную по имени в терминале. В Windows используй командную строку cmd с настроенным PATH. Если программа не находится, укажи полный путь к скачанному файлу. В PowerShell одного нахождения файла в текущей папке недостаточно для запуска по короткому имени.

Установка меняет состав расширений и обновляет конфигурацию базы данных. По инструкции перед ней закрывают сеансы этой учебной базы. Не закрывай сеансы других пользователей рабочей базы ради пробы.

4. На Windows настрой публикацию через Apache или IIS: в Конфигураторе открой «Администрирование → Публикация на веб-сервере». Для публикации с именем base включи «Публиковать HTTP-сервисы расширений по умолчанию». По инструкции проектный сервис поставляется в расширении и может не отображаться в общем списке HTTP-сервисов. Для Linux используй отдельные указания автора про webinst, не переноси туда Windows-меню.
5. Проверь адрес сервиса. Для публикации base на этой же машине команда из документации такая:

curl http://localhost/base/hs/mcp-1c/version

Нужен ответ JSON с полем version, не страница входа веб-клиента. В прочитанной инструкции приведён пример {"version":"0.4.10"} и указана необходимость расширения не старее этой версии для описанной сборки. Это версия расширения, не номер платформы 1С и не обещание, что твой сервер вернёт ровно такую строку. Сверяй требования именно скачанной сборки.

localhost означает компьютер, на котором запускаешь команду. Если 1С на другом сервере, адрес публикации даст администратор. Для удалённого подключения используй согласованный защищённый адрес с HTTPS; не выставляй учебный HTTP-пример в открытый интернет. Локальный процесс mcp-1c может работать на Mac, а подготовка HTTP-сервиса базы требует отдельной проверки: автор инструкции описывает её на Windows и Linux.

Как подключить сервер к Claude Code?

Запусти терминал в папке учебного проекта. В команде из инструкции замени путь к программе и адрес после --base на свои. Этот образец для macOS/Linux, когда HTTP-сервис доступен по показанному локальному адресу:

claude mcp add 1c --transport stdio -- /путь/к/mcp-1c --base http://localhost:8080/hs/mcp-1c

Порт 8080 здесь взят из образца автора. Подставь порт своей публикации. Если проверка выше сработала на http://localhost/base/hs/mcp-1c/version, значение --base будет http://localhost/base/hs/mcp-1c, без /version.

Для Windows у автора есть вариант через cmd /c с путём к mcp-1c.exe. Если предпочитаешь файл настройки, вот пример .mcp.json для Windows. Это текстовый файл в формате JSON: имена полей и значения записаны в кавычках. Это форма Claude Code из документации Anthropic с параметрами того же сервера; путь C:\Tools\mcp-1c.exe условный, файл должен действительно там находиться:

{
  "mcpServers": {
    "1c": {
      "type": "stdio",
      "command": "C:\\Tools\\mcp-1c.exe",
      "args": ["--base", "http://localhost/base/hs/mcp-1c"],
      "env": {
        "MCP_1C_USER": "${MCP_1C_USER}",
        "MCP_1C_PASSWORD": "${MCP_1C_PASSWORD}"
      }
    }
  }
}

Файл лежит в корне проекта. Если он уже существует, сохрани копию и добавь только запись 1c, не стирай остальные серверы. Команда в терминале и ручная правка файла здесь альтернативы, не два обязательных действия. Для проекта с .mcp.json подтверди доверие к подключению при запуске Claude Code.

Переменные в env нужны для входа в защищённый HTTP-сервис. Их реальные значения заранее настрой в окружении запуска агента безопасным способом. Не вставляй пароль в промпт, URL или общий репозиторий. Имена MCP_1C_USER и MCP_1C_PASSWORD взяты из документации сервера; их наличие ещё не гарантирует, что у пользователя есть необходимые права в 1С.

Проверь регистрацию командой claude mcp list, затем перезапусти сессию и открой /mcp. Где хранятся настройки и какими способами сервер связывается с агентом, разобрано отдельно в инструкции MCP для Claude Code.

Как настроить тот же сервер в Codex?

У Codex текстовый файл другого формата, TOML: ~/.codex/config.toml, на Windows он находится в %USERPROFILE%\.codex\config.toml. Перед правкой сохрани копию. Добавь таблицу сервера, не заменяя весь файл:

[mcp_servers.1c]
command = "C:\\Tools\\mcp-1c.exe"
args = ["--base", "http://localhost/base/hs/mcp-1c"]
env_vars = ["MCP_1C_USER", "MCP_1C_PASSWORD"]

command и args соответствуют инструкции сервера, env_vars описан в справке OpenAI: это список переменных, которые Codex передаст запускаемой программе mcp-1c. Реальные значения задают до запуска Codex. На Mac/Linux замени command на существующий полный путь к программе, остальные поля относятся к тому же HTTP-сервису.

Вместо ручного файла можно использовать команду автора проекта:

codex mcp add 1c -- /путь/к/mcp-1c --base http://localhost:8080/hs/mcp-1c

Она показывает регистрацию процесса; передачу нужных переменных для авторизации проверь в конфиге отдельно. Не запускай её поверх уже настроенной записи без необходимости. Проектные файлы и настройки доступа разобраны в инструкции Codex MCP.

Выполни codex mcp list, затем открой новую сессию Codex и /mcp. По справке OpenAI первая команда показывает настроенные серверы, а в сессии видны активные подключения. Ни один из этих списков не заменяет запрос к самой базе.

Как проверить результат без чтения рабочих документов?

Отправь агенту учебное задание. Это пример для проверки, а не отчёт о выполненном тесте:

Используй только сервер 1c. Вызови get_metadata_tree
и покажи названия доступных разделов метаданных.
Не читай записи справочников и документы, не выполняй код,
не создавай файлы и ничего не изменяй.
Если доступа нет, верни ошибку инструмента, не угадывай ответ.

Ожидаемый результат - в сессии есть вызов get_metadata_tree и полученный от сервера ответ. Сверь структуру с учебной конфигурацией. Красивый список, написанный моделью без вызова инструмента, не подтверждает подключение.

Разделяй три результата: процесс сервера запустился, HTTP-сервис ответил, инструмент прочитал нужную базу. Для каждого нужна своя проверка. Если ты подключил соседнюю учебную базу, технический успех запроса не делает её правильной целью.

Что делать, если подключение не работает?

Ниже симптомы и действия из руководства feenlace/mcp-1c, прочитанного 22.10.2026. Не снимай защиту базы ради исчезновения ошибки.

Если обычная 1С открывается в браузере, но MCP получает 401, успешный вход в веб-клиент не подтверждает авторизацию HTTP-запроса MCP. Проверь передаваемые учётные данные и настройки проверки подлинности публикации. Не выдавай сервисной учётной записи права администратора как универсальное исправление. Настройки IIS и прав лучше разбирать с администратором по конкретному сообщению.

Какие границы доступа тебе нужно задать?

Начни с отдельной учётной записи, минимально необходимых прав и учебных данных. Ограничение SELECT относится к инструменту запросов выбранного проекта, а не ко всем возможностям запущенного процесса. В README есть локальные файловые помощники; промпт сам по себе не ограничивает права процесса.

Также различай локальный сервер и локальную модель. Даже когда mcp-1c работает на твоём компьютере, результаты его инструментов могут отправляться модели, с которой работает агент. Перед подключением рабочих данных согласуй их передачу и обработку. Настройка анонимизации другого проекта не включается автоматически в этом маршруте.

Чтобы закрепить границы работы агента в проекте, возьми в ClaudeBase шаблоны CLAUDE.md и AGENTS.md и посмотри разбор «Рабочее окружение: правила проекта и разрешения». Посмотри состав и условия подписки ClaudeBase и выбери нужные материалы: программу можно посмотреть без оплаты, доступ к базе открывается по подписке. Подписки Anthropic и OpenAI оплачиваются отдельно.

Источники

Все страницы ниже открыты 22 октября 2026 года. Примеры сверены с документацией, но работа с установленной 1С здесь не проверялась.

• feenlace/mcp-1c: инструменты и параметры запуска.
• Руководство feenlace: расширение, HTTP-сервис, клиенты и ошибки.
• ROCTUP/1c-mcp-toolkit: режимы и инструменты.
• Anthropic: MCP в Claude Code.
• OpenAI: MCP в Codex.