1C AI Assistant MCP proxy

1c-ai-mcp

An MCP server that forwards questions, code review and code explanation requests to the 1C AI Assistant cloud service

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Sends source code and questions to the external code.1c.ai cloud service
  • The access token is passed in the agent config as a command-line argument
All reasons and checks
Russian stack

timkonzt/1c-ai-mcp

Install

Manual install

{
  "mcpServers": {
    "1c-ai-mcp": {
      "command": "node",
      "args": ["/путь/к/1c-ai-mcp.js", "--mcp", "--token=<ваш-токен>"],
      "env": { "AI_PROJECT_ROOT": "/путь/к/проекту" }
    }
  }
}

The .mcp.json snippet from the README.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Sends source code and questions to the external code.1c.ai cloud service
  • The access token is passed in the agent config as a command-line argument

This is third-party code. Review the repository files before installing.

What it does

The server acts as a proxy to the code.1c.ai cloud service, known as the 1C AI Assistant (1С:Напарник), and gives an agent five tools: ask a 1C development question, review code for errors and performance issues, fix found errors, explain what a piece of code does, and fetch the continuation of an answer if a call did not finish within 30 seconds. The proxy runs as a regular stdio MCP server via node with the --mcp flag and a code.1c.ai access token, and the files the model can see can be limited to a project root with AI_PROJECT_ROOT.

Who it is for. For 1C developers with code.1c.ai access who want to call the 1C AI Assistant from any MCP-compatible agent, not only its own client.

Good fit when

  • You want to ask a 1C development question directly from Claude Code, opencode or another MCP client
  • You need to review BSL code for errors and performance issues before a review
  • You need an explanation of unfamiliar or legacy BSL code

Not a fit when

  • You do not have a code.1c.ai access token
  • You need to work with a live 1C database: the tools do not read or change the infobase, only code and questions

Example request

Review this module for errors and explain what the РассчитатьСкидку function does

MCP

Transport
stdio
Authentication
API key

Environment variables

AI_TOKEN required, secret
The code.1c.ai access token, an alternative to the --token flag.
AI_PROJECT_ROOT
The project root, controlling which files the model can see.
AI_FULL_LOG
Enables tracing of requests and responses.
AI_SESSION_FILE
Path to the session cache file.
AI_TRACE_LOG
Path to the trace log file when AI_FULL_LOG is enabled.

Limitations

You need your own code.1c.ai token, either paid or trial, which the project does not provide. Requires Node.js 22+. A tool call is capped at 30 seconds, so longer answers need a separate GetResult call. A single-author project with no stated support policy.

How to disable. Remove the 1c-ai-mcp entry from .mcp.json or your agent's MCP configuration.

FAQ

Where do I get a token?

The token comes from the code.1c.ai (1C AI Assistant) service; 1c-ai-mcp only proxies requests to it and does not issue tokens.

What if a call does not finish within 30 seconds?

Call the GetResult tool, which returns the continuation of the same answer.

Discussion

No questions or reviews yet.

MCP server for 1C:Naparnik

Spring Boot MCP Server для 1С:Напарник

Russian stack

Spring Boot and Kotlin MCP server that connects an agent to the 1C:Naparnik API for 1C questions and code checks

MCP serverExtended access47Repository stars
Russian stack

An MCP server that exposes the cloud 1C:Napparnik (1C.ai) assistant and a local BSL Language Server to agents in Cursor and other IDEs

MCP serverExtended access22Repository stars
Russian stack

A FastMCP Docker server with 12 tools for BSL code analysis and documentation search through the 1С:Naparnik API (code.1c.ai)

MCP serverExtended access9Repository stars
Russian stack

A Go binary with 5 MCP tools for the 1С:Naparnik neural network that reads 1C code straight from a file path instead of through the model's context

MCP serverExtended access9Repository stars
Russian stack

A 1C extension built on vladimir-kharin/1c_mcp that adds execution of arbitrary built-in-language code right in the infobase context

MCP serverBroad access5Repository stars
Russian stack

A stdio proxy between Claude Code and the client_mcp server inside 1C that reconnects itself after 1C restarts without a manual /mcp

MCP serverExtended access

README in short

The README lists the proxy's five tools, requirements (Node.js 22+, a code.1c.ai token), two install options: download a release zip or build from source. It gives CLI parameters and environment variables with a table of requirements and defaults, plus ready config snippets for opencode and Claude Code. MIT license.

README badge

Report a problem