关于 mcp-c6
mcp-c6 是面向 C6 Bank 的 MCP 服务,原计划提供 Pix、Boleto 与账户数据相关工具。该包已弃用,测得的 baas.c6bank.com.br 等域名无法解析,当前没有工具能够访问服务。它仅保留在仓库中供参考,若要恢复需提供可用的端点地址。
主要功能
- 01Pix 即时与到期收款相关工具(cob、cobv)
- 02DICT 密钥的查询、登记与删除
- 03Boleto 开具、查询与撤销
- 04账户余额与对账单查询
适用场景
- 01参考 C6 Bank 接口结构以开发新的 MCP 服务
- 02在提供可用端点后作为 Pix 与 Boleto 集成的起点
MCP 相关
该项目是 MCP 服务,原本向 MCP 客户端暴露 14 个工具,但当前没有工具能够连接到服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @codespar/mcp-c6C6_CLIENT_IDC6 OAuth client_id issued via the Developer Portal after contract onboarding.C6_CLIENT_SECRET密钥C6 OAuth client_secret.C6_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2.C6_KEY_PATH密钥Absolute path to the mTLS private key (.key or .pem).C6_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
14收录的工具列表 · 更新于 2 周前
此工具无需参数。
详细介绍
@codespar/mcp-c6
已弃用:没有可用的端点。 2026-09-27 使用两个公共 DNS 解析器(8.8.8.8 和 1.1.1.1)进行测量:
baas.c6bank.com.br(生产环境)和baas-sandbox.c6bank.com.br(沙盒环境)均无法通过 DNS 解析。C6 的开发者门户现在记录了baas-api.c6bank.info(生产环境)和baas-api-sandbox.c6bank.info(沙盒环境),两者都需要 mTLS;此服务的路径和身份验证并非针对它们编写,也未经检查。此服务中的工具均无法连接到服务。该软件包已在 npm 上弃用,仅保留在此代码库中供参考。如果你有可用的端点,可通过C6_BASE_URL将服务指向该端点。若要恢复此软件包,请在 mcp-dev-latam 中提交 issue,并附上提供方文档记录的基础 URL。
面向 C6 Bank 的 MCP 服务——巴西顶尖数字银行之一,获得 JPMorgan 支持。
按零售账户数量计算,C6 位列巴西最大的数字银行之列,并已积极拓展中小企业和企业银行业务。商户可直接集成 Pix、boleto 和账户数据工作流。
状态:alpha(0.1.0-alpha.1)
C6 的开发者门户受合同限制——Pix、Cobrança 和账户 API 的完整 OpenAPI 规范仅对已完成接入的商户开放。此服务中的端点路径是根据 (a) BACEN Pix v2 标准、(b) C6 的公开营销页面,以及 (c) Itaú / Santander / Bradesco 通用约定做出的最佳猜测。每个未经验证的路径都在源代码中标记为 TODO(verify)。
在 0.1.x 期间请固定到精确版本;待已完成接入的商户验证后,将根据门户规范修正路径。
工具(14 个)
| 工具 | 用途 |
|---|---|
get_oauth_token | 为 C6 开发者门户创建或返回缓存的 OAuth2 client_credentials bearer 令牌。 |
create_pix_cob | 创建即时 Pix 收款(cob),并生成二维码。 |
get_pix_cob | 根据 txid 获取即时 Pix 收款(cob)。 |
list_pix_cob | 列出商户在指定日期范围内登记的即时 Pix 收款(cob)。 |
create_pix_cobv | 创建带到期日的 Pix 收款(cobv)——用于类似 boleto 的 Pix,付款人可在到期日或之后支付…… |
get_pix_cobv | 根据 txid 获取带到期日的 Pix 收款(cobv)。 |
resolve_dict_key | 将 DICT 密钥(CPF、CNPJ、email、phone、EVP)解析为所有者账户数据,以便发送 Pix。 |
register_pix_key | 在商户所有的 C6 账户上登记 DICT 密钥(CPF、CNPJ、email、phone 或 EVP)。 |
delete_pix_key | 删除商户所有的 DICT 密钥。 |
create_boleto | 通过 C6 Cobrança 签发 boleto。 |
get_boleto | 根据 C6 标识符(id 或 nosso_numero)获取 boleto。 |
cancel_boleto | 在付款前取消(baixa)未结清的 boleto。 |
get_account_balance | 获取商户账户的当前余额快照。 |
get_statement | 获取指定期间的账户流水交易记录。 |
安装
npm install @codespar/[email protected]
环境变量
C6_CLIENT_ID="..." # OAuth client_id from C6's Developer Portal
C6_CLIENT_SECRET="..." # OAuth client_secret
C6_CERT_PATH="/abs/path/to/client.crt" # mTLS client certificate
C6_KEY_PATH="/abs/path/to/client.key" # mTLS private key
C6_ENV="sandbox" # or "production" (default: sandbox)
身份验证
每次调用都必须同时满足以下两个条件:
- OAuth2
client_credentials——服务调用令牌端点,在令牌过期前约 60 秒将其缓存,并在下游调用中附加Authorization: Bearer <token>。 - mTLS——BACEN 要求 Pix v2 使用双向 TLS,C6 也在所有产品系列中强制执行此要求。服务从你设置的路径加载客户端证书和私钥,构建 Node
https.Agent,并通过该代理路由每个请求。
商户合同签署后,可从 C6 开发者门户获取证书和密钥包。
运行
# stdio (default)
npx @codespar/mcp-c6
注意事项
- 路径尚未验证。 请查看
src/index.ts中的TODO(verify)标记。已完成接入的商户应根据门户提供的 OpenAPI 规范进行验证,并提交 PR。 - 沙盒主机名是猜测的。 C6 会为每个商户提供一个沙盒子域名;如果你获得的沙盒 URL 不同,请编辑
BASE_URL进行覆盖。
企业版
需要为 Agent 付款提供治理、预算限制和审计记录?CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。