@theyahia/1c-rest-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ONEC_LOGIN | Yes | Логин для HTTP Basic Auth | |
| ONEC_BASE_URL | Yes | Базовый URL сервера 1С (например http://localhost:8080/base) | |
| ONEC_PASSWORD | Yes | Пароль для HTTP Basic Auth | |
| ONEC_SERVICES | No | Список модулей через запятую (по умолчанию: all) | all |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_entitiesA | Получить список всех доступных сущностей базы 1С: справочники (Catalog_*), документы (Document_*), регистры (AccumulationRegister_*, InformationRegister_*). Используй этот инструмент первым при работе с незнакомой базой 1С. |
| get_document_by_numberA | Найти документ в 1С по номеру. Удобная обёртка над OData $filter. Пример: найти накладную №ТД-00123 от 2025-03-01. |
| get_catalogsA | Получение данных из справочников 1С через OData 3.0. Поддерживает фильтрацию, сортировку, пагинацию. |
| get_documentsB | Получение документов 1С через OData 3.0. Фильтрация по дате, типу, произвольным полям. |
| create_documentB | Создание нового документа в 1С через OData POST. |
| update_documentB | Обновление существующего документа в 1С через OData PATCH. |
| get_registerC | Получение данных из регистров 1С (информационных и накопления) через OData 3.0. |
| get_reportC | Получение отчёта из 1С по произвольному URL HTTP-сервиса (/hs/...). |
| odata_queryA | Произвольный OData 3.0 запрос к любой сущности 1С. Поддерживает $filter, $select, $expand, $orderby, $top, $skip, $inlinecount. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools have distinct purposes, but get_documents and odata_query overlap somewhat since odata_query can retrieve documents as well. However, the specialized tools (get_document_by_number, get_catalogs, etc.) maintain clear boundaries.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., create_document, get_catalogs, update_document). No deviations or mixed conventions.
9 tools is well-scoped for a 1C REST server, covering documents, catalogs, registers, reports, and a generic query tool. Not excessive or insufficient.
Document lifecycle has create, read (multiple), update but lacks delete. No update or delete for catalogs/registers. Minor gaps like missing delete operations, but core read/write coverage is present.