MCP 経由で Mercado Pago を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Mercado Pago をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Mercado Pago + Cursor

Mercado Pago の販売者アカウント（アルゼンチン、ブラジル、メキシコ、チリ、コロンビア、ペルー、ウルグアイ）を扱います：手数料・純額・入金可能日つきの決済、マーチャントオーダー、サブスクリプション、決済手段、そして照合用の入金済み資金レポートと口座残高レポート（作成、一覧、ダウンロード）。お金は動かしません。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

MERCADO_PAGO_ACCESS_TOKEN

ステップ 1 — 認証情報を取得

設定は約 3 分です。データを見たい Mercado Pago アカウントと、Mercado Pago 開発者パネルのアプリケーション（名前は自由）が必要です。

1. そのアカウントで https://www.mercadopago.com/developers/panel/app にサインインし、Your integrations を開きます。アプリケーションがなければ作成します。名前は何でもよく、プロダクトは Checkout Pro または Payments で構いません。
2. アプリケーションで Production credentials を開き、有効にします（利用規約に同意します）。
3. Access Token（APP_USR- で始まります）を MERCADO_PAGO_ACCESS_TOKEN にコピーします。Bearer という語、空白、引用符は付けず、トークンだけを貼り付けてください。Public Key、Client ID、Client Secret は不要です。
4. コネクターをインストールして mercado_pago_get_account を実行します。トークンのアカウントと国サイト（MLA アルゼンチン、MLB ブラジル、MLM メキシコ、MLC チリ、MCO コロンビア、MPE ペルー、MLU ウルグアイ）が表示されます。

トークンでアカウント全体にアクセスできます: 秘密にしてください。漏れた場合は同じパネルでリセットし、新しいトークンを貼り付けます。テスト用の認証情報ではテストデータしか見えず、テストアカウントのレポートは空です。

読み取れる内容: アカウント情報、過去 12 か月の決済（ステータス、総額、手数料差し引き後の受取額、手数料の内訳、決済手段とカードブランド、分割回数、支払者、外部参照、入金可能日）、1 件の決済の全詳細（返金、商品、配送を含む）、過去 90 日のマーチャントオーダー（Checkout Pro や QR 販売の注文で、決済と配送をまとめたもの）、サブスクリプション（ステータス、金額、頻度、次回支払日）、そしてアカウントの国で使える決済手段（最小・最大金額と入金までの時間）。

決済の検索: AI はステータス、作成日・承認日・最終更新日・入金可能日のいずれかによる期間、そして外部参照で絞り込みます。1 ページあたり 1 から 100 件を取得し、該当件数の合計を確認して残りをページ送りします。1 か月分の経理には、レポートの方が適しています。

照合用のレポート: 入金済み資金レポート（Dinero liberado / Dinheiro liberado：利用可能になったお金を、決済、手数料、返金、出金ごとに示すもの）と口座残高レポート（Dinero en cuenta、旧 all transactions：残高のすべての動き）です。AI はまず、Mercado Pago のパネルで設定した定期レポートも含めて既存のレポートを一覧にします。合うものがなければ指定期間のレポートを作成し、ステータスが processed になるまで（1 分以上）待ってからダウンロードします。CSV レポートはヘッダー行つきのセミコロン区切りテキストで、列はパネルの設定どおりです。XLSX レポートはファイルとして返ります。

金額と日付: 金額はアカウント通貨（ARS、BRL、MXN、CLP、COP、PEN、UYU）の小数です。決済の日付にはアカウントのタイムゾーンのオフセットが付き、レポートの日付は UTC です。ブエノスアイレスの午前 0 時は UTC の 03:00 です。

変更の前に必ず確認: 書き込みを行うのは mercado_pago_create_release_report と mercado_pago_create_settlement_report だけです。アカウントにレポートファイルを作成するだけで、お金は動きません。AI はレポートの種類と期間を示し、あなたの承認を待ちます。それ以外はすべて読み取りのみです。

制限: 決済の検索は過去 12 か月、マーチャントオーダーは過去 90 日までです。Mercado Pago は未来の終了日や自社の締め日を超える終了日を拒否し、指定できる最終日を示します。200 KB を超えるレポートのテキストは切り詰められるため、AI は期間を短くします。429（local_rate_limited または too_many_requests）のあとは、1 分待ってから再試行します。

よくあるエラー: 401 はトークンが間違っている、リセットされた、またはテスト用であることを示します。403 はトークンのアプリケーションにそのリソースへのアクセス権がないことを示します。決済の 404 は、その決済が別のアカウントのものであることを意味します。

このコネクターはお金を動かしません。返金、出金、請求は行わず、決済プリファレンスや支払いリンクも作成しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Mercado Pago のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「先週 Mercado Pago でいくら売り上げ、手数料を引いた後にいくら残りましたか。」
• 「外部参照が ORDER-1042 の決済を探して、返金されたかどうか教えてください。」
• 「今後 7 日間に残高へ入金可能になる決済はどれで、合計はいくらですか。」
• 「9 月分の入金済み資金レポートを作成して、手数料と返金の合計を出してください。作成する前に確認させてください。」
• 「一時停止中または解約済みのサブスクリプションはどれで、それぞれ月にいくら支払っていましたか。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続