mcp-iniciador

@codespar/mcp-iniciador

面向 Iniciador 的 MCP 服务——巴西开放金融 PISP（Pix 支付发起聚合器）。Iniciador 持有 ICP-Brasil 证书，并与各家巴西银行协调 DCR，以支持即时 Pix 出账流程。

快速开始

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "iniciador": {
      "command": "npx",
      "args": ["@codespar/mcp-iniciador"],
      "env": {
        "INICIADOR_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / VS Code

在 .cursor/mcp.json 中使用相同配置。

工具（9 个）

机构

工具	Iniciador 端点	说明
list_institutions	GET /institutions	支持发起 Pix 的巴西银行

授权

工具	Iniciador 端点	说明
create_consent	POST /consents	付款授权，由付款人在其银行处授权
get_consent	GET /consents/{id}	当前授权状态
revoke_consent	DELETE /consents/{id}	使用前撤销

支付

工具	Iniciador 端点	说明
create_payment	POST /payments	授权获批后发起 Pix
get_payment	GET /payments/{id}	状态 / E2E ID / 拒绝原因
list_payments	GET /payments	按日期范围 / 状态筛选
cancel_payment	POST /payments/{id}/cancel	尽力在结算前取消

辅助工具

工具	说明
get_authorization_url	用于构建 OFB 授权 URL 的客户端工具（授权 ID + ISPB + 重定向地址）

身份验证

此服务使用 Iniciador 的 API 密钥身份验证（X-API-KEY 请求头）。Pix 出账调用本身使用消费者银行签发的授权令牌进行端到端签名。付款人在其银行处授权后，Iniciador 后端会将该令牌接入调用流程。部分流程需要 OAuth2 客户端凭证；待授权与银行签发令牌的端到端接入完成后，这项支持也将推出。

在 Iniciador 入驻流程中申请凭证：

• 生产环境：https://iniciador.com.br
• 文档：https://docs.iniciador.com.br

沙盒 / 测试

沙盒端点：https://sandbox.iniciador.com.br。可通过 INICIADOR_API_BASE 覆盖。

环境变量

变量	必需	说明
INICIADOR_API_KEY	是	Iniciador 入驻流程提供的 API 密钥
INICIADOR_API_BASE	否	覆盖 API 基础 URL（默认为 https://api.iniciador.com.br）

Iniciador、Pluggy 与 Belvo 的比较

此目录中有三个 OFB 聚合器，各有不同专长：

聚合器	优势	最适合
Iniciador	Pix 支付发起（PISP）	在 OFB 授权下发起付款
Pluggy（@codespar/mcp-pluggy）	读取账户和交易	对账、轮询余额
Belvo（@codespar/mcp-belvo）	覆盖多个拉美国家的开放金融 + 工资 + 税务	跨境业务（BR + MX + CO + AR）

对于既需要读取又需要写入的商业 Agent，可将它们组合使用：用 Pluggy / Belvo 查看账户和对账信息，用 Iniciador 发起 Pix。

企业版

需要为 Agent 付款设置治理、预算限制和审计跟踪？CodeSpar Enterprise 可在这些 MCP 服务基础上提供策略引擎、支付路由和合规模板。

许可证

MIT