mcpField
M
mcp-cielo

mcp-cielo

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

关于 mcp-cielo

mcp-cielo 是 Cielo 的 MCP 服务，提供信用卡、借记卡、Boleto、Pix 及定期支付等收单相关操作。适用于在巴西等市场处理线上支付的商户和开发者。

主要功能

  1. 0122 个 MCP 工具，覆盖卡支付、Pix 与 Boleto
  2. 02定期支付的创建、金额与日期更新及暂停恢复
  3. 03支持 CardToken 与 3DS 2.0 认证数据
  4. 04提供防欺诈分析与支付链接查询

适用场景

  1. 01通过 Agent 创建销售、捕获或取消预授权交易
  2. 02管理定期支付的金额、下次扣款日期及启停
  3. 03生成 Pix 二维码或 Cielo 支付链接

MCP 相关

该项目是一个 MCP 服务，将 Cielo 的支付、定期支付、Pix、Boleto、防欺诈及支付链接接口以工具形式提供给 MCP 客户端。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-cielo": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-cielo"
      ],
      "env": {
        "CIELO_API_KEY": "<CIELO_API_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-cielo
需要配置的环境变量
CIELO_API_KEY密钥API key for cielo

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

安装包
npm@codespar/mcp-cielo0.2.2

工具

22

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

参数类型必填说明
brandenum是卡品牌Visa | Master | Elo | Amex | Hipercard
amountnumber是金额，单位为分（例如，15700 = R$157.00）
holderstring是持卡人姓名
captureboolean否自动捕获（设为 true 可立即捕获）
cardNumberstring是信用卡号
customerNamestring是客户名称
installmentsnumber否分期付款次数（全额付款时为 1）
securityCodestring是CVV
expirationDatestring是有效期（MM/YYYY）
merchantOrderIdstring是商户订单参考号

详细介绍

@codespar/mcp-cielo

用于 Cielo 的 MCP 服务 — 收单、boleto 和定期付款

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "cielo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-cielo"],
      "env": {
        "CIELO_MERCHANT_ID": "your-merchant-id",
        "CIELO_MERCHANT_KEY": "your-merchant-key",
        "CIELO_SANDBOX": "true"
      }
    }
  }
}
Claude Code
claude mcp add cielo -- npx @codespar/mcp-cielo
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "cielo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-cielo"],
      "env": {
        "CIELO_MERCHANT_ID": "your-merchant-id",
        "CIELO_MERCHANT_KEY": "your-merchant-key",
        "CIELO_SANDBOX": "true"
      }
    }
  }
}

工具（22 个）

工具用途
create_sale在 Cielo 创建信用卡/借记卡销售
get_sale根据 PaymentId 获取销售详情
capture_sale捕获一笔预授权销售
cancel_sale取消/撤销一笔销售（全额或部分）
create_recurrent创建定期信用卡付款
get_recurrent获取定期付款详情
tokenize_card对信用卡进行令牌化，以供日后使用
create_boleto在 Cielo 创建 boleto 付款
create_pix在 Cielo 创建 Pix 付款（生成二维码）
get_pix根据 PaymentId 获取 Pix 付款详情和二维码
create_debit在 Cielo 创建借记卡销售（需要 3DS 身份验证）
create_ewallet创建数字钱包付款（Google Pay、Samsung Pay、Apple Pay）
get_antifraud获取付款的反欺诈分析详情
create_sale_with_token使用之前存储的 CardToken 创建信用卡销售（无需重新输入卡片信息）
update_recurrent_amount更新现有定期付款的金额
update_recurrent_next_date更新现有定期付款的下次扣款日期
deactivate_recurrent停用（暂停）定期付款，使其停止扣款
reactivate_recurrent重新启用之前停用的定期付款
create_payment_link创建 Cielo Link de Pagamento（可分享的结账 URL）
get_payment_link根据 ID 获取 Cielo Link de Pagamento
zero_auth零金额授权，用于验证卡片而不扣款（使用卡片或 CardToken）
create_sale_with_3ds使用 3DS 流程提供的 3DS 2.0 身份验证数据创建信用卡销售

身份验证

Cielo 使用 MerchantId 和 MerchantKey 标头进行身份验证。

沙盒 / 测试

Cielo 提供沙盒 apisandbox.cieloecommerce.cielo.com.br。设置 CIELO_SANDBOX=true 即可使用。

获取凭据
  1. 前往 Cielo Developer Portal
  2. 创建开发者账户
  3. 获取 MerchantId 和 MerchantKey
  4. 设置环境变量

环境变量

变量必需描述
CIELO_MERCHANT_ID是Cielo 提供的商户 ID
CIELO_MERCHANT_KEY是Cielo 提供的商户密钥
CIELO_SANDBOX否设置为 "true" 以使用沙盒模式

路线图

v0.2（计划中）
  • create_pix — 创建 Pix 付款
  • get_pix — 获取 Pix 付款详情
  • create_debit — 创建借记卡付款
  • create_ewallet — 创建电子钱包付款（Apple Pay、Google Pay）
  • get_antifraud — 获取交易的反欺诈分析
v0.3（计划中）
  • batch_captures — 捕获多笔预授权交易
  • velocity_rules — 配置交易频率/反欺诈规则

想要参与贡献？提交 PR 或申请工具。

链接

企业版

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

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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