1C OData MCP·evilbruce666

1C OData MCP — подключение и инструкция

1C OData MCP даёт агенту доступ к данным 1С:Предприятие через опубликованный OData-интерфейс выбранной базы.

РазработкаЛокальноAPI-ключ

Что умеет этот сервер

01

1C OData MCP даёт агенту доступ к данным 1С:Предприятие через опубликованный OData-интерфейс выбранной базы.

02

В отличие от расширений, этот вариант опирается на standard.odata и его метаданные.

03

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

Задача для знакомства

Через 1C OData MCP прочитай метаданные выбранной тестовой сущности и несколько записей. Данные и документы не изменяй.

Уточнить результат

Сверь базу, сущность, типы полей и фильтр. При ошибке публикации проверь регистр пути, HTTP-авторизацию и наличие объекта в OData, а не меняй сервер на другой.

Как подключить

Выберите подходящий способ

Подключить 1C OData MCP MCP

Добавь npx -y 1c-odata-mcp в клиент. Передай ODATA_BASE_URL с точным путём /odata/standard.odata/ и учётные данные через env. Проверь $metadata и права на чтение тестового объекта, прежде чем разрешать запись.

Что понадобится

  • Node.js/npm, HTTPS-публикация OData нужной базы, username/password или иной поддерживаемый способ авторизации из README.
  1. 01

    Подготовь окружение

    Node.js/npm, HTTPS-публикация OData нужной базы, username/password или иной поддерживаемый способ авторизации из README.

  2. 02

    Установи и настрой

    Добавь npx -y 1c-odata-mcp в клиент. Передай ODATA_BASE_URL с точным путём /odata/standard.odata/ и учётные данные через env. Проверь $metadata и права на чтение тестового объекта, прежде чем разрешать запись.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Пример MCP-конфигурации на основе README

{
  "mcpServers": {
    "1c-odata": {
      "command": "npx",
      "args": [
        "-y",
        "1c-odata-mcp"
      ],
      "env": {
        "ODATA_BASE_URL": "https://<сервер>/<база>/odata/standard.odata/",
        "ODATA_USERNAME": "...",
        "ODATA_PASSWORD": "..."
      }
    }
  }
}

Первый запрос — пример для чата агента

Через 1C OData MCP прочитай метаданные выбранной тестовой сущности и несколько записей. Данные и документы не изменяй.

Как проверить

Сверь базу, сущность, типы полей и фильтр. При ошибке публикации проверь регистр пути, HTTP-авторизацию и наличие объекта в OData, а не меняй сервер на другой.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет 1C OData MCP

1C OData MCP даёт агенту доступ к данным 1С:Предприятие через опубликованный OData-интерфейс выбранной базы.

В отличие от расширений, этот вариант опирается на standard.odata и его метаданные. Доступные сущности и операции определяются публикацией и правами учётной записи 1С.

Что подготовить перед подключением

Node.js/npm, HTTPS-публикация OData нужной базы, username/password или иной поддерживаемый способ авторизации из README.

Как установить и подключить

Добавь npx -y 1c-odata-mcp в клиент. Передай ODATA_BASE_URL с точным путём /odata/standard.odata/ и учётные данные через env. Проверь $metadata и права на чтение тестового объекта, прежде чем разрешать запись.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай метаданные сущности и запроси несколько записей с фильтром. Используй технические имена из $metadata, а не угадывай их по интерфейсу 1С.

Как проверить результат и решить проблемы

Сверь базу, сущность, типы полей и фильтр. При ошибке публикации проверь регистр пути, HTTP-авторизацию и наличие объекта в OData, а не меняй сервер на другой.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Обычный вход в 1С не означает, что OData опубликован. Права и доступность объектов различаются по конфигурации; изменение через API требует отдельной проверки бизнес-логики.

Исходники и документация

Репозиторий: evilbruce666/1c-odata-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о 1C OData MCP

1C OData MCP даёт агенту доступ к данным 1С:Предприятие через опубликованный OData-интерфейс выбранной базы.
Вернуться в библиотеку