mcp-conekta について
mcp-conekta は、メキシコの決済ゲートウェイ Conekta 向けの MCP サーバーです。カード、OXXO 現金払い、SPEI 銀行振込に対応しています。注文、顧客、決済をエージェントから扱いたい開発者に適しています。
主な機能
- 01注文の作成、参照、更新、キャンセル
- 02顧客と支払いソース(カードトークン)の管理
- 03チャージの作成と事前承認済みの売上確定
- 04返金処理
- 05Webhook イベントの取得とエンドポイント管理
活用シーン
- 01エージェントからメキシコの顧客向けに注文とチャージを作成
- 02注文とチャージの状態を確認し返金を実行
- 03Webhook イベントで決済ステータスの変化を追跡
MCP 対応
本プロジェクトは MCP サーバーであり、Conekta API を呼び出す 21 のツールを MCP クライアントに提供します。注文、顧客、チャージ、Webhook の操作に対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
21掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| charges | array | いいえ | 注文の料金 |
| currency | string | はい | 通貨コード(例:MXN) |
| line_items | array | はい | 注文の明細項目 |
| customer_info | object | はい | 顧客情報 |
| customer_info.name | string | はい | 顧客名 |
| customer_info.email | string | はい | 顧客のメールアドレス |
| customer_info.phone | string | はい | 顧客の電話番号 |
詳細
@codespar/mcp-conekta
カード決済、OXXO の現金決済、SPEI 銀行振込に対応する、メキシコを代表する決済ゲートウェイ Conekta 用の MCP サーバー
クイックスタート
# Set your API key
export CONEKTA_API_KEY="key_..."
# Run via stdio
npx -y @codespar/mcp-conekta
# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-conekta
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
CONEKTA_API_KEY | はい | Conekta ダッシュボードの API キー |
MCP_HTTP | いいえ | HTTP トランスポートを有効にするには "true" に設定します |
MCP_PORT | いいえ | HTTP ポート(デフォルト:3000) |
ツール(21)
| ツール | 目的 |
|---|---|
create_order | 新しい注文を作成します |
get_order | ID で注文の詳細を取得します |
list_orders | フィルターを指定して注文を一覧表示します |
create_customer | 顧客を作成します |
get_customer | ID で顧客を取得します |
list_customers | 顧客を一覧表示します |
create_charge | 既存の注文に対する請求を作成します |
refund_charge | 請求を返金します |
list_payment_sources | 顧客の決済ソースを一覧表示します |
get_webhook_events | Webhook イベント(Conekta Events)を一覧表示します |
get_webhook_event | ID で単一の Webhook イベントを取得します |
update_customer | 顧客を更新します |
delete_customer | 顧客を削除します |
create_payment_source | 顧客の決済ソース(カードトークン)を作成します |
delete_payment_source | 顧客から決済ソースを削除します |
update_order | 注文(line_items、metadata など)を更新します |
cancel_order | 注文をキャンセルします |
capture_charge | 事前承認済みの注文を確定します(pre_authorized → paid) |
create_webhook | Webhook エンドポイントを作成します |
update_webhook | Webhook エンドポイントを更新します |
delete_webhook | Webhook エンドポイントを削除します |
認証
API キーをユーザー名、空のパスワードとして使用する Basic 認証を使用します。API バージョン v2.2.0 は Accept ヘッダーで設定されます。API キーは Conekta Dashboard で取得してください。
API リファレンス
エンタープライズ
エージェントによる決済にガバナンス、予算上限、監査証跡が必要ですか? CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。
認証
サーバーを起動する前に、次の環境変数を設定してください。
CONEKTA_API_KEY(必須、シークレット) — Conekta の API キー
認証情報は、プロバイダーの開発者ポータルで発行してください:https://developers.conekta.com。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。