mcpField
M
mcp-conekta

mcp-conekta

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

mcp-conekta について

mcp-conekta は、メキシコの決済ゲートウェイ Conekta 向けの MCP サーバーです。カード、OXXO 現金払い、SPEI 銀行振込に対応しています。注文、顧客、決済をエージェントから扱いたい開発者に適しています。

主な機能

  1. 01注文の作成、参照、更新、キャンセル
  2. 02顧客と支払いソース(カードトークン)の管理
  3. 03チャージの作成と事前承認済みの売上確定
  4. 04返金処理
  5. 05Webhook イベントの取得とエンドポイント管理

活用シーン

  1. 01エージェントからメキシコの顧客向けに注文とチャージを作成
  2. 02注文とチャージの状態を確認し返金を実行
  3. 03Webhook イベントで決済ステータスの変化を追跡

MCP 対応

本プロジェクトは MCP サーバーであり、Conekta API を呼び出す 21 のツールを MCP クライアントに提供します。注文、顧客、チャージ、Webhook の操作に対応します。

設定

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

mcp.json · 共通設定
{
"mcpServers": {
"codespar-mcp-conekta": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-conekta"
],
"env": {
"CONEKTA_API_KEY": "<CONEKTA_API_KEY>"
}
}
}
}
起動コマンドnpx -y @codespar/mcp-conekta
設定が必要な環境変数
CONEKTA_API_KEYシークレットAPI key for Conekta

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

パッケージ
npm@codespar/mcp-conekta0.2.2

ツール

21

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

パラメーター型必須説明
chargesarrayいいえ注文の料金
currencystringはい通貨コード(例:MXN)
line_itemsarrayはい注文の明細項目
customer_infoobjectはい顧客情報
customer_info.namestringはい顧客名
customer_info.emailstringはい顧客のメールアドレス
customer_info.phonestringはい顧客の電話番号

詳細

@codespar/mcp-conekta

カード決済、OXXO の現金決済、SPEI 銀行振込に対応する、メキシコを代表する決済ゲートウェイ Conekta 用の MCP サーバー

npm License: MIT

クイックスタート

# 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_orderID で注文の詳細を取得します
list_ordersフィルターを指定して注文を一覧表示します
create_customer顧客を作成します
get_customerID で顧客を取得します
list_customers顧客を一覧表示します
create_charge既存の注文に対する請求を作成します
refund_charge請求を返金します
list_payment_sources顧客の決済ソースを一覧表示します
get_webhook_eventsWebhook イベント(Conekta Events)を一覧表示します
get_webhook_eventID で単一の Webhook イベントを取得します
update_customer顧客を更新します
delete_customer顧客を削除します
create_payment_source顧客の決済ソース(カードトークン)を作成します
delete_payment_source顧客から決済ソースを削除します
update_order注文(line_items、metadata など)を更新します
cancel_order注文をキャンセルします
capture_charge事前承認済みの注文を確定します(pre_authorized → paid)
create_webhookWebhook エンドポイントを作成します
update_webhookWebhook エンドポイントを更新します
delete_webhookWebhook エンドポイントを削除します

認証

API キーをユーザー名、空のパスワードとして使用する Basic 認証を使用します。API バージョン v2.2.0 は Accept ヘッダーで設定されます。API キーは Conekta Dashboard で取得してください。

API リファレンス


エンタープライズ

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

認証

サーバーを起動する前に、次の環境変数を設定してください。

  • CONEKTA_API_KEY (必須、シークレット) — Conekta の API キー

認証情報は、プロバイダーの開発者ポータルで発行してください:https://developers.conekta.com。

ライセンス

MIT

コメント

MCP は初めてですか?

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

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