Как подключить 1C:Enterprise к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → 1C:Enterprise, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

1C:Enterprise + Gemini

Читайте вашу информационную базу 1С:Предприятие 8.3 (1С:Бухгалтерия, Управление торговлей, 1С:ERP, УНФ и другие конфигурации) через стандартный интерфейс OData: справочники, документы с табличными частями, остатки, обороты и срезы регистров, под именами из метаданных вашей конфигурации. Только чтение, Basic-аутентификация, ваш собственный сервер.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

ONEC_BASE_URL, ONEC_USER, ONEC_PASSWORD

Шаг 1 — Получите учётные данные

Настройка занимает около 30 минут, понадобится ваш администратор 1С. Нужна информационная база 1С:Предприятие 8.3 (платформа 8.3.5 или новее), опубликованная на веб-сервере с включённым стандартным интерфейсом OData, и отдельный пользователь 1С для коннектора.

1. Опубликуйте базу на веб-сервере (Apache или IIS с модулями расширения веб-сервера из поставки платформы). В конфигураторе откройте Администрирование → Публикация на веб-сервере, задайте имя публикации латиницей, установите флажок Публиковать стандартный интерфейс OData и опубликуйте. Если база размещена у провайдера (1cFresh, аренда 1С в облаке), попросите провайдера включить для неё OData.
2. Определите состав стандартного интерфейса OData. По умолчанию через интерфейс не доступен ни один объект. В типовых конфигурациях откройте Администрирование → Синхронизация данных → Настройки стандартного интерфейса OData (или Все функции → Обработки → Настройка стандартного интерфейса OData) и отметьте справочники, документы и регистры, которые ИИ может читать. В остальных конфигурациях разработчик вызывает УстановитьСоставСтандартногоИнтерфейсаOData().
3. Заведите отдельного пользователя 1С для коннектора: роли только на чтение этих объектов и право на использование стандартного интерфейса OData. Форма настроек из шага 2 умеет создать такого пользователя сама.
4. Проверьте в браузере: откройте адрес публикации с /odata/standard.odata/?$format=json на конце и войдите под этим пользователем. JSON со списком объектов значит, что OData работает; пустой список значит, что не выполнен шаг 2.
5. Укажите в ONEC_BASE_URL адрес публикации: тот, по которому открывается веб-клиент, без /odata и без слэша в конце, например https://1c.example.com/trade. В ONEC_USER впишите имя пользователя точно так, как в списке пользователей информационной базы (кириллица допустима), в ONEC_PASSWORD его пароль.
6. Установите коннектор и запустите onec_enterprise_describe_service: он покажет все объекты, включённые в состав OData, с их ключами. Пустой список значит, что в состав OData ещё ничего не добавлено.

Сервер должен быть доступен: AnythingMCP Cloud обращается только к адресам в публичном интернете, поэтому публикуйте базу по HTTPS на внешнем адресе; пароль передаётся через HTTP Basic-аутентификацию. Если сервер 1С стоит во внутренней сети, разверните AnythingMCP у себя (или подключите его через VPN) и добавьте хост в SSRF_ALLOWED_HOSTS.

Что он читает: справочники, документы с табличными частями, регистры сведений, накопления и бухгалтерии, планы счетов, константы и журналы документов, под именами из метаданных вашей конфигурации: Catalog_Номенклатура, Document_РеализацияТоваровУслуг и его строки в Document_РеализацияТоваровУслуг_Товары, AccumulationRegister_ТоварыНаСкладах, AccountingRegister_Хозрасчетный. Подходит любая конфигурация на платформе 1С:Предприятие 8.3: 1С:Бухгалтерия предприятия, Управление торговлей, 1С:ERP, Комплексная автоматизация, УНФ, Розница, ЗУП и самописные.

Остатки, обороты и срезы: по регистрам ИИ читает виртуальные таблицы Balance, Turnovers, BalanceAndTurnovers, SliceLast и SliceFirst (остатки, обороты, остатки и обороты, срез последних, срез первых) через onec_enterprise_get. Параметры передаются в скобках виртуальной таблицы, поэтому 1С отбирает и сворачивает данные на сервере, а не ИИ суммирует тысячи строк документов. Так он отвечает на вопросы об остатках на дату, продажах за период, последнем курсе валюты или сальдо по счёту 62.01.

Как работает ИИ: onec_enterprise_guide бесплатно объясняет имена объектов, отборы и регистры. onec_enterprise_describe_entity показывает реквизиты объекта и их типы, onec_enterprise_query читает списки с отбором, сортировкой, выбором полей и постраничной выборкой, onec_enterprise_get_entity читает один объект по Ref_Key вместе с табличными частями. Ссылочные реквизиты вроде Контрагент_Key содержат GUID; ИИ подставляет наименование, а не показывает вам GUID.

Корректные итоги: ИИ учитывает только проведённые документы (Posted eq true) и не берёт объекты с пометкой удаления, если вы не попросите иначе. Даты приходят без часового пояса: это местное время информационной базы. Суммы указаны в валюте документа, если реквизит не говорит об ином.

Только чтение: ни один инструмент не пишет. Коннектор ничего не создаёт, не изменяет, не проводит и не удаляет, поэтому подтверждать нечего и ни один инструмент не отключён при установке. Настоящая граница доступа: права пользователя 1С. Платформа проверяет их при каждом обращении, и то, что пользователю не видно, в ответ просто не попадает, поэтому нехватка прав может выглядеть как отсутствие данных.

Ограничения: фиксированного лимита запросов нет, но каждый запрос выполняется на вашем сервере 1С. ИИ всегда задаёт $top и $select для больших справочников и регистров и читает длинные списки постранично.

Частые ошибки: 401: 1С не пустила пользователя; проверьте имя, пароль и право на использование стандартного интерфейса OData. 403: вход выполнен, но читать этот объект пользователю нельзя; дайте его роли право на чтение. 404: объект не включён в состав OData, имя написано с ошибкой или ONEC_BASE_URL указан неверно (в нём не должно быть /odata). 400 с текстом «Ошибка при разборе опции запроса»: ошибка в отборе или в имени реквизита. 500 на файловой базе обычно значит, что у учётной записи веб-сервера нет права на запись в каталог информационной базы.

Коннектор не создаёт, не проводит и не удаляет документы и видит только те объекты, которые администратор включил в состав стандартного интерфейса OData.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты 1C:Enterprise.

Доступные инструменты

Примеры запросов

• «Какие остатки по номенклатуре на основном складе на сегодня? Отдельно покажи позиции, которых меньше 10 штук.»
• «Сколько мы отгрузили ООО Ромашка за сентябрь? Разбей по проведённым реализациям.»
• «Найди контрагента с ИНН 7707083893 и покажи счета на оплату, которые мы ему выставили в прошлом месяце.»
• «Какой курс доллара записан в 1С на сегодня?»
• «Какое сальдо по счёту 62.01 на конец сентября и какие покупатели его составляют?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot