Chestnyi Znak MCP Server

@woyax/mcp-chestnyi-znak

Chestnyi Znak（Честный Знак）— ロシアの国家製品ラベリングシステム（True API）向けの MCP サーバーです。

AI アシスタント（Claude、Cursor など）が、自然言語を使ってマーキングコード、書類、倉庫残高、参加者データを直接照会できます。

Chestnyi Znak True API に対応した初の MCP サーバーです。

---

ツール（全10種類）

書類とマーキングコード

ツール	説明
chz_doc_list	製品グループの書類一覧を取得します
chz_doc_info	ID を指定して、特定の書類の詳細を取得します
chz_doc_cis_list	書類に含まれるマーキングコードの一覧を取得します
chz_cis_search	条件を指定してマーキングコードを検索します
chz_cis_info	CIS コードのリストに関する公開情報を取得します
chz_product_info	GTIN で製品カードを取得します

残高と参照情報

ツール	説明
chz_balance_all	すべての製品グループのマーキングコード残高
chz_warehouse_balance	製品グループの仮想倉庫残高
chz_participant_check	INN で会社の登録状況を確認します
chz_receipt_list	製品グループの出庫証明書一覧を取得します

新しいツールの開発を進めています。

---

トークンの取得

このサーバーには、Chestnyi Znak の個人アカウントから取得した JWT トークンが必要です。トークンの取得には GOST 暗号技術（КриптоПро + УКЭП）が関わるため、このパッケージの対象外です。

トークンの取得は自動化できます。たとえば、ローカルの КриптоПро スクリプト、署名マイクロサービス、ハードウェアトークンを使った USB-over-IP、クラウド HSM を利用できます。また、Chestnyi Znak の Web インターフェースから手動で取得することもできます。適切な方法は、インフラストラクチャ、OS、証明書の種類、セキュリティ要件によって異なります。選択肢や制約はケースごとに大きく異なるため、これは個別の連携タスクとして扱っています。この種のセットアップにも対応していますので、お気軽にお問い合わせください。

トークンの有効期間： 約8～12時間。有効期限が切れたらファイルを更新してください。サーバーは再起動なしで自動的に新しいトークンを読み込みます。

---

インストールと設定

Claude Desktop

claude_desktop_config.json に追加します。

サンドボックス：

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

本番環境：

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

CHZ_ENV が設定されていない場合、デフォルト値は "prod" です。

重要： トークンファイルと CHZ_ENV の値は一致している必要があります。サンドボックスのトークンは本番環境のエンドポイントでは使えず、その逆も同様です。

---

環境変数

変数	必須	デフォルト	説明
CHZ_TOKEN_FILE	はい	—	JWT トークンを含むファイルの絶対パス
CHZ_ENV	いいえ	prod	環境：sandbox または prod

---

作者とサポート

Oleg Alekseev が開発しました — ERP/AI 連携アーキテクトです。

• 📧 [email protected] · [email protected]
• 💬 Telegram： @ale_oleg · チャンネル：@woyax_ai
• 💬 MAX：max.ru/id503610654564_biz

ERP、CRM、または Chestnyi Znak と AI エージェントを連携する際にサポートが必要ですか？カスタム MCP サーバー、n8n ワークフロー、AI 自動化については、お問い合わせください。

---

ライセンス

MIT + Commons Clause © Oleg Alekseev

個人および企業で自由に利用できます。ホスト型サービスとして販売するには、作者の許可が必要です。詳しくは LICENSE をご覧ください。