1С:Предприятие MCP: Документация

Подключение

npx -y @theyahia/1c-rest-mcp (stdio) или HTTP_PORT=3000 npx @theyahia/1c-rest-mcp --http (Streamable HTTP). Auth: HTTP Basic — ONEC_LOGIN + ONEC_PASSWORD (пользователь 1С с нужными правами) и ONEC_BASE_URL (адрес опубликованной инфобазы, без /odata/...). В 1С Конфигураторе должны быть включены HTTP-сервисы и публикация OData; сам эндпоинт получается как ${ONEC_BASE_URL}/odata/standard.odata/.

Инструменты

32 инструмента по 11 модулям (фильтруются через ONEC_SERVICES): обнаружение — всегда включено (list_entities, get_document_by_number, get_metadata, describe_entity), справочники (get_catalogs, create_catalog_item, update_catalog_item), документы (get_documents, create_document, update_document, post_document, unpost_document, delete_document, get_document_lines), регистры (get_register, write_information_register, get_accumulation_balance), бухгалтерия (get_accounting_register), константы (get_constant, set_constant), быстрые операции (find_by_description, get_by_key, count_entities, set_deletion_mark, get_recent_documents), отчёты (get_report), произвольный OData (odata_query), пакетные операции (batch_create_documents, batch_update_catalog_items, batch_query), отслеживание изменений (poll_changes_since, list_subscriptions — у 1С нет вебхуков, только поллинг).

Сценарий для агента

«Найди счёт ТД-00123 от 1 марта и покажи его строки и сумму», «создай документ реализации для контрагента ООО «Ромашка» с двумя позициями», «сведи остатки по регистру накопления за квартал».

Важно

Community-проект (theYahia, серия «Russian API MCP»), не официальный продукт фирмы «1С». Формы URL для проведения и регистров нужно сверять со своей конфигурацией через get_metadata.