mcpField
M
mcp-epayco

mcp-epayco

ローカル
github.com/codespar金融データ2754 週間前に更新
リポジトリ

mcp-epayco について

mcp-epayco は、コロンビアの決済ゲートウェイ ePayco 向けの MCP サーバーです。カードのトークン化と決済、PSE による銀行引き落とし、現金払いネットワークによる支払いに対応しています。ツールは公式 epayco-node SDK に準拠しており、テストモードはペイロードのフラグ EPAYCO_TEST で指定します。

主な機能

  1. 01カードのトークン化と顧客作成
  2. 02カード決済と取引詳細の取得
  3. 03PSE 銀行引き落としと状態照会
  4. 04現金払い用バウチャーの作成
  5. 05ペイロードのテストモードフラグ

活用シーン

  1. 01AI エージェントからコロンビアのオンライン加盟店向けにカード決済を実行
  2. 02PSE の銀行リダイレクト URL と取引状態の取得
  3. 03現金払いネットワーク向けの支払いバウチャーの生成

MCP 対応

このサーバーは、ePayco のカード、PSE、現金払いの各エンドポイントをラップした 8 つのツールを MCP 経由で公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-epayco": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-epayco"
      ],
      "env": {
        "EPAYCO_PUBLIC_KEY": "<EPAYCO_PUBLIC_KEY>",
        "EPAYCO_PRIVATE_KEY": "<EPAYCO_PRIVATE_KEY>",
        "EPAYCO_TEST": "<EPAYCO_TEST>"
      }
    }
  }
}
起動コマンドnpx -y @codespar/mcp-epayco
設定が必要な環境変数
EPAYCO_PUBLIC_KEYシークレットePayco public key
EPAYCO_PRIVATE_KEYシークレットePayco private key
EPAYCO_TEST"true" flags payloads as test mode. Defaults to "true" — set "false" for production.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-epayco0.1.0

ツール

8

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
cvcstringはいカードの CVC
exp_yearstringはい有効期限の年（例：2027）
exp_monthstringはい有効期限の月（例：09）
card_numberstringはいカード PAN

詳細

@codespar/mcp-epayco

ePayco 用の MCP サーバー — コロンビアの決済ゲートウェイ（Davivienda 傘下）：カードのトークン化と決済、PSE 銀行口座引き落とし、現金決済ネットワーク（Efecty、Gana、Red Servi、Punto Red、Su Red）。

npm License: MIT

ツールセットは、公式 ePayco SDK（epayco-node）に準拠しています。カード／トークン API は api.secure.payco.co、PSE と現金決済用の restpagos API は secure.payco.co を使用します。テストモードはペイロードのフラグ（EPAYCO_TEST）で指定し、ホストは分かれていません。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "epayco": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-epayco"],
      "env": {
        "EPAYCO_PUBLIC_KEY": "your-public-key",
        "EPAYCO_PRIVATE_KEY": "your-private-key",
        "EPAYCO_TEST": "true"
      }
    }
  }
}
Claude Code
claude mcp add epayco --env EPAYCO_PUBLIC_KEY=pk --env EPAYCO_PRIVATE_KEY=sk -- npx -y @codespar/mcp-epayco

ツール（8）

ツール説明
tokenize_cardカードトークンを作成します（POST /v1/tokens）
create_customerカードトークンに紐付けられた顧客を作成します
charge_cardトークン化されたカードで決済します（POST /payment/v1/charge/create）
get_transactionreferencePayco を指定して取引の詳細を取得します
create_pse_paymentPSE 銀行口座引き落とし — 銀行へのリダイレクト URL を返します
get_pse_transaction取引 ID を指定して PSE 取引のステータスを取得します
list_pse_banksPSE 銀行一覧を取得します
create_cash_paymentefecty／gana／redservi／puntored／sured の現金決済用バウチャーを作成します

環境変数

変数必須説明
EPAYCO_PUBLIC_KEYはい公開鍵
EPAYCO_PRIVATE_KEYはい秘密鍵
EPAYCO_TESTいいえ"true"（デフォルト）にすると、ペイロードがテストモードとして指定されます

ドキュメント

エンタープライズ

ePayco でのエージェント主導の決済に、ガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。