mcp-mercado-pago

@codespar/mcp-mercado-pago

ラテンアメリカを代表する決済プラットフォーム、Mercado Pago 用の MCP サーバー

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "mercado-pago": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-mercado-pago"],
      "env": {
        "MERCADO_PAGO_ACCESS_TOKEN": "APP_USR-..."
      }
    }
  }
}

Claude Code

claude mcp add mercado-pago -- npx @codespar/mcp-mercado-pago

CLI

# Set your access token
export MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..."

# Run via stdio
npx -y @codespar/mcp-mercado-pago

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-mercado-pago

ツール（30）

ツール	用途
create_payment	新しい支払いを作成します
get_payment	ID で支払いの詳細を取得します
search_payments	フィルターを使って支払いを検索します
create_refund	支払いを払い戻します（一部または全額）
create_preference	Checkout Pro 用のチェックアウト設定を作成します
get_preference	ID でチェックアウト設定を取得します
create_customer	顧客を作成します
list_customers	顧客の一覧を取得します
get_payment_methods	利用可能な支払い方法の一覧を取得します
create_pix_payment	PIX 支払いを作成します
get_merchant_order	ID で加盟店注文を取得します
get_balance	アカウント残高を取得します
create_subscription	定期購入（事前承認）を作成します
get_subscription	ID で定期購入（事前承認）の詳細を取得します
cancel_subscription	定期購入（事前承認）をキャンセルします
create_card_token	安全な支払いのためにカードをトークン化します
get_payment_method_details	ID で特定の支払い方法の詳細を取得します
create_store	店舗（実店舗または POS グループ）を作成します
list_stores	店舗の一覧を取得します
create_pos	店舗に紐付いた販売時点情報管理（POS）を作成します
update_subscription	定期購入（事前承認）を更新します：金額、ステータス、理由、カードトークンなど
oauth_token_exchange	認証コードを販売者のアクセストークンと交換します（マーケットプレイスのオンボーディング）。
create_advanced_payment	受取人ごとの支払い分配（application_fee、money_release_days、c...）を設定したマーケットプレイスの分割払いを作成します
get_advanced_payment	ID で高度な（分割）支払いを取得します
get_chargeback	ID でチャージバックの詳細を取得します
upload_chargeback_evidence	チャージバックの異議申し立てに関する書類／証拠をアップロードします。
get_identification_types	国ごとに利用可能な書類／本人確認の種類（CPF、CNPJ、DNI、RUT など）を取得します。
get_payment_methods_by_site	特定の Mercado Pago サイトで利用可能な支払い方法の一覧を取得します（MLB=ブラジル、MLA=アルゼンチン、MLM=メキシコ、MLC...
create_settlement_report	期間を指定して決済（アカウント資金）レポートを手動で生成します。
search_merchant_orders	フィルターを使って加盟店注文を検索します（過去90日間）。

環境変数

変数	必須	説明
MERCADO_PAGO_ACCESS_TOKEN	はい	Mercado Pago ダッシュボードのアクセストークン
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには "true" に設定します
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

認証

Bearer トークン認証を使用します。サーバーを起動する前に、次の環境変数を設定してください：

• MERCADO_PAGO_ACCESS_TOKEN (必須、シークレット)：Mercado Pago のアクセストークン

Mercado Pago Developers ダッシュボードで認証情報を発行してください。

API リファレンス

• Mercado Pago API ドキュメント

エンタープライズ

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

ライセンス

MIT