LegalStack
MCP

Коннектор 1С

Подключение: https://mcp.legalstack.ru/mcp/onec или в составе агрегированного сервера https://mcp.legalstack.ru/mcp.

Имя сервера: legalstack-onec. Инструментов: 14.

onec_create_kontragent

⚠ Outward-facing: создаёт контрагента в справочнике Catalog_Контрагенты внешней базы 1С. Перед созданием проверь дубль через onec_find_kontragent. Возвращает: объект { refKey, code, description, inn }.

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "description": {
      "type": "string",
      "description": "Наименование (например: ЛЕГАЛСТЕК ООО)"
    },
    "inn": {
      "description": "ИНН",
      "type": "string"
    },
    "kpp": {
      "description": "КПП",
      "type": "string"
    },
    "fullName": {
      "description": "Полное наименование",
      "type": "string"
    },
    "parentKey": {
      "description": "Ref_Key родительской группы (по умолчанию: Покупатели и заказчики)",
      "type": "string"
    },
    "isLegal": {
      "description": "Юридическое лицо (true) или физическое (false). По умолчанию true",
      "type": "boolean"
    }
  },
  "required": [
    "description"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_create_realizaciya

⚠ Outward-facing: создаёт документ «Реализация товаров и услуг» во внешней базе 1С (шапка + табличная часть Услуги). Документ создаётся непроведённым. Ключи берутся из onec_find_organization/kontragent/nomenklatura. Возвращает: объект { refKey, number, date, sum, servicesCount, status }.

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Дата документа (ISO 8601, например 2026-03-11T12:00:00)"
    },
    "organization_Key": {
      "type": "string",
      "description": "Ref_Key организации из Catalog_Организации"
    },
    "kontragent_Key": {
      "type": "string",
      "description": "Ref_Key контрагента из Catalog_Контрагенты"
    },
    "currency_Key": {
      "description": "Ref_Key валюты (по умолчанию рубли: 42a77a6c-ba37-11e3-967d-6cf049df7344)",
      "type": "string"
    },
    "bankAccount_Key": {
      "description": "Ref_Key банковского счёта организации",
      "type": "string"
    },
    "sumIncludesVat": {
      "description": "Сумма включает НДС (по умолчанию true)",
      "type": "boolean"
    },
    "documentBezNds": {
      "description": "Документ без НДС (по умолчанию false)",
      "type": "boolean"
    },
    "comment": {
      "description": "Комментарий к документу",
      "type": "string"
    },
    "services": {
      "description": "Строки табличной части Услуги",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "lineNumber": {
            "type": "string",
            "description": "Номер строки (1, 2, 3...)"
          },
          "nomenklatura_Key": {
            "type": "string",
            "description": "Ref_Key номенклатуры"
          },
          "content": {
            "type": "string",
            "description": "Описание услуги"
          },
          "quantity": {
            "type": "number",
            "description": "Количество"
          },
          "price": {
            "type": "number",
            "description": "Цена"
          },
          "sum": {
            "type": "number",
            "description": "Сумма"
          },
          "vatRate": {
            "type": "string",
            "enum": [
              "НДС20",
              "НДС10",
              "НДС0",
              "БезНДС"
            ],
            "description": "Ставка НДС"
          },
          "vatSum": {
            "type": "number",
            "description": "Сумма НДС"
          },
          "incomeAccount_Key": {
            "description": "Ref_Key счёта доходов",
            "type": "string"
          },
          "vatAccount_Key": {
            "description": "Ref_Key счёта учёта НДС по реализации",
            "type": "string"
          }
        },
        "required": [
          "lineNumber",
          "nomenklatura_Key",
          "content",
          "quantity",
          "price",
          "sum",
          "vatRate",
          "vatSum"
        ]
      }
    },
    "operationType": {
      "description": "Вид операции (по умолчанию Услуги)",
      "type": "string",
      "enum": [
        "Услуги",
        "Товары",
        "ТоварыУслуги",
        "Комиссия"
      ]
    }
  },
  "required": [
    "date",
    "organization_Key",
    "kontragent_Key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_delete

⚠ Outward-facing: удаляет запись во внешней базе 1С. Возвращает: текст «Запись удалена».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "Имя ресурса 1С"
    },
    "refKey": {
      "type": "string",
      "description": "Ref_Key (GUID) записи"
    }
  },
  "required": [
    "resource",
    "refKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_find_dogovor

Поиск договора контрагента в Catalog_ДоговорыКонтрагентов. Только чтение. Можно фильтровать по kontragent_Key. Возвращает: массив договоров или текст «Договоры не найдены».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "kontragent_Key": {
      "description": "Ref_Key контрагента для фильтрации",
      "type": "string"
    },
    "search": {
      "description": "Строка поиска по наименованию",
      "type": "string"
    },
    "top": {
      "description": "Количество результатов (по умолчанию 20)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_find_kontragent

Поиск контрагента в 1С по наименованию или ИНН. Только чтение. Возвращает: массив контрагентов или текст «Контрагент не найден».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Строка поиска (наименование или ИНН)"
    },
    "byInn": {
      "description": "Искать по ИНН (true) или по наименованию (false, по умолчанию)",
      "type": "boolean"
    },
    "top": {
      "description": "Количество результатов (по умолчанию 20)",
      "type": "number"
    }
  },
  "required": [
    "search"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_find_nomenklatura

Поиск номенклатуры (товары/услуги) в Catalog_Номенклатура. Только чтение. Возвращает: массив позиций или текст «Номенклатура не найдена».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "search": {
      "description": "Строка поиска по наименованию",
      "type": "string"
    },
    "top": {
      "description": "Количество результатов (по умолчанию 20)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_find_organization

Поиск собственной организации (владельца базы 1С) в Catalog_Организации. Только чтение. Без search возвращает все организации. Возвращает: массив организаций или текст «Организации не найдены».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "search": {
      "description": "Строка поиска по наименованию. Если не указана — вернёт все организации",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_get

Одна запись 1С по Ref_Key. Только чтение. Возвращает: объект записи.

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "Имя ресурса"
    },
    "refKey": {
      "type": "string",
      "description": "Ref_Key (GUID)"
    }
  },
  "required": [
    "resource",
    "refKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_get_resource_schema

Метаданные 1С ($metadata, XML) — структура полей всех ресурсов. Только чтение. Вызывай перед первой записью в незнакомый ресурс (onec_write/onec_update). Возвращает: текст XML-метаданных.

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_list_resources

Список доступных ресурсов 1С (справочники, документы, регистры). Только чтение. Стартовая точка для обнаружения сущностей; структуру полей — onec_get_resource_schema. Возвращает: массив ресурсов или текст «Ресурсы не найдены».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_read

Универсальное чтение записей любого ресурса 1С с OData-фильтрами. Только чтение. Одна запись по Ref_Key — onec_get; для частых сущностей есть onec_find_*. Возвращает: объект { items, count } или текст «Записи не найдены».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "Имя ресурса (Catalog_Контрагенты, Document_РеализацияТоваровУслуг и т.д.)"
    },
    "top": {
      "description": "Количество записей",
      "type": "number"
    },
    "skip": {
      "description": "Пропустить N записей",
      "type": "number"
    },
    "filter": {
      "description": "OData $filter (например: Description eq 'ООО Рога')",
      "type": "string"
    },
    "select": {
      "description": "Поля через запятую",
      "type": "string"
    },
    "orderby": {
      "description": "Сортировка (например: Date desc)",
      "type": "string"
    }
  },
  "required": [
    "resource"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_status

Статус подключения интеграции 1С. Только чтение. Возвращает: текст «подключена» / «не подключена».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_update

⚠ Outward-facing: обновляет поля или табличные части записи во внешней базе 1С. Возвращает: текст «Запись обновлена».

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "Имя ресурса 1С"
    },
    "refKey": {
      "type": "string",
      "description": "Ref_Key (GUID) записи"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Обновляемые поля"
    }
  },
  "required": [
    "resource",
    "refKey",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

onec_write

⚠ Outward-facing: создаёт произвольную запись в любом ресурсе внешней базы 1С. Для частых сущностей есть специализированные onec_create_*; формат полей — onec_get_resource_schema. Возвращает: объект созданной записи.

Параметры (JSON Schema)
{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "Имя ресурса 1С"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Данные записи в формате OData"
    }
  },
  "required": [
    "resource",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

На этой странице