mcp-dock

@codespar/mcp-dock

已弃用：没有可用的实时端点。 2026-09-27 在两个公共 DNS 解析器（8.8.8.8 和 1.1.1.1）上进行测量后发现：api.dock.tech（生产环境）和 sandbox.api.dock.tech（沙盒环境）无法通过 DNS 解析。此服务中的工具均无法连接到任何服务。该软件包已在 npm 上弃用，仅保留在此代码库中供参考。如果你有可用的端点，请通过 DOCK_BASE_URL 将服务指向该端点。若要恢复此软件包，请在 mcp-dev-latam 中提交问题，并附上提供商记录的基础 URL。

面向 Dock 的 MCP 服务——为金融科技公司和嵌入式金融产品提供巴西银行即服务（账户、Pix、发卡）服务

为什么选择 Dock

Dock 是巴西两大主流 BaaS 提供商之一。它与 Matera 一起为大多数巴西金融科技公司提供支持。

Matera 与 Dock——二选一，商务模式相同：

	Matera	Dock
核心优势	专注 Pix 的核心银行业务	更全面的 BaaS：账户 + Pix + 发卡
历史根基	核心银行平台	从发卡平台拓展至账户 + Pix
典型客户	基于 Pix 构建产品的金融科技公司	发行品牌卡 + 账户的金融科技公司 / 零售商
Pix Automático	已上线（BCB 于 2025 年推出的产品）	路线图

巴西金融科技公司通常会根据合同条款和价格选择其中一家。构建金融科技产品的 Agent 可以同时支持两者——商务模式完全相同，变化的只有供应商关系。 此服务以与 @codespar/mcp-matera 相同的形式提供 Dock 的功能，因此 Agent 可以切换后端，而无需重写工具调用逻辑。

当 Agent 需要执行以下操作时，可使用 Dock：

• 为最终用户（CPF 持有人）创建数字账户
• 通过 Pix 转账（收款、转账、DICT、退款）
• 使用这些账户发卡（借记卡 / 信用卡 / 预付卡 / 虚拟卡）——这是 Dock 的主要差异化优势

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "dock": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-dock"],
      "env": {
        "DOCK_CLIENT_ID": "your-client-id",
        "DOCK_CLIENT_SECRET": "your-client-secret",
        "DOCK_ENV": "sandbox"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "dock": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-dock"],
      "env": {
        "DOCK_CLIENT_ID": "your-client-id",
        "DOCK_CLIENT_SECRET": "your-client-secret",
        "DOCK_ENV": "sandbox"
      }
    }
  }
}

工具（20 个）

工具	用途
create_account	在 Dock 为最终用户（CPF 持有人）创建数字账户。
get_account	根据 ID 获取 Dock 账户。
send_pix	从 Dock 账户向巴西境内任意 Pix 密钥发起 Pix 转账。
get_pix	根据 endToEndId 获取一笔已发起的 Pix 付款。
create_pix_qr_static	创建静态 Pix 二维码（可重复使用，关联商户 Pix 密钥）。
create_pix_qr_dynamic	创建动态 Pix 二维码（单次使用，会过期）。
refund_pix	退还一笔 Pix 付款（devolução）。
resolve_dict_key	解析 Pix DICT 密钥，获取账户持有人的身份信息及 ISPB / 分行 / 账户信息。
issue_card	使用 Dock 账户发行卡片（借记卡 / 信用卡 / 预付卡 / 虚拟卡）。
get_card	根据 ID 获取卡片。
list_accounts	列出商户名下的 Dock 账户。
freeze_account	冻结（封锁）Dock 账户。
unfreeze_account	解冻之前冻结的 Dock 账户，恢复 Pix 和卡片操作。
block_card	临时封锁卡片（可撤销）。
unblock_card	解除之前封锁的卡片（可撤销）。
change_card_status	更改卡片生命周期状态：ACTIVE / BLOCKED / CANCELED。
list_transactions	列出 Dock 账户上的交易（Pix 转入 / 转出、卡片授权、费用、转账）。
get_transaction	根据 ID 获取单笔交易。
create_webhook	注册 webhook 端点，以接收 Dock 事件通知（account.、pix.、card.、transaction.）。
list_webhooks	列出为商户注册的所有 webhook 端点。

身份验证

OAuth 2.0 客户端凭据。服务会使用 Basic 身份验证（client_id:client_secret）调用 POST /oauth/token，并在内存中缓存 bearer 令牌，直到过期前一分钟。

环境变量

变量	必填	说明
DOCK_CLIENT_ID	是	Dock 签发的 OAuth2 client_id
DOCK_CLIENT_SECRET	是	OAuth2 client_secret（密钥）
DOCK_ENV	否	sandbox（默认）或 production

基础 URL 根据 DOCK_ENV 确定：https://sandbox.api.dock.tech（sandbox）或 https://api.dock.tech（production）。

状态

v0.1.0-alpha.1 — 工具接口稳定，但请求路径尚未验证。

Dock 的开发者门户 developers.dock.tech 会重定向到 ReadMe.com 登录页面。没有 Dock 商户合同就无法访问公开文档，因此截至 2026-04-21，我们无法验证确切的 URL 路径。

src/index.ts 中的端点路径遵循巴西 BaaS 标准惯例（与 Matera 的结构和 BCB Pix 规范相符），目前是根据现有信息做出的最佳猜测。已知的可疑项会通过内联的 TODO(verify) 注释标出：

区域	代码中的值	可疑原因
令牌端点	POST /oauth/token	标准候选项，但 /oauth2/token 或 /auth/v1/token 也很常见
Pix 退款	POST /pix/payments/{e2eid}/refund	BCB 规范中的退款路径为 /pix/{e2eid}/devolucao/{id}
DICT 查询	GET /pix/dict/{key}	BCB DICT 需通过 RSFN 访问；Dock 的封装路径尚未验证

上述 10 个工具的名称和输入架构属于公开契约，将保持稳定。只有在通过 sandbox 验证后，src/index.ts 中的内部 HTTP 调用才会调整。目前将此服务用于真实的 Dock 租户，许多调用可能会返回 404。

欢迎任何拥有 Dock sandbox 的人提交 PR。

路线图

v0.2（计划中）

• 验证 Dock sandbox 中的路径
• 卡片控制：block_card、unblock_card、set_card_limits
• 账户对账单和交易列表
• Webhook 事件辅助工具

v0.3（计划中）

• Boleto 开具
• TED / 银行转账（非 Pix 通道）
• 信贷审批端点（Dock 的信贷系统）

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

链接

• Dock
• Dock Developers（受限访问——需要商户登录）
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 发起的银行转账和卡片开具提供治理、预算限制和审计追踪？CodeSpar Enterprise 在这些 MCP 服务的基础上，增加了策略引擎、支付路由和合规模板。

许可证

MIT