mcp-efi

@codespar/mcp-efi

面向 EFI（Gerencianet） 的 MCP 服务 — Pix 收款、boleto、信用卡和 carnets

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "efi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-efi"],
      "env": {
        "EFI_CLIENT_ID": "your-client-id",
        "EFI_CLIENT_SECRET": "your-client-secret",
        "EFI_SANDBOX": "true"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "efi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-efi"],
      "env": {
        "EFI_CLIENT_ID": "your-client-id",
        "EFI_CLIENT_SECRET": "your-client-secret",
        "EFI_SANDBOX": "true"
      }
    }
  }
}

工具（18 个）

工具	用途
create_cob	创建即时 Pix 收款（cobranca imediata）
get_cob	根据 txid 获取 Pix 收款详情
list_cobs	按日期范围列出 Pix 收款
create_charge	创建收款（boleto 或信用卡）
get_charge	根据 ID 获取收款详情
create_carnet	创建 carnet（包含多期付款的付款簿）
get_pix_key	获取已注册的 Pix 密钥详情
create_pix_evp	创建随机 Pix 密钥（EVP/别名）
create_cobv	创建到期 Pix 收款（cobranca com vencimento）。
get_cobv	根据 txid 获取到期 Pix 收款（cobv）详情
update_cobv	根据 txid 更新现有的到期 Pix 收款（cobv）
create_devolucao	对收到的 Pix 交易申请 Pix 退款（devolucao）
get_devolucao	根据 e2eId 和退款 ID 获取 Pix 退款详情
list_pix_received	按日期范围列出收到的 Pix 交易（recebidos）
delete_pix_key	删除已注册的 Pix 密钥（DICT）
register_webhook	为指定 Pix 密钥注册 webhook URL
list_webhooks	按日期范围列出已注册的 webhook
delete_webhook	删除为 Pix 密钥注册的 webhook

身份验证

EFI 使用 OAuth2 客户端凭据。服务会自动管理令牌刷新。

沙盒 / 测试

EFI 提供沙盒 pix-h.api.efipay.com.br。设置 EFI_SANDBOX=true 即可使用。

获取凭据

1. 前往 EFI Pay Dashboard
2. 创建账户
3. 注册应用以获取 OAuth2 凭据
4. 设置环境变量

环境变量

变量	必填	描述
EFI_CLIENT_ID	是	OAuth2 客户端 ID
EFI_CLIENT_SECRET	是	OAuth2 客户端密钥
EFI_SANDBOX	否	设置为 "true" 以使用沙盒模式

路线图

v0.2（计划中）

• create_devolucao — 创建 Pix 退款（devolucao）
• get_devolucao — 获取 Pix 退款详情
• list_locations — 列出 Pix 载荷位置
• create_webhook — 注册用于 Pix 通知的 webhook
• update_cob — 更新现有的 Pix 收款

v0.3（计划中）

• batch_charges — 在单个请求中创建多笔收款
• split_payments — 配置拆分付款规则

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

链接

• EFI Pay 网站
• Gerencianet API 文档
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上添加策略引擎、付款路由和合规模板。

许可证

MIT