mcp-pluggy

@codespar/mcp-pluggy

Pluggy 的 MCP 服务——巴西开放金融聚合器（ITP/TPP）。Pluggy 持有 ICP-Brasil 证书，并与巴西各家银行运行动态客户端注册，因此你只需对接一个 API，而不是 N 个。

快速开始

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "pluggy": {
      "command": "npx",
      "args": ["@codespar/mcp-pluggy"],
      "env": {
        "PLUGGY_CLIENT_ID": "your-client-id",
        "PLUGGY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Cursor / VS Code

在 .cursor/mcp.json 或 VS Code 的 MCP 集成中使用相同的配置。

工具（16 个）

连接器 + 类别

工具	Pluggy 端点	说明
list_connectors	GET /connectors	按名称 / 类型 / 国家 / 沙盒筛选
get_connector	GET /connectors/{id}	单个连接器定义
list_categories	GET /categories	交易分类体系

连接令牌

工具	Pluggy 端点	说明
create_connect_token	POST /connect_token	在客户端嵌入 Pluggy Connect 小组件

项目（银行连接）

工具	Pluggy 端点	说明
create_item	POST /items	使用凭据创建新的银行连接
list_items	GET /items	列出现有连接
get_item	GET /items/{id}	单个连接
update_item	PATCH /items/{id}	刷新凭据 / 触发同步
delete_item	DELETE /items/{id}	撤销连接

账户 + 交易 + 身份信息

工具	Pluggy 端点	说明
list_accounts	GET /accounts?itemId=...	支票 / 储蓄 / 信用 / 投资
get_account	GET /accounts/{id}	单个账户
list_transactions	GET /transactions?accountId=...	按日期范围筛选
get_transaction	GET /transactions/{id}	单笔交易
list_identities	GET /identity?itemId=...	法定姓名 + 证件 + 地址

支付（PISP）

工具	Pluggy 端点	说明
create_payment_intent	POST /payments/intents	发起 Pluggy Payments 支付意向
get_payment_intent	GET /payments/intents/{id}	轮询状态

身份验证

Pluggy 使用 OAuth2 客户端凭据流程：

1. 客户端通过 POST /auth 携带 clientId + clientSecret 获取 API 密钥
2. 后续请求在 X-API-KEY 中携带 API 密钥

在 Pluggy 控制台申请凭据：

• 生产环境：https://dashboard.pluggy.ai
• 文档：https://docs.pluggy.ai

沙盒 / 测试

Pluggy 提供带有合成账户和交易的沙盒连接器。沙盒使用相同的 API 端点（https://api.pluggy.ai）；/connectors 返回的连接器列表包含沙盒银行（Pluggy Bank、BR · Pluggy Bank）。

环境变量

变量	必需	描述
PLUGGY_CLIENT_ID	是	来自 Pluggy 控制台的客户端 ID
PLUGGY_CLIENT_SECRET	是	来自 Pluggy 控制台的客户端密钥
PLUGGY_API_BASE	否	覆盖 API 基础地址（默认 https://api.pluggy.ai）

为什么通过 CodeSpar 使用 Pluggy

如果你只需要 MCP 服务，可直接安装此软件包。如果你正在构建需要 Pluggy + Pix + NF-e + WhatsApp + 控制台治理功能的商业 Agent，请了解托管版。

企业版

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

许可证

MIT