mcp-stone

@codespar/mcp-stone

Stone 的 MCP 服务 — 收单（银行卡 / Pix / boleto）、预支、应收款、终端和开放银行

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "stone": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stone"],
      "env": {
        "STONE_CLIENT_ID": "your-client-id",
        "STONE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

claude mcp add stone -- npx @codespar/mcp-stone

Cursor / VS Code

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

{
  "servers": {
    "stone": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stone"],
      "env": {
        "STONE_CLIENT_ID": "your-client-id",
        "STONE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

工具（21 个）

工具	用途
get_balance	获取账户余额
list_transactions	列出账户交易
get_statement	获取指定时段的账户对账单
create_payment	通过 Stone 创建付款
get_payment	根据 ID 获取付款详情
list_payments	列出付款，可选筛选条件
create_transfer	创建银行转账（内部或外部）
create_pix_payment	通过 Stone 创建 Pix 付款（转出）
create_pix_charge	创建 Pix 收款请求（二维码 / cob）以收取款项
create_boleto	创建 boleto bancário 以向客户收款
create_card_charge	对信用卡或借记卡收款（Stone 收单）
tokenize_card	将银行卡令牌化为符合 PCI 标准的令牌，以便后续收款
refund_transaction	退还已结算的交易（全额或部分）
cancel_transaction	取消已授权但尚未扣款的交易
create_anticipation	预支未来应收款（Stone 的旗舰服务“antecipação”）
get_anticipation_limits	获取商户当前的预支限额（最高 / 最低 / 可用额度）
list_receivables	搜索应收款（银行卡交易产生的未来入账款项）
list_terminals	列出商户的 Stone / TON 实体终端
get_terminal_status	获取特定 POS 终端的当前状态（在线 / 离线 / 上次在线时间）
register_webhook	为 Stone 事件注册 Webhook 端点
list_webhooks	列出已注册的 Webhook 端点

身份验证

Stone 使用 OAuth2 客户端凭据进行身份验证。服务会自动管理令牌刷新。

沙盒 / 测试

Stone 通过开发者门户提供沙盒。

获取凭据

1. 前往 Stone 开放银行文档
2. 注册成为开发者
3. 创建应用以获取 OAuth2 凭据
4. 设置环境变量

环境变量

变量	必需	描述
STONE_CLIENT_ID	是	OAuth2 客户端 ID
STONE_CLIENT_SECRET	是	OAuth2 客户端密钥
STONE_BASE_URL	否	覆盖基础 URL（默认值为 https://api.openbank.stone.com.br/api/v1；沙盒地址为 https://sandbox-api.openbank.stone.com.br/api/v1）
STONE_AUTH_URL	否	覆盖 OAuth2 令牌 URL（默认值为 https://accounts.openbank.stone.com.br/auth/realms/stone_bank/protocol/openid-connect/token；沙盒地址为 https://sandbox-accounts.openbank.stone.com.br/auth/realms/stone_bank/protocol/openid-connect/token）。在 0.2.2 及更早版本中，令牌请求会发送到不存在的 login.openbank.stone.com.br，因此所有工具都会在身份验证时失败。

路线图

v0.3（计划中）

• list_pix_keys — 列出商户已注册的 Pix 密钥
• create_recipient — 市场 / 分账收款方
• create_transfer_batch — 批量处理转账
• get_boleto — 获取 boleto 详情
• create_scheduled_payment — 安排未来日期的付款
• list_payouts — 列出预支 / 结算付款

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

链接

• Stone 网站
• Stone Open Bank 文档
• MCP Dev LATAM
• 落地页

企业版

需要对 Agent 付款进行治理、设置预算限额并保留审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、付款路由和合规模板。

许可证

MIT