pluggy-mcp

一个远程 Model Context Protocol 服务器，封装了 Pluggy API 的数据产品接口，部署在 Cloudflare Workers 上。

使用 Cloudflare Agents（McpAgent）构建，采用 Streamable HTTP 传输。

工具

在 Pluggy 的数据产品中暴露了 25 个工具：

支付、webhooks 和 Smart Transfers 不在范围内。

Related MCP server: Copiloto Financeiro MCP Server

身份验证

MCP 客户端在每个请求中使用 Bearer 令牌进行身份验证：

Authorization: Bearer <base64(clientId:clientSecret)>

生成令牌：

printf '%s:%s' "$PLUGGY_CLIENT_ID" "$PLUGGY_CLIENT_SECRET" | base64

Worker 解码令牌，通过 POST /auth 生成一个短期有效的 Pluggy API 密钥（2 小时 TTL，在过期前 5 分钟刷新），并在所有 Pluggy API 调用中将其作为 X-API-KEY 发送。Pluggy 凭据永远不会到达 MCP 客户端。

开发

npm install
npm run dev   # wrangler dev on http://127.0.0.1:8787

部署

npx wrangler deploy

连接

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "pluggy": {
      "url": "https://<your-worker>.<your-subdomain>.workers.dev/mcp",
      "headers": { "Authorization": "Bearer <base64(clientId:clientSecret)>" }
    }
  }
}

Claude Desktop / Windsurf

结构相同，只是配置文件不同（claude_desktop_config.json / ~/.codeium/windsurf/mcp_config.json）。

备注

• list_items 是 Pluggy 的可选功能。在 Pluggy 支持团队为你的团队启用之前，它会返回 403 LIST_ITEMS_FEATURE_NOT_ENABLED。

• list_transactions 使用基于游标的 GET /v2/transactions 端点。将上一个响应的 next 值中的 after 游标传入以进行分页。

• Durable Object 在会话生命周期内持久保存会话和生成的 API 密钥；凭据通过 Worker fetch 处理器按请求传入 ctx.props。