mcpField
M
mcp-rede

mcp-rede

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-rede

mcp-rede 是巴西 Itaú 旗下收单机构 Rede 的 MCP 服务，支持信用卡与借记卡的授权、捕获、退款，以及零元授权、卡令牌、定期扣款和 3DS 验证。适合与 Itaú 签有商户合同并直接对接 eRede 的商户。

主要功能

  1. 01信用卡与借记卡授权、捕获、撤销和退款
  2. 02零元授权与卡片验证
  3. 03卡令牌化及令牌信息查询
  4. 04定期扣款（recurrence）管理
  5. 053DS 认证流程
  6. 06Boleto 注册、查询与取消

适用场景

  1. 01为订阅业务创建和管理定期扣款
  2. 02在授权前验证客户卡片有效性
  3. 03为已完成 3DS 认证的交易提交授权

MCP 相关

该服务以 MCP 服务的形式向客户端暴露 22 个工具，用于处理 Rede 的交易、令牌、定期扣款、3DS 和 Boleto 操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-rede": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-rede"
      ],
      "env": {
        "REDE_PV": "<REDE_PV>",
        "REDE_TOKEN": "<REDE_TOKEN>",
        "REDE_ENV": "<REDE_ENV>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-rede
需要配置的环境变量
REDE_PVRede merchant filiação (PV) — numeric merchant identifier issued with your commercial contract.
REDE_TOKEN密钥Rede API security token paired with PV. Used in HTTP Basic auth as the password.
REDE_ENVEnvironment selector: 'sandbox' (default) or 'production'.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-rede0.2.0-alpha.3

工具

22

收录的工具列表 · 更新于 2 周前

参数类型必填说明
urlsarray否可选的回调/通知 URL 对象（{ url, kind }）
amountnumber是金额以分为单位
captureboolean是true = 授权并扣款；false = 仅授权
referencestring是商户侧订单引用（每个商户唯一）
cardNumberstring否PAN；切勿记录此值。建议改用 storageCard（令牌）。
storageCardstring否来自 tokenize_card 的令牌（替代 cardNumber）
installmentsnumber是分期期数（à vista 为 1）
securityCodestring否CVV
subscriptionboolean否标记为定期扣款（MIT）
cardHolderNamestring否持卡人姓名
expirationYearnumber否有效期年份（4 位数字）
softDescriptorstring否显示在持卡人账单上的账单描述
expirationMonthnumber否有效期月份（1–12）

详细介绍

@codespar/mcp-rede

适用于 Rede 的 MCP 服务——由 Itaú 持有的巴西收单机构。

Rede 与 Cielo、Stone 和 Getnet 并列，构成巴西四大收单机构。拥有 Itaú 商业合同的商户可通过 eRede 直接集成，而无需经由 PSP。

工具（22）

工具用途
authorize_transaction在 Rede 上授权信用卡交易。
capture_transaction扣款此前已授权的交易（适用于使用 capture=false 的情况）。
cancel_transaction取消已授权但尚未扣款的交易（撤销）。
refund_transaction退还已扣款交易的款项。
get_transaction按 Rede tid 或商户参考编号查询交易。
zero_auth验证卡片但不扣款（零金额授权／账户验证）。
tokenize_card将卡片令牌化，以便安全地用于符合 PCI 标准的场景。
delete_token删除此前创建的卡片令牌。
create_recurrence创建 Rede 原生定期付款（订阅）。
get_recurrence按 Rede 定期付款 ID 查询定期付款。
disable_recurrence停用（取消）有效的定期付款。
authorize_debit在 Rede 上授权借记卡交易。
list_transactions列出指定日期范围内的交易。
get_token查询此前存储的卡片令牌的元数据（卡品牌、末 4 位、有效期）。
update_recurrence更新现有定期付款——更改金额、卡片（storageCard）、结束日期，或暂停／恢复。
get_recurrence_transactions列出定期付款生成的交易（每个已执行的计费周期对应一行）。
authenticate_3ds为银行卡扣款发起 3DS（EMV 3-D Secure）身份验证。
get_3ds_status按参考 ID 查询 3DS 身份验证的当前状态。
authorize_with_3ds成功完成 3DS 身份验证后授权交易，并附上 3DS 参考信息，以便进行责任转移……
create_boleto通过 Rede 签发已登记的 boleto。
get_boleto按 Rede boleto ID 或商户参考编号查询 boleto。
cancel_boleto取消未付款的 boleto。

安装

npm install @codespar/mcp-rede@alpha

环境

REDE_PV="..."       # Merchant filiação (PV)
REDE_TOKEN="..."    # Security token (paired with PV)
REDE_ENV="sandbox"  # Optional. 'sandbox' (default) or 'production'

身份验证

使用 base64(PV:TOKEN) 进行 HTTP Basic 身份验证。服务会在每次请求时构建 Authorization 标头，调用方无需处理。

基础 URL

  • 生产环境：https://api.userede.com.br/erede/v1
  • 沙盒环境： https://sandbox-erede.useredecloud.com.br/v1

运行

# stdio (default)
npx @codespar/mcp-rede

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-rede

企业版

需要为 Agent 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、支付路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。