How do I use @theyahia/1c-rest-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@theyahia/1c-rest-mcp Get the document with number 'INV-001' and type 'Invoice'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@theyahia/1c-rest-mcp

MCP-сервер для REST API 1С:Предприятие через OData 3.0 -- справочники, документы, регистры, отчёты.

Инструменты (9)

Инструмент	Описание
`list_entities`	Получить список доступных сущностей OData (справочники, документы, регистры)
`get_document_by_number`	Найти документ по номеру и типу (например, СчётФактура №УТ-001)
`get_catalogs`	Чтение справочников через OData ($filter, $select, $orderby, $top, $skip)
`get_documents`	Чтение документов через OData с фильтрацией
`create_document`	Создание документа (POST)
`update_document`	Обновление документа (PATCH по Ref_Key)
`get_register`	Чтение регистров сведений и накопления
`get_report`	Получение отчёта по произвольному URL HTTP-сервиса
`odata_query`	Произвольный OData-запрос с $expand, $inlinecount

Skills

Skill	Описание
`skill-catalog`	Быстрый поиск по справочнику (обёртка над get_catalogs)
`skill-documents`	Запрос документов по типу и датам (обёртка над get_documents)

Настройка (stdio)

{
  "mcpServers": {
    "1c": {
      "command": "npx",
      "args": ["-y", "@theyahia/1c-rest-mcp"],
      "env": {
        "ONEC_BASE_URL": "http://server:8080/base",
        "ONEC_LOGIN": "логин",
        "ONEC_PASSWORD": "пароль"
      }
    }
  }
}

Фильтрация модулей (ONEC_SERVICES)

Чтобы ограничить набор инструментов (например, для экономии контекста LLM):

ONEC_SERVICES=catalogs,documents npx @theyahia/1c-rest-mcp

Доступные модули: catalogs, documents, registers, reports, odata, meta. По умолчанию (all) — все инструменты активны. Инструменты list_entities и get_document_by_number доступны всегда.

Streamable HTTP

ONEC_BASE_URL=http://server:8080/base \
ONEC_LOGIN=admin \
ONEC_PASSWORD=secret \
npx @theyahia/1c-rest-mcp-http
# или: node dist/http.js
# Слушает POST /mcp, GET /health на порту 3000 (PORT=3000)

Переменные окружения

Переменная	Обязательна	Описание
`ONEC_BASE_URL`	Да	Базовый URL сервера 1С (например http://localhost:8080/base)
`ONEC_LOGIN`	Да	Логин для HTTP Basic Auth
`ONEC_PASSWORD`	Да	Пароль для HTTP Basic Auth
`ONEC_SERVICES`	Нет	Список модулей через запятую (по умолчанию: all)

Обратная совместимость: старые имена 1C_BASE_URL, 1C_LOGIN, 1C_PASSWORD тоже поддерживаются.

Smithery

Файл smithery.yaml включён для деплоя на Smithery.

Лицензия

MIT

Install Server

A

license - permissive license

A

quality

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Tools

View all tools

@theyahia/1c-rest-mcp

@theyahia/1c-rest-mcp

Инструменты (9)

Skills

Настройка (stdio)

Фильтрация модулей (ONEC_SERVICES)

Streamable HTTP

Переменные окружения

Smithery

Лицензия

Resources

Tools

Latest Blog Posts

MCP directory API