@rcs-kz/mcp-1c

@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 Конфигуратор:

• Open your 1C database in Конфигуратор
• Configuration → Extensions → Load configuration extension from file
• Select MCPService.cfe
• Update database (F7 or Configuration → Update database configuration)
• 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":"[e-mail]","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:

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

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: [e-mail] — 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.