跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Mercado Pago,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
Mercado Pago 卖家账户(阿根廷、巴西、墨西哥、智利、哥伦比亚、秘鲁、乌拉圭):含手续费、净额和资金释放日期的付款,商户订单,订阅,支付方式,以及用于对账的已释放资金报表和账户资金报表(生成、列出、下载)。不会动用任何资金。
试试这样问
Mercado Pago 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Mercado Pago、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Mercado Pago
Mercado Pago 卖家账户(阿根廷、巴西、墨西哥、智利、哥伦比亚、秘鲁、乌拉圭):含手续费、净额和资金释放日期的付款,商户订单,订阅,支付方式,以及用于对账的已释放资金报表和账户资金报表(生成、列出、下载)。不会动用任何资金。
设置
设置大约需要 3 分钟。你需要想要读取数据的 Mercado Pago 账户,以及 Mercado Pago 开发者面板中的一个应用(名称随意)。
- 用该账户登录 https://www.mercadopago.com/developers/panel/app,打开 Your integrations,如果还没有应用就创建一个。名称随意,产品选 Checkout Pro 或 Payments 都可以。
- 在应用中打开 Production credentials 并激活(接受条款)。
- 把 Access Token(以
APP_USR-开头)复制到MERCADO_PAGO_ACCESS_TOKEN,只粘贴令牌本身,不要加 Bearer 一词、空格或引号。不需要 Public Key、Client ID 和 Client Secret。 - 安装连接器并运行
mercado_pago_get_account:它会显示令牌所属的账户及其国家站点(MLA 阿根廷、MLB 巴西、MLM 墨西哥、MLC 智利、MCO 哥伦比亚、MPE 秘鲁、MLU 乌拉圭)。
令牌可访问整个账户:请妥善保密。如果泄露,在同一面板中重置并粘贴新令牌。测试凭据只能看到测试数据,测试账户的报表为空。
可读取的内容:账户信息;过去 12 个月的付款,包括状态、总额、扣除手续费后的净收入、手续费明细、支付方式和卡组织、分期数、付款人、外部参考号和资金释放日期;单笔付款的全部详情,包括退款、商品和配送;过去 90 天的商户订单(Checkout Pro 或二维码销售背后的订单,汇总其付款和发货);订阅的状态、金额、频率和下次扣款日期;以及账户所在国家可用的支付方式,含最低和最高金额以及到账时间。
搜索付款:AI 可按状态、按创建、批准、最后更新或资金释放日期的时间范围,以及按你的外部参考号筛选。每页返回 1 到 100 笔付款,它会查看匹配总数并逐页读取其余部分。如果要做整月的账务,报表是更合适的工具。
用于对账的报表:已释放资金报表(Dinero liberado / Dinheiro liberado:已变为可用的资金,逐笔列出付款、手续费、退款和提现)和账户资金报表(Dinero en cuenta,原名 all transactions:余额的每一笔变动)。AI 会先列出已有的报表,包括在 Mercado Pago 面板中设置的定期报表。如果没有合适的,它会为你的时间段生成一份,等到状态变为 processed(一分钟或更久)后再下载。CSV 报表以分号分隔的文本返回,带表头行,列按面板中的配置;XLSX 报表以文件形式返回。
金额和日期:金额是账户币种(ARS、BRL、MXN、CLP、COP、PEN 或 UYU)的小数。付款日期带有账户所在时区的偏移,报表日期为 UTC:布宜诺斯艾利斯的午夜是 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)后,它会等待一分钟再重试。
常见错误:401 表示令牌错误、已重置或是测试令牌。403 表示令牌所属的应用无权访问该资源。付款返回 404 表示该付款属于另一个账户。
该连接器不会动用资金:不退款、不提现、不扣款,也不创建支付偏好或付款链接。
前提条件: MERCADO_PAGO_ACCESS_TOKEN
本地安装连接器
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
打开 http://localhost:3000/connectors/store,选择 Mercado Pago 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
mercado_pago_get_account | Get the Mercado Pago account behind the access token: user id, nickname, name, e-mail, country, site (MLA Argentina, MLB Brazil, MLM… |
mercado_pago_search_payments | Search the payments received by the account (the last 12 months at most): id, status, amount, net received after fees, fees, payment… |
mercado_pago_get_payment | Get every detail of one payment by id: status and status_detail, amounts, fees and net received, refunds, payment method and card brand… |
mercado_pago_search_merchant_orders | Search merchant orders (the order behind a Checkout Pro or QR sale, grouping its payments and shipments) of the last 90 days: status… |
mercado_pago_get_merchant_order | Get one merchant order by id: status, order_status, total and paid amounts, items, its payments and shipments |
mercado_pago_list_payment_methods | List the payment methods available to the account in its country: id (visa, master, pix, bolbradesco, account_money...), name, type… |
mercado_pago_list_release_reports | List the released money reports (Dinero liberado / Dinheiro liberado: the money that became available, with each payment, fee, refund and… |
mercado_pago_create_release_report | Ask Mercado Pago to generate a released money report (Dinero liberado / Dinheiro liberado: the money that became available, with each… |
mercado_pago_download_release_report | Download one released money report by its file_name (from mercado_pago_list_release_reports) |
mercado_pago_list_settlement_reports | List the account money reports (Dinero en cuenta, formerly "all transactions": every movement of the account balance) already generated for… |
mercado_pago_create_settlement_report | Ask Mercado Pago to generate a account money report (Dinero en cuenta, formerly "all transactions": every movement of the account balance)… |
mercado_pago_download_settlement_report | Download one account money report by its file_name (from mercado_pago_list_settlement_reports) |
mercado_pago_search_subscriptions | Search subscriptions (preapprovals) of the account: id, status (pending, authorized, paused, cancelled), payer e-mail, plan, reason, amount… |
示例提示
- “上周我们通过 Mercado Pago 收了多少钱,扣除手续费后还剩多少?”
- “找到外部参考号为 ORDER-1042 的付款,告诉我它是否已退款。”
- “未来 7 天内有哪些付款会释放到我的余额,总共多少?”
- “生成 9 月的已释放资金报表,并汇总手续费和退款。生成前先跟我确认。”
- “我们有哪些订阅已暂停或已取消,每个订阅每月付多少?”
下一步
这份指南对你有帮助吗?