Инструменты по категориям
Сервер обращается по HTTP к стандартной OData-публикации 1С и читает EDMX для структуры сущностей. Полный каталог содержит 56 tools: 21 чтения/аналитики и 35 записи.
Инструменты в этой категории
read.analytics.get_payments_breakdown, read.analytics.get_deal_history, read.analytics.get_taxes_paid, read.counterparty.find_counterparty, read.counterparty.get_counterparty, read.counterparty.get_customer_history, read.counterparty.get_supplier_history, read.document.search_documents, read.document.get_document, read.system.list_databases, read.system.health_check, read.system.list_organizations, read.schema.list_entities, read.schema.describe_entity, read.organization.get_organization_card, read.analytics.get_sales, read.analytics.get_cashflow, read.analytics.get_debtors, read.analytics.get_inventory, read.analytics.get_sales_breakdown, read.analytics.get_purchases_breakdown | чтение и аналитика сущностей и бизнес-данных. |
|---|---|
write.counterparty.create_counterparty, write.entity.mark_for_deletion, write.catalog.create_nomenclature, write.catalog.create_contract, write.sales.create_invoice, write.document.post_document, write.entity.update_entity, write.counterparty.update_counterparty, write.catalog.update_nomenclature, write.purchase.create_purchase, write.purchase.create_supplier_invoice, write.money.create_payout_order, write.sales.create_shipment, write.document.update_document_lines, write.warehouse.create_return_from_customer, write.warehouse.create_return_to_supplier, write.warehouse.create_transfer, write.warehouse.create_surplus, write.warehouse.create_writeoff, write.warehouse.create_inventory, write.document.add_document_line, write.document.copy_document, write.document.remove_document_line, write.sales.create_act, write.sales.create_services_act, write.money.create_payment, write.money.create_bank_writeoff, write.money.create_cash_receipt, write.money.create_cash_payment, write.sales.create_issued_invoice, write.purchase.create_received_invoice, write.counterparty.create_bank_account, write.counterparty.create_contact_person, write.entity.create_folder, write.entity.move_to_folder | создание, изменение и проведение объектов через OData. |
Ограничения
Зарегистрировано 56 tools: 21 read/analytics и 35 write. Сервер работает read-only по умолчанию, но write-tools не исчезают из tools/list: фактический POST/PATCH блокируется в HTTP-клиенте, пока одновременно не установлены глобальный READ_ONLY=false и ODATA_DB_<ИМЯ>_WRITABLE=true для выбранной базы. Каждый изменяющий tool дополнительно выполняет только preview при confirm=false и пишет при confirm=true; dry-run может делать читающие запросы для разрешения ссылок, но не отправляет изменение. Создание выполняется POST, изменение и строки документов — PATCH, проведение/отмена проведения — bound actions; жесткого DELETE нет, mark_for_deletion меняет DeletionMark. Аннотации MCP помечают post_document и mark_for_deletion destructive, остальные write-tools — не destructive, хотя они создают или изменяют бизнес-данные. Повторные попытки разрешены только для запросов без body; POST/PATCH не retry-ятся. Чтение ограничивается ODATA_MAX_ROWS до 100000 строк, клиентские аналитические агрегации — ODATA_ANALYTICS_MAX_ROWS до 1000000; значения по умолчанию 1000 и 200000 соответственно, поэтому крупные отчеты могут быть тяжелыми для сети и памяти. Несколько баз поддерживаются именованными env-профилями, но все credentials находятся в окружении одного локального процесса; собственного approval UI, OAuth или per-tool ACL нет, безопасность опирается на env-флаги, права пользователя 1С и состав OData. list_entities/describe_entity читают только опубликованный $metadata, а не полную конфигурацию.
Что учитывать
npx -y 1c-odata-mcp или Node.js из собранных исходников и обращается к стандартному OData endpoint 1С по HTTP(S) с Basic Authentication.tools/list: фактический POST/PATCH блокируется в HTTP-клиенте, пока одновременно не установлены глобальный READ_ONLY=false и ODATA_DB_<ИМЯ>_WRITABLE=true для выбранной базы. Каждый изменяющий tool дополнительно выполняет только preview при confirm=false и пишет при confirm=true; dry-run может делать читающие запросы для разрешения ссылок, но не отправляет изменение. Создание выполняется POST, изменение и строки документов — PATCH, проведение/отмена проведения — bound actions; жесткого DELETE нет, mark_for_deletion меняет DeletionMark. Аннотации MCP помечают post_document и mark_for_deletion destructive, остальные write-tools — не destructive, хотя они создают или изменяют бизнес-данные. Повторные попытки разрешены только для запросов без body; POST/PATCH не retry-ятся. Чтение ограничивается ODATA_MAX_ROWS до 100000 строк, клиентские аналитические агрегации — ODATA_ANALYTICS_MAX_ROWS до 1000000; значения по умолчанию 1000 и 200000 соответственно, поэтому крупные отчеты могут быть тяжелыми для сети и памяти. Несколько баз поддерживаются именованными env-профилями, но все credentials находятся в окружении одного локального процесса; собственного approval UI, OAuth или per-tool ACL нет, безопасность опирается на env-флаги, права пользователя 1С и состав OData. list_entities/describe_entity читают только опубликованный $metadata, а не полную конфигурацию.