PayPing

payping-mcp：AI エージェント向け PayPing MCP サーバー

AI エージェントが PayPing（پی‌پینگ）の加盟店アカウントを操作できるようにします。
イランの決済ゲートウェイおよび請求書発行サービスであるPayPing向けの非公式 MCP サーバーです。
残高、売上、取引、顧客、商品、クーポン、請求書を読み取り、確認後に請求書、決済リンク、クーポンを作成できます。Claude、Cursor、Copilotから利用できます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · セキュリティ · トラブルシューティング · FAQ · فارسی

AI エージェント向け

• 概要： PayPing（payping.ir、イラン）の加盟店アカウント向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。金額の単位はトマン、日時は UTC です。
• インストール： uvx payping-mcp（uv、Python 3.10 以降が必要です。または pip install payping-mcp）。トランスポート：stdio。
• Claude Code： claude mcp add payping -e PAYPING_TOKEN=your-token -- uvx payping-mcp
• 認証： PAYPING_TOKEN（必須。利用できる機能は PayPing API トークンのスコープによって決まります）；PAYPING_MCP_PROXY（任意の HTTP プロキシ）。
• アクセス： ユーザー自身のアカウントを操作するため、読み取り専用ではありません。読み取りツールが 15 個、作成・送信ツールが 6 個あります。作成または送信ツールを実行する前に、必ずユーザーに確認してください。出金、返金、取り消し、削除を行うツールはありません。
• ツール： payping_* という接頭辞が付いた 21 個のツールがあります。まず payping_get_profile、payping_get_balance、payping_get_sales_summary、payping_list_transactions、payping_list_invoices を使ってください。残高と売上概要は、PayPing が API トークンを拒否する場合があるダッシュボードのエンドポイントを使用します。それ以外のツールは引き続き使えます。
• 一般的な手順： payping_create_customer -> payping_create_invoice -> payping_send_invoice、または payping_create_product -> payping_create_payment_link。
• 単位： トマン（リアルではありません）。日時は UTC です。
• 使用するケース： ユーザーが自身の PayPing アカウントで、請求書、支払いリンク、クーポン、顧客、売上データを確認または作成したい場合に使用します。
• 使用しないケース： 生の支払い処理、支払いの確認や返金、または出金を行うタスクには使用しないでください。これらを行うツールはありません。
• 出力： コンパクトな JSON です。リストの返却件数は最大 50 件で、total が含まれます（offset でページを指定）。ツール間ではコード（顧客、商品、請求書）を渡してください。
• 機械可読データ： server.json；イランの MCP サーバーのカタログ：iran-mcp（TOOLS.md、servers.json、llms.txt）。

理由

PayPing の管理画面は、人が画面をクリックして操作することを前提に作られています。「今月の売上はいくらか、失敗した支払いはどれか、まだ未払いの人は誰か」に答えるには、いくつものページを開く必要があります。また、請求書を作成するには、顧客や商品項目を入力してから、手動で送信する必要があります。payping-mcp を使えば、エージェントはいくつかの呼び出しでこれを実行できます。数値を読み取り、請求書の下書きを作成して詳細を表示し、ユーザーの了承を得てから作成・送信します。

あなた： Ali Rezaei に、1 時間あたり 1,500,000 トマンのコンサルティングを 2 時間分請求し、請求書を送信してください。

エージェント： payping_list_customers を呼び出します -> 請求書の詳細を表示し、あなたの確認を待ちます -> payping_create_invoice -> payping_send_invoice

公開支払いページのリンク（https://ppng.ir/v/<invoice code>）を提示し、PayPing が SMS／メールで請求書を送信したことを知らせます。

すべての処理は、あなた自身のトークンを使ってローカルマシン上で実行されます。間にホスト型の中継サービスはありません。

できること

• お金： ウォレット残高、期間ごとの売上合計、取引、個別の支払いの実際のステータス、銀行口座への精算
• ショップデータ： 顧客、商品、クーポン、請求書の一覧表示と検索
• 支払いを受け取る： 顧客と、支払いページへのリンク付き請求書を作成するか、商品用の再利用可能な支払いリンクを作成し、PayPing から SMS／メールで請求書を送信してもらえます
• 安全性を重視した設計： お使いのマシン上で動作し、PayPing のみと通信します。何かを作成する前に確認を求め、引き出し、返金、支払いの取り消し、削除はできません

プロンプトの例：

• 「PayPing のプロフィールを表示して。」
• 「PayPing の残高はいくらで、今月の売上はいくら？」
• 「今週受け取った支払いを一覧表示して、失敗したものを教えて。」
• 「支払い期限を過ぎた請求書はどれ？」
• 「月額プランという商品を 490,000 トマンで作成して、支払いリンクを発行して。」
• 「Ali Rezaei 宛てに、1 時間 1,500,000 トマンのコンサルティングを 2 時間分請求する請求書を作成して。作成する前に内容を見せて。」
• فاکتورهای پرداخت‌نشده این ماه را نشان بده.
• موجودی پی‌پینگ من چقدر است و این ماه چقدر فروش داشتم؟
• یک لینک پرداخت برای محصول «اشتراک ماهانه» بساز.
• آخرین تسویه‌های من به حساب بانکی را نشان بده.

クイックスタート

必要なもの：

• 完全なプロフィールを持つ PayPing の加盟店アカウント（PayPing はプロフィールが完全な場合にのみトークンを承認します）
• uv
• MCP クライアント：Claude Code、Claude Desktop、Cursor、VS Code など

次に、以下の手順を実行します。

1. PayPing トークンを作成し、PayPing の承認を待ちます。
2. サーバーを MCP クライアントに追加します。
3. 動作を確認します。

1. PayPing トークンを作成する

1. app.payping.ir にサインインします。

2. اتصالات（接続）→ توسعه دهندگان（開発者）を開きます。ページのタイトルは توکن ها（トークン）です。

3. توکن جدید（新しいトークン）をクリックし、フォームに入力します。

   フィールド	入力する内容
   توکن تست (test token)	実際のアカウントで使用する場合は、オフのままにします。
   نام توکن (token name)	任意の名前（例：payping-mcp on my laptop）
   آی‌پی‌های مجاز (allowed IPs)	任意です。入力する場合は、お使いのコンピューターが PayPing に接続するときに使用するパブリック IP を指定します。他の IP からの呼び出しは、エラーコード 166 で失敗します。
   تاریخ انقضا (expiry date)	トークンの有効期限です。短いほうが安全です。
   دسترسی‌ها (scopes)	下の表を参照してください。
   توضیحات (description)	例：AI エージェント向け MCP サーバー
   رمز پیامکی (SMS code)	ارسال رمز（コードを送信）をクリックし、PayPing から電話に届いたコードを入力します。

4. توکن جدیدをクリックして送信します。トークンは今すぐコピーしてください。PayPing がトークンを表示するのは一度だけです。

5. 承認を待ちます。PayPing のスタッフが新しいトークンをすべて審査します。承認後、さらに約 10 分待ってください。それまではトークンが HTTP 401 を返します。

スコープ。 フォームでは گزارش پرداخت‌ها と ساخت پرداخت があらかじめ選択されています。ساخت پرداخت は削除してください。このサーバーでは使用しません。その後、必要なスコープを追加します。

読み取り専用のエージェントにしたい場合は、読み取りスコープのみを選択してください。作成ツールは HTTP 403 を返し、アカウント内のデータは変更されません。

2. MCP クライアントにサーバーを追加する

your-token と書かれた箇所にトークンを入力してください。

claude mcp add payping -e PAYPING_TOKEN=your-token -- uvx payping-mcp

{
  "mcpServers": {
    "payping": {
      "command": "uvx",
      "args": ["payping-mcp"],
      "env": { "PAYPING_TOKEN": "your-token" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "payping-token", "description": "PayPing API token", "password": true }
  ],
  "servers": {
    "payping": {
      "type": "stdio",
      "command": "uvx",
      "args": ["payping-mcp"],
      "env": { "PAYPING_TOKEN": "${input:payping-token}" }
    }
  }
}

codex mcp add payping --env PAYPING_TOKEN=your-token -- uvx payping-mcp

[mcp_servers.payping]
command = "uvx"
args = ["payping-mcp"]

[mcp_servers.payping.env]
PAYPING_TOKEN = "your-token"

{
  "mcpServers": {
    "payping": {
      "command": "uvx",
      "args": ["payping-mcp"],
      "env": { "PAYPING_TOKEN": "your-token" }
    }
  }
}

uvx --from git+https://github.com/sepehr071/payping-mcp payping-mcp

3. 動作を確認する

エージェントに 「PayPing のプロフィールを表示して」 と尋ねてください。PayPing のユーザー名が表示されるはずです。エラーが表示された場合は、 トラブルシューティングで内容を確認してください。

次に、できることにあるプロンプトの例を試してください。

ツール

金額はすべてトマン、日付はすべて UTC です。リストは呼び出しごとに最大 50 件を返し、total を含みます。

読み取り専用（15）：

作成・送信（6；エージェントは最初にユーザーの確認を得る必要があります）：

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  payping-mcp  (runs on your machine, holds PAYPING_TOKEN)
      │
      │  HTTPS (REST, Bearer token, optional proxy)
      ├──────▶  api.payping.ir    (reports, customers, products, coupons, invoices)
      └──────▶  oauth.payping.ir  (profile)

payping-mcp はローカルで動作し、お客様自身のトークンを使って PayPing の API を呼び出します。間にホスト型サーバーはありません。システムのプロキシ設定は無視し、HTTP 429、502、503 で GET が失敗した場合は、1 秒後に 1 回だけ再試行します（作成または送信の呼び出しは再試行しません）。キャッシュは保持せず、各結果を空のフィールドを省いたコンパクトな JSON ブロック 1 つとして返します。

プライバシーとセキュリティ

• ローカルのみです。 サーバーはお使いのマシン上で動作し、api.payping.ir と oauth.payping.ir とのみ通信します。中継サーバーはなく、テレメトリーもありません。
• トークンが漏れることはありません。 トークンは Authorization ヘッダーで PayPing にのみ送信され、ツールの出力、エラー、ログには表示されません。
• トークンはパスワードと同様に扱ってください。 トークンを持つ人は誰でも、そのスコープ内でお客様のアカウントを利用できます。トークンをコミットしないでください。VS Code の inputs またはクライアントのユーザー設定を使用してください。必要なスコープだけを付与し、有効期限を設定してください。
• トークンを紛失または漏えいした場合は？ パネルでトークンを開き、حذف（削除）または تعویض توکن（トークンの交換。新しい値が発行されます）を選択してください。その後、MCP 設定を更新してください。
• 作成前に確認します。 作成ツールと送信ツールには destructiveHint が注釈として付いているため、MCP クライアントは実行前に確認を求めます。また、ツールの説明では、エージェントに詳細をお客様に確認するよう指示しています。
• 資金の移動はありません。 出金、返金、支払いの取り消し、削除を実行できるツールはありません。
• プロンプトインジェクションに配慮しています。 顧客名、説明、メモは他の人から提供されます。サーバーは、これらを指示ではなくデータとして扱うようエージェントに伝えます。

知っておくと便利なこと

• 単位はリアルではなくトマンです。 PayPing はすべてのサービスでトマンを使用しており、すべてのツールも同様です。日付と時刻は UTC です。
• 読み取り専用ではありません。 6 つのツールはデータを作成するか、実際の顧客にメッセージを送信します。参照のみを行うエージェントを使用したい場合は、読み取り専用のスコープを使ってください。
• 制限事項。 リストは 1 回の呼び出しにつき最大 50 件を返します（limit 1-50）。offset でページを指定してください。redirect_url は https である必要があります。
• 残高と売上概要の確実性はやや低めです。 payping_get_balance と payping_get_sales_summary は、公開 API ドキュメントではなく PayPing ダッシュボードのエンドポイントを使用します。PayPing が API トークンを拒否した場合、ツールのエラーにその旨が表示されますが、それ以外のすべてのツールは引き続き動作します。
• 生の支払いには対応していません。 生の POST /v3/pay による支払いは、意図的に対象外としています。独自のコールバックサーバーと 10 分以内の検証呼び出しが必要で、そうしないと PayPing が支払者に返金します。請求書と支払いリンクでは、代わりに PayPing 独自の支払いページを使用します。
• 対応していない操作。 出金、返金、支払いの取り消し、生の支払いの検証、更新、削除には対応していません。
• スコープの変更にはトークンの交換が必要です。 トークンのウェブサイト、リターン URL、またはスコープを編集した後、PayPing が変更を適用するのは تعویض توکن（トークンの交換）を行った後です。交換すると新しいトークン値が発行されるため、MCP 設定に反映してください。
• プロキシ。 PayPing への接続にプロキシが必要なネットワークでは、PAYPING_MCP_PROXY を設定してください。システムのプロキシ変数は意図的に無視されます。

トラブルシューティング

npx @modelcontextprotocol/inspector -e PAYPING_TOKEN=your-token uvx payping-mcp

PayPing のトレース ID を含むエラーが発生した場合は、その ID を PayPing サポートに伝えてください。

よくある質問

ペルシア語：PayPing MCP サーバー

claude mcp add payping -e PAYPING_TOKEN=your-token -- uvx payping-mcp

開発

git clone https://github.com/sepehr071/payping-mcp && cd payping-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run pytest -q                                   # offline, against a mocked PayPing API
PAYPING_TOKEN=your-token uv run pytest -m live     # read-only calls to the real API

ツールは src/payping_mcp/reports.py（アカウント、資金）と shop.py（顧客、商品、クーポン、請求書）にあります。 http.py が唯一の HTTP コードです。各ツールは型付きの非同期関数で、エージェントがいつ使用すべきかを説明する docstring を備えています。Issue や PR を歓迎します。

リリース：pyproject.toml と server.json のバージョンを更新し、v* タグを push してください。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• iran-mcp：イランのサービス向け MCP サーバーのカタログ
• bale-mcp：Bale ボットを介してメッセージを送信するツール。同じ系列のもう一つのアカウントツールです
• iran-tax-mcp：イランの税務データ向け
• tgju-mcp：TGJU のドル、金、コイン、商品価格向け
• iran-crypto-mcp：イランの取引所の暗号資産価格向け

免責事項

非公式であり、PayPing とは提携しておらず、PayPing の承認も受けていません。あなた自身のトークンを使って PayPing の API を利用します。PayPing の利用規約に従ってください。このツールはあなた自身のアカウントに対して動作します。エージェントが作成または送信しようとしている内容を確認してください。

クリック数の削減に役立った場合は、スターを付けると他の人にも見つけてもらいやすくなります。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedInでつながるか、GitHub の @sepehr071をフォローして、イランのウェブサイト向けの MCP サーバーをご覧ください。すべてiran-mcpに掲載されています。このリポジトリが時間の節約に役立った場合は、スターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT