如何通过 MCP 将 Mercado Pago 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Mercado Pago、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Mercado Pago + Cursor

Mercado Pago 卖家账户（阿根廷、巴西、墨西哥、智利、哥伦比亚、秘鲁、乌拉圭）：含手续费、净额和资金释放日期的付款，商户订单，订阅，支付方式，以及用于对账的已释放资金报表和账户资金报表（生成、列出、下载）。不会动用任何资金。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

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 个月的付款，包括状态、总额、扣除手续费后的净收入、手续费明细、支付方式和卡组织、分期数、付款人、外部参考号和资金释放日期；单笔付款的全部详情，包括退款、商品和配送；过去 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 表示该付款属于另一个账户。

该连接器不会动用资金：不退款、不提现、不扣款，也不创建支付偏好或付款链接。

步骤 2 — 安装 adapter

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 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT