@rcs-kz/mcp-1c

Production MCP server for 1C:Enterprise. Connect Claude, Cursor, Cline, Continue to your 1C database — read invoices/contracts/partners and write documents through AI conversations.

What it does

Gives AI assistants direct access to your 1C:Enterprise database (Bukhgalteria, UNF, ERP, Управление торговлей, custom configurations) through the standard Model Context Protocol.

Solo (free) tools:

• ping — health check
• execute_query — run SELECT/ВЫБРАТЬ queries
• get_metadata — describe table/document structure
• get_object — fetch one item by UUID

Pro/Team tools:

• execute_code — arbitrary BSL with optional transaction
• write_object — create/update catalog items and documents
• post_document — Проведение / ОтменаПроведения

Real use cases

Я: «Найди контрагентов с долгом >30 дней и дай отчёт по менеджерам»
Claude: [execute_query SELECT...] Нашёл 47. Вот разбивка по менеджерам...

Я: «Создай Реализацию из этих позиций на основании Заказа покупателя X»  
Claude: [execute_code with BSL] Документ создан. UUID: a1b2c3...

Я: «Сколько в кассе на конец месяца, разбей по валютам»
Claude: [execute_query] KZT: 1,250,000 · USD: 3,400 · EUR: 1,800

Setup (10 minutes)

1. Install MCPService 1C extension into your database

Download MCPService.cfe from GitHub Releases and load via Конфигуратор:

1. Open your 1C database in Конфигуратор
2. Configuration → Extensions → Load configuration extension from file
3. Select MCPService.cfe
4. Update database (F7 or Configuration → Update database configuration)
5. Publish HTTP-сервис: Administration → Publishing on web server → check «HTTP-сервисы»

2. Get free Solo license

curl -X POST https://bitrix24-mcp-license.shahruh.workers.dev/freemium \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","product":"mcp-1c"}'

License key arrives by email instantly.

3. Install npm package

npm install -g @rcs-kz/mcp-1c

4. Add to AI client config

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "1c": {
      "command": "npx",
      "args": ["-y", "@rcs-kz/mcp-1c"],
      "env": {
        "MCP_1C_BASE": "http://your-1c-server:8080/hs/mcp",
        "MCP_1C_USER": "your-1c-user",
        "MCP_1C_PASSWORD": "your-1c-password",
        "RCS_LICENSE_KEY": "v1.eyJ..."
      }
    }
  }
}

Cursor / Cline / Continue: same JSON schema, в их MCP settings.

5. Restart AI client and try:

«Покажи метаданные справочника Контрагенты»

If returns table structure — setup is complete.

Pricing

| Tier | Price | Limits | Best for | |---|---|---|---| | Solo | $0/forever | 10 calls/day, read-only (4 tools) | Personal exploration, learning | | Pro | $20/mo (10,400 ₸) | Unlimited, write enabled, 1 database | Solo developers, internal automation | | Team | $80/mo (41,600 ₸) | 5 databases, custom tools, 4h SLA | Agencies, partners, multi-client |

14-day Pro trial, no credit card. Subscription via Lemon Squeezy (works with Russian/Kazakh cards).

Compatibility

| 1C Configuration | Status | |---|---| | 1С:Бухгалтерия для Казахстана 3.0 | ✅ Production-tested daily | | 1С:Бухгалтерия 3.0 (RU) | ✅ Production | | 1С:Управление нашей фирмой (УНФ) | ✅ Production | | 1С:Управление торговлей (УТ) | ✅ Should work (untested) | | 1С:ERP | ✅ Should work | | Custom 1С configurations | ✅ Works as long as you can install the .cfe extension |

| 1C Hosting | Status | |---|---| | File-based (1cv8.1CD) | ✅ via ibsrv | | Server | ✅ via Apache/IIS publication | | 1С:Fresh / cloud-hosted | ⚠️ Depends on whether MCPService can be loaded |

Why this and not alternatives

There are a few open-source 1C-MCP attempts on GitHub (most are abandoned hobby projects). Ours is the production-ready commercial choice because:

1. Production-tested daily by RCS, a Bitrix24 partner agency that uses it on real client work
2. Comes with MCPService extension (free .cfe) — most alternatives leave the BSL side as exercise for the reader
3. License-gated tier model — clear separation of free/paid features
4. 24-hour support via [email protected]
5. Сам автор русскоязычный — поддержка, документация, ошибки на родном языке

Combine with @rcs-kz/bitrix24-mcp

If you also have Bitrix24 CRM, install both packages and Claude can orchestrate workflows across 1С + Б24:

• "Sync debtors from 1C to Bitrix24 as deals"
• "When a Bitrix24 deal is won, create an invoice in 1C"
• "Reconcile bank statements between systems"

See bitrix24-mcp on npm.

Security

• Server runs locally as a node→python subprocess
• 1C credentials live in env vars on your machine — we never see them
• License key is signed JWT (Ed25519 P-256), verified online via Cloudflare Worker (no PII transmitted)
• All write operations require explicit user prompt — Claude won't write without your "yes"

Get help

• Email: [email protected] — replied within 24h
• Issues: https://github.com/rcs-kz/mcp-1c/issues
• Docs: https://github.com/rcs-kz/mcp-1c/wiki

About

Maintained by RCS, a Bitrix24 partner agency in Almaty, Kazakhstan. We run 30+ active client projects on 1C+Bitrix24 with this exact toolchain.

License

Commercial software with free Solo tier. See LICENSE.md.