mcpField
M
mcp-bold-co

mcp-bold-co

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

关于 mcp-bold-co

mcp-bold-co 是哥伦比亚收单机构 Bold 的 MCP 服务，用于创建支付链接并查询其支付状态，支持银行卡、PSE、Nequi 与 Botón Bancolombia。同时提供结账签名与 Webhook 签名校验的本地工具。

主要功能

  1. 01创建固定或开放金额的支付链接
  2. 02按支付方式限定的链接创建
  3. 03查询支付链接状态
  4. 04查询商户可用的支付方式
  5. 05本地生成结账完整性签名
  6. 06本地校验 Webhook HMAC 签名

适用场景

  1. 01让 AI 助手为客户生成 PSE 或银行卡支付链接
  2. 02轮询支付链接直至显示已支付
  3. 03校验收到的 Bold Webhook 签名

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 7 个工具，其中包括远程 Bold 接口调用与两个本地签名工具。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-bold-co": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-bold-co"
      ],
      "env": {
        "BOLD_API_KEY": "<BOLD_API_KEY>",
        "BOLD_SECRET_KEY": "<BOLD_SECRET_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-bold-co
需要配置的环境变量
BOLD_API_KEY密钥Bold identity API key (llave de identidad), sent as x-api-key
BOLD_SECRET_KEY密钥Bold secret key. Only needed for the local checkout-signature and webhook-validation tools.

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

安装包
npm@codespar/mcp-bold-co0.1.0

工具

7

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

参数类型必填说明
currencystring否货币代码（默认值为 COP）
tip_amountnumber否金额中的小费部分（默认值为 0）
amount_typeenum否CLOSE 表示固定金额（默认值），OPEN 表示允许付款人输入金额CLOSE | OPEN
descriptionstring是付款人在结账页面上看到的内容
payer_emailstring否在结账页面预填付款人的电子邮件
callback_urlstring否付款后将付款人重定向到的 URL
total_amountnumber否COP 总金额（amount_type=CLOSE 时必填）
expiration_datenumber否链接过期时间，采用纳秒 Unix 时间戳（Bold 约定）。不设置则永不过期。
payment_methodsarray否限制可接受的支付方式，例如 ["CREDIT_CARD", "PSE", "NEQUI", "BOTON_BANCOLOMBIA"]。省略则接受商户已启用的所有支付方式。

详细介绍

@codespar/mcp-bold-co

Bold 的 MCP 服务——哥伦比亚收单机构（bold.co）：支持银行卡、PSE、Nequi 和 Botón Bancolombia 的支付链接，以及结账完整性签名和 Webhook 验证工具。

npm 许可证：MIT

Bold 的公开集成 API 以链接为先：创建支付链接（固定金额或开放金额），将 payload.url 提供给付款人，然后轮询链接，直到状态显示为 PAID。嵌入式结账按钮流程使用 SHA-256 完整性签名进行保护，Webhook 则使用 HMAC 签名——这里提供了这两种本地工具。

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "bold-co": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-bold-co"],
      "env": {
        "BOLD_API_KEY": "your-identity-key",
        "BOLD_SECRET_KEY": "your-secret-key"
      }
    }
  }
}
Claude Code
claude mcp add bold-co --env BOLD_API_KEY=your-identity-key -- npx -y @codespar/mcp-bold-co

工具（7 个）

工具描述
create_payment_link创建支付链接（POST /online/link/v1）——支持银行卡、PSE、Nequi、Botón Bancolombia
create_pse_payment_link便捷工具：创建仅限 PSE 银行借记的链接
create_card_payment_link便捷工具：创建仅限银行卡的链接
get_payment_link查询链接状态：ACTIVE、PROCESSING、PAID、REJECTED、EXPIRED
list_payment_methods查询此商户启用的支付方式
generate_checkout_signature为嵌入式结账按钮生成 SHA-256 完整性哈希（本地）
validate_webhook_signature验证 Bold Webhook 上的 HMAC 签名（本地）

环境变量

变量必需描述
BOLD_API_KEY是身份密钥（llave de identidad），通过 Authorization: x-api-key 发送
BOLD_SECRET_KEY否密钥——仅用于本地签名和 Webhook 工具

Bold 没有单独的沙盒主机；测试模式由 Bold 控制面板中的测试密钥决定。

文档

企业版

需要为由 Agent 驱动的 Bold 支付提供治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、支付路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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