Mcp Cielo

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

MCP server for Cielo — credit card, debit, boleto, recurrent payments

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向 Cielo 支付平台的 MCP 服务器，让助手创建和管理信用卡、借记卡、boleto、Pix、钱包及定期付款。

可以做什么
  • 创建与查询交易：信用卡、借记卡、3DS、令牌支付和数字钱包支付，以及交易查询、捕获与取消
  • 管理定期付款：创建、查询、修改金额或下次扣款日期、停用与重新启用
  • 创建并查询 boleto 与 Pix 付款，包括 Pix 二维码
  • 对银行卡进行令牌化，并用零金额授权验证卡片
  • 创建和查询可分享的支付链接
  • 获取付款的反欺诈分析详情
适用场景
适合需要让助手直接操作 Cielo 商户账户的场景，例如创建或取消扣款、管理订阅、开具 Pix 或 boleto 付款、查询付款与反欺诈状态，并先在 Cielo 沙箱中测试。
运行要求
通过 npx 从 npm 包 @codespar/mcp-cielo 本地运行（需要 Node.js）。需要 Cielo 开发者账户的 MerchantId 与 MerchantKey，通过 CIELO_MERCHANT_ID 和 CIELO_MERCHANT_KEY 提供；设置 CIELO_SANDBOX=true 使用沙箱。需要访问 Cielo API 的网络。清单声明的是 CIELO_API_KEY，请确认该包实际读取哪些变量。
安装前请注意
这些工具会动用真实资金：创建交易、捕获、定期扣款、支付链接和重新启用都可能向客户收费，取消或停用会改变真实付款状态。商户凭据（CIELO_MERCHANT_ID、CIELO_MERCHANT_KEY）是拥有完整账户权限的机密，勿放入共享配置，验证前请使用沙箱。卡数据和付款信息会发送给 Cielo，反欺诈查询还会发送给其反欺诈服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Cielo，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-cielo

MCP server for Cielo — card acquiring, boleto, and recurrent payments

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

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

bash
claude mcp add cielo -- npx @codespar/mcp-cielo

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

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"      }    }  }}

Tools (22)

ToolPurpose
create_saleCreate a credit/debit card sale in Cielo
get_saleGet sale details by PaymentId
capture_saleCapture a pre-authorized sale
cancel_saleCancel/void a sale (full or partial)
create_recurrentCreate a recurrent (recurring) credit card payment
get_recurrentGet recurrent payment details
tokenize_cardTokenize a credit card for future use
create_boletoCreate a boleto payment in Cielo
create_pixCreate a Pix payment in Cielo (generates QR code)
get_pixGet Pix payment details and QR code by PaymentId
create_debitCreate a debit card sale in Cielo (requires 3DS authentication)
create_ewalletCreate a digital wallet payment (Google Pay, Samsung Pay, Apple Pay)
get_antifraudGet anti-fraud analysis details for a payment
create_sale_with_tokenCreate a credit card sale using a previously stored CardToken (avoids re-entering card data)
update_recurrent_amountUpdate the amount of an existing recurrent payment
update_recurrent_next_dateUpdate the next charge date of an existing recurrent payment
deactivate_recurrentDeactivate (pause) a recurrent payment so it stops charging
reactivate_recurrentReactivate a previously deactivated recurrent payment
create_payment_linkCreate a Cielo Link de Pagamento (shareable checkout URL)
get_payment_linkGet a Cielo Link de Pagamento by its id
zero_authZero-dollar authorization to validate a card without charging (card or CardToken)
create_sale_with_3dsCreate a credit card sale using 3DS 2.0 authentication data (from 3DS flow)

Authentication

Cielo uses MerchantId and MerchantKey headers for authentication.

Sandbox / Testing

Cielo provides a sandbox at apisandbox.cieloecommerce.cielo.com.br. Set CIELO_SANDBOX=true to use it.

Get your credentials

  1. Go to Cielo Developer Portal
  2. Create a developer account
  3. Get your MerchantId and MerchantKey
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
CIELO_MERCHANT_IDYesMerchant ID from Cielo
CIELO_MERCHANT_KEYYesMerchant Key from Cielo
CIELO_SANDBOXNoSet to "true" for sandbox mode

Roadmap

v0.2 (planned)

  • create_pix — Create a Pix payment
  • get_pix — Get Pix payment details
  • create_debit — Create a debit card payment
  • create_ewallet — Create an e-wallet payment (Apple Pay, Google Pay)
  • get_antifraud — Get anti-fraud analysis for a transaction

v0.3 (planned)

  • batch_captures — Capture multiple pre-authorized transactions
  • velocity_rules — Configure velocity/anti-fraud rules

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源：packages/payments/cielo/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分