MCP-сервер для 1С: инструмент чтения и подключение модели
MCP-сервер для 1С предоставляет клиенту инструменты, которые обращаются к вашей учётной системе. Модель может предложить вызвать инструмент, но сервер должен проверить, разрешено ли это действие. Relay даёт доступ к модели через API; он не устанавливает MCP-сервер, не создаёт пользователя 1С и не выдаёт разрешения на операции в базе.
Начните с одного инструмента, который читает остатки. Передайте коды товара и склада, получите остаток и время, когда его запросили. Такой сценарий можно проверить до подключения агента, не разрешая проведение документов или изменение справочников.
Коротко
API модели и MCP-сервер подключаются к клиенту отдельно.
Ключ Relay не заменяет учётную запись интеграции с 1С.
Проверяйте доступ к каждому складу до чтения данных.
Как устроить MCP-сервер для 1С
Выберите клиент, который поддерживает MCP, и модель. Затем подключите MCP-сервер, который умеет обращаться к 1С. Клиент получает описание инструмента и передаёт его модели. Когда модель предлагает вызов, клиент обращается к MCP-серверу; сервер выполняет разрешённую операцию и возвращает результат клиенту.
Сам MCP не определяет, как вы считаете остатки и какие роли настроили в 1С. Чтобы читать учётную систему, интеграция может вызывать опубликованный HTTP-сервис или другой интерфейс, который предусмотрен вашим решением. Выберите способ, который подходит вашей конфигурации и тому, как вы развернули 1С. Универсальной команды, которая установит всё для любой базы, нет.
Не передавайте модели строку произвольного запроса или возможность выполнить код в 1С. Разрешите инструменту выполнять одну операцию. Ограничьте, что он принимает, чтобы сервер проверял конкретное действие, вместо того чтобы угадывать опасный смысл свободного текста.
Как написать контракт первого инструмента
Назовём демонстрационный инструмент stock_balance. Он принимает код товара и склада. Ниже пример JSON Schema параметров, а не готовый MCP-сервер:
{
"type": "object",
"properties": {
"product_code": { "type": "string", "minLength": 1, "maxLength": 64 },
"warehouse_code": { "type": "string", "minLength": 1, "maxLength": 64 }
},
"required": ["product_code", "warehouse_code"],
"additionalProperties": false
}Число 64 здесь служит примером ограничения: согласуйте допустимую длину с кодами своей базы. Одной схемы мало. Прежде чем запрашивать остаток, сервер должен проверить, существует ли товар, кто отправил запрос и разрешено ли ему читать выбранный склад.
Верните разные результаты, если товар найден, отсутствует или недоступен этому пользователю. Верните количество вместе с единицей измерения и временем получения. Нулевой остаток не равен отсутствующей записи. Не заменяйте ошибку интеграции нулём: клиент может принять его за достоверный учётный факт.
Как проверить права без модели
Создайте отдельную учётную запись интеграции с правами чтения нужных объектов. Не используйте администратора для удобства. Если пользователи видят разные склады, проверьте, кто инициировал запрос и что разрешено именно ему. Не ограничивайтесь тем, что может прочитать сервисная учётная запись.
Определите, кто обращается к инструменту, по тому, как клиент аутентифицировался. Фраза пользователя «я руководитель склада» не даёт новых полномочий. Если сервер не может установить инициатора или проверить склад, завершите вызов отказом до чтения.
Испытайте контракт напрямую: допустимый товар, неизвестный товар, пустой код, недоступный склад и лишнее поле. Отдельно проверьте ситуацию, когда 1С не отвечает. Ожидаемый результат такого теста: явная ошибка интеграции, а не придуманный остаток.
Как подключить модель Relay к MCP-клиенту
Выберите клиент, который поддерживает MCP и подходящий API модели. Возможности конкретного клиента проверьте в интеграциях. Для OpenAI-совместимого подключения задайте https://relay-llm.ru/v1, ключ Relay и точный идентификатор из каталога.
Проверьте поддержку инструментов в карточке модели и в клиенте. Этот отдельный запрос проверяет только текстовый API, он не вызывает MCP:
curl -sS https://relay-llm.ru/v1/chat/completions \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"Какие сведения нужны для запроса остатка товара на складе?"}]}'Затем подключите MCP-сервер по руководству своей версии клиента. Параметры транспорта и запуска не следует копировать между разными клиентами без проверки. Секрет 1С хранится у интеграции; ключ Relay у компонента, вызывающего модель. Ни один из них не нужен в тексте пользовательского вопроса.
Как испытать весь сценарий и учесть расход
Попросите клиента найти остаток для разрешённого склада. Проверьте параметры фактического вызова и сравните результат с 1С. Затем повторите запрос для запрещённого склада: отказ должен сработать независимо от того, как модель сформулировала просьбу.
Сохраняйте в собственном журнале инициатора, инструмент, параметры, решение о доступе и результат операции. История API Relay не заменяет журнал действий в 1С: она относится к вызовам модели.
Описание инструментов и их результаты входят в контекст модели. Не возвращайте весь справочник, если нужен остаток одной позиции. Проверьте стоимость в каталоге и задайте отдельному ключу лимит расходов для опыта.
Как написать MCP-сервер для 1С без готового универсального доступа к базе?
Выберите один разрешённый метод учётной системы, опишите параметры и оберните его инструментом. Ваша интеграция обращается к учётной системе и проверяет, что разрешают роли.
Нужен ли MCP для обычного запроса к Relay?
Нет. MCP нужен клиенту для инструментов; текстовый запрос к модели выполняется через API Relay отдельно.
Можно ли сразу разрешить проведение документов?
Сначала проверьте чтение. Для записи отдельно нужны подтверждение, защита от повторного выполнения и проверка результата операции.
Универсальный MCP-сервер даёт права на всю базу?
Протокол сам по себе прав не выдаёт. Интеграция должна проверить, какие объекты может читать инициатор и что позволяют роли 1С.