English Français العربية

Chestnyi Znak MCP Server

Registre officiel Productivité

MCP server for Chestnyi Znak — Russian product marking system. 10 tools: codes, documents, stocks.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @woyax/mcp-chestnyi-znak
Claude Code 
claude mcp add chestnyi-znak-mcp-server -e 'CHZ_TOKEN=<your chz_token>' -- npx -y @woyax/mcp-chestnyi-znak@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "chestnyi-znak-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@woyax/mcp-chestnyi-znak@0.1.1"
            ],
            "env": {
                "CHZ_TOKEN": "<your chz_token>"
            }
        }
    }
}

Variables d'environnement

  • CHZ_TOKEN obligatoire secret Chestnyi Znak API token. Obtain in your personal cabinet at markirovka.crpt.ru. IMPORTANT: token expires every 8–10 hours and must be refreshed.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @woyax/mcp-chestnyi-znak
  2. Tools (10 total)
  3. Getting a Token
  4. Installation & Configuration
  5. Environment Variables
  6. Author & Support
  7. License

@woyax/mcp-chestnyi-znak

MCP server for Chestnyi Znak (Честный Знак) — Russia's national product labelling system (True API).

Enables AI assistants (Claude, Cursor, etc.) to query marking codes, documents, warehouse balances, and participant data directly via natural language.

First MCP server for Chestnyi Znak True API.

Tools (10 total)

Documents & Marking Codes
ToolDescription
chz_doc_listList documents for a product group
chz_doc_infoGet details of a specific document by ID
chz_doc_cis_listList marking codes included in a document
chz_cis_searchSearch marking codes by filter criteria
chz_cis_infoGet public info for a list of CIS codes
chz_product_infoGet product card by GTIN
Balance & Reference
ToolDescription
chz_balance_allBalance of marking codes across all product groups
chz_warehouse_balanceVirtual warehouse balance for a product group
chz_participant_checkCheck company registration status by INN
chz_receipt_listList withdrawal receipts for a product group

Development of new tools is ongoing.

Getting a Token

This server requires a JWT token from your Chestnyi Znak personal account. Token acquisition involves GOST cryptography (КриптоПро + УКЭП) and is outside the scope of this package.

Token retrieval can be automated — using a local КриптоПро script, a signing microservice, USB-over-IP with a hardware token, or a cloud HSM. It can also be done manually via the Chestnyi Znak web interface. The right approach depends on your infrastructure, OS, certificate type, and security requirements. Because the options and constraints vary significantly from case to case, this is treated as a separate integration task. We handle this kind of setup as well — feel free to reach out.

Token lifetime: ~8–12 hours. Update the file when it expires — the server picks it up automatically without restart.

Installation & Configuration

Claude Desktop

Add to your claude_desktop_config.json:

Sandbox:

{
  "mcpServers": {
    "chestnyi-znak": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-chestnyi-znak"],
      "env": {
        "CHZ_TOKEN_FILE": "/path/to/your/token",
        "CHZ_ENV": "sandbox"
      }
    }
  }
}

Production:

{
  "mcpServers": {
    "chestnyi-znak": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-chestnyi-znak"],
      "env": {
        "CHZ_TOKEN_FILE": "/path/to/your/token"
      }
    }
  }
}

CHZ_ENV defaults to "prod" if not set.

Important: the token file and the CHZ_ENV value must match — a sandbox token won't work on the production endpoint and vice versa.

Environment Variables

VariableRequiredDefaultDescription
CHZ_TOKEN_FILEYes—Absolute path to file containing the JWT token
CHZ_ENVNoprodContour: sandbox or prod

Author & Support

Built by Oleg Alekseev — ERP/AI integration architect.

Need help integrating AI agents with your ERP, CRM, or Chestnyi Znak? Custom MCP servers, n8n workflows, AI automation — contact me.

License

MIT + Commons Clause © Oleg Alekseev

Free to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See LICENSE for details.

Questions fréquentes

Qu'est-ce que Chestnyi Znak MCP Server ?

MCP server for Chestnyi Znak — Russian product marking system. 10 tools: codes, documents, stocks.

Comment installer Chestnyi Znak MCP Server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add chestnyi-znak-mcp-server -e 'CHZ_TOKEN=<your chz_token>' -- npx -y @woyax/mcp-chestnyi-znak@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Chestnyi Znak MCP Server ?

Oui. Il attend CHZ_TOKEN, à renseigner dans sa configuration.

Chestnyi Znak MCP Server est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Chestnyi Znak MCP Server ?

Il est publié par woyaxnini. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.