Zen

Name: Zen
Author: krystiangw

作者：krystiangwバージョン 0.1.1i★ –iパソコンで動く

レジストリ名io.github.krystiangw/zen

インストール

概要

作者による説明（英語の原文）

Unofficial MCP server for the ZEN.com Payment Gateway: payment links, transactions, refunds.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: ネットショップ・決済
入力が必要なもの：ZEN_API_KEY, ZEN_PAYWALL_SECRET, ZEN_IPN_SECRET

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： ZEN_API_KEY, ZEN_PAYWALL_SECRET, ZEN_IPN_SECRET, ZEN_ENV

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "zen": {
      "command": "npx",
      "args": [
        "-y",
        "@krystiangw/zen-mcp"
      ],
      "env": {
        "ZEN_API_KEY": "your-value",
        "ZEN_PAYWALL_SECRET": "your-value",
        "ZEN_IPN_SECRET": "your-value",
        "ZEN_ENV": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add zen --env ZEN_API_KEY=your-value --env ZEN_PAYWALL_SECRET=your-value --env ZEN_IPN_SECRET=your-value --env ZEN_ENV=your-value -- npx -y @krystiangw/zen-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "zen": {
      "command": "npx",
      "args": [
        "-y",
        "@krystiangw/zen-mcp"
      ],
      "env": {
        "ZEN_API_KEY": "your-value",
        "ZEN_PAYWALL_SECRET": "your-value",
        "ZEN_IPN_SECRET": "your-value",
        "ZEN_ENV": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "zen": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@krystiangw/zen-mcp"
      ],
      "env": {
        "ZEN_API_KEY": "your-value",
        "ZEN_PAYWALL_SECRET": "your-value",
        "ZEN_IPN_SECRET": "your-value",
        "ZEN_ENV": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

ZEN_API_KEY 秘密必須 env
ZEN Terminal API Key (Authorization header)
ZEN_PAYWALL_SECRET 秘密 env
ZEN paywall secret for request signing (required for write ops)
ZEN_IPN_SECRET 秘密 env
ZEN IPN secret for webhook verification
ZEN_ENV env
sandbox (default) or production

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント krystiangw で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

ネットショップ・決済のほかのサーバーとの比較i

このカテゴリのほかの1753件のうち0%よりスターが多い
このカテゴリのほかの1753件のうち28%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの1753件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Zenは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：ZEN_API_KEY, ZEN_PAYWALL_SECRET, ZEN_IPN_SECRET

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.1.1）がレジストリに届いたのは3 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spree Commerce: open-source B2B and marketplace ecommerce

作者：spree

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

クラウドで動く★ 15,812BSD-3-Clause7 日前更新

インストール

Stripe MCP

作者：stripe

MCP server integrating with Stripe - tools for customers, products, payments, and more.

クラウドで動く★ 2,043MIT12 か月前更新

インストール

MCP Cn Commerce

作者：TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

パソコンで動く★ 96MIT28 日前更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

ZEN MCP

An MCP server that lets AI assistants work with the ZEN.com Payment Gateway: hosted payment links, transaction lookup, refunds, payouts, and reporting.

Project page

Unofficial. This project is not affiliated with, endorsed by, or maintained by ZEN.com.

What it does

Read-only tools:

List terminal payment methods and documented currencies.
Look up transactions, payment links, and payouts.
List payment links and request reconciliation reports.
Verify IPN webhook signatures locally.

Write tools:

Create hosted payment links and QR codes without handling card data.
Capture or cancel transactions and issue full or partial refunds.
Create payouts and customer records.

Disclaimer

This integration was built from public ZEN documentation without access to a live merchant account. Endpoint versions, request fields, response fields, signing details, and webhook behavior must be checked against ZEN's current OpenAPI or Postman collection before production use. Mock mode is included for evaluation without an account.

Install

Add the published package to Claude Code:

claude mcp add zen --env ZEN_API_KEY=your_terminal_api_key -- npx -y @krystiangw/zen-mcp

For Claude Desktop, add this entry to its MCP configuration:

"mcpServers": { "zen": { "command": "npx", "args": ["-y", "@krystiangw/zen-mcp"], "env": { "ZEN_API_KEY": "your_terminal_api_key", "ZEN_PAYWALL_SECRET": "your_paywall_secret", "ZEN_IPN_SECRET": "your_ipn_secret", "ZEN_ENV": "sandbox" } } } }

Configuration

Variable	Required	Description
`ZEN_API_KEY`	Outside mock mode	Terminal API Key sent in `Authorization` without a Bearer prefix
`ZEN_PAYWALL_SECRET`	Write operations	Checkout/paywall secret used to sign request bodies
`ZEN_IPN_SECRET`	Webhook verification	IPN secret used only by `verify_webhook_signature`
`ZEN_ENV`	No	`sandbox` (default) or `production`
`ZEN_BASE_URL`	No	API base URL override; takes priority over `ZEN_ENV`
`ZEN_MOCK`	No	`1` or `true` enables deterministic offline responses
`ZEN_HASH_ALG`	No	`sha224`, `sha256` (default), `sha384`, or `sha512`

In the ZEN merchant panel, go to my.zen.com → Shop settings → Terminal to find the Terminal API Key. Use sandbox first; the default API host is api.zen-test.com, although sandbox availability and onboarding requirements should be confirmed with ZEN.

No merchant account yet? You can open a ZEN business account. That is a referral link: it credits the author of this project if you sign up through it, and costs you nothing. Every other link in this README is a plain one.

Tools

Name	Type	Description
`list_payment_methods`	Read	List payment methods for the terminal
`get_transaction`	Read	Get a transaction by ZEN or merchant ID
`list_payment_links`	Read	List hosted payment links
`get_payment_link`	Read	Get one hosted payment link
`get_payout`	Read	Get a payout by ZEN ID
`download_report`	Read	Request a report download
`list_supported_currencies`	Read	List documented supported currencies
`verify_webhook_signature`	Read	Verify a ZEN IPN signature locally
`create_payment_link`	Write	Create a hosted checkout link and QR code
`refund_transaction`	Write, destructive	Issue a full or partial refund
`capture_transaction`	Write, destructive	Capture an authorized transaction
`cancel_transaction`	Write, destructive	Cancel a transaction
`create_payout`	Write, destructive	Send an outbound payout
`create_customer`	Write	Create a customer record

Security

Tools are read-only by default; operations that move or reverse money are marked destructive for MCP clients.
Secrets are read only from environment variables and are never tool arguments.
Payment acceptance uses ZEN-hosted links, so this server does not collect or transmit card numbers.
The signing algorithm follows public ZEN documentation, but nested-object and array flattening are not fully specified publicly. Verify it against the live API.
Verify every IPN webhook signature with ZEN_IPN_SECRET before trusting its contents.
Use least-privilege terminal credentials and keep human confirmation enabled for write tools.

Demo without an account

Run the server with deterministic canned API responses:

ZEN_MOCK=1 ZEN_IPN_SECRET=demo npx -y @krystiangw/zen-mcp

verify_webhook_signature does real cryptography instead of calling the API, so it needs a secret even in mock mode. Any value works for a demo.

From a development checkout:

npm install

npm run build ZEN_MOCK=1 ZEN_IPN_SECRET=demo npm run inspect

Development

Requires Node.js 18 or newer.

npm install

npm run typecheck npm run build npm test ZEN_MOCK=1 ZEN_IPN_SECRET=demo npm run inspect

Roadmap

Raw card charges only after a deliberate PCI/security design; they are excluded from the MVP.
Recurring and one-click payments after the tokenization flow is verified.
Consumer ZEN features such as cashback and personal cards if ZEN publishes a supported API.
Remote Streamable HTTP transport and OAuth after the stdio MVP.

License

MIT

Zen

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

ネットショップ・決済のほかのサーバーとの比較i

よくある質問

代わりの候補

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

作者のREADME

ZEN MCP

What it does

Disclaimer

Install

Configuration

Tools

Security

Demo without an account

Development

Roadmap

License