关于 BankSync
BankSync 是面向 AI Agent 的远程 MCP 服务,可查询银行账户、交易、余额、投资和贷款数据。它还支持将数据同步到 Notion、Google Sheets 和 Airtable,并提供自动化数据流工具。
主要功能
- 01查询账户、交易与余额
- 02查看投资持仓和贷款
- 03连接并管理银行账户
- 04创建并运行数据同步流
- 05支持 Notion、Google Sheets 和 Airtable
适用场景
- 01汇总多个账户的余额
- 02分析上月支出和投资表现
- 03将交易数据定期同步到表格
- 04查看未偿贷款余额
MCP 相关
BankSync 通过 Streamable HTTP 提供远程 MCP 服务,也可用 npm 或 Python 包作为 stdio 本地桥接。它向客户端开放银行连接、财务数据查询及同步管理工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.banksync.ioclaude mcp add --transport http io-banksync https://mcp.banksync.io{"mcpServers":{"io-banksync":{"type":"http","url":"https://mcp.banksync.io"}}}在 Cursor 中打开{"servers":{"io-banksync":{"type":"http","url":"https://mcp.banksync.io"}}}在 VS Code 中打开{"mcpServers":{"io-banksync":{"type":"http","url":"https://mcp.banksync.io"}}}{"mcpServers":{"io-banksync":{"serverUrl":"https://mcp.banksync.io"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
BankSync MCP 服务
与您的银行数据对话。将 AI Agent 连接到真实银行账户,管理涵盖 15,000 多家金融机构的交易、余额、投资和贷款。
BankSync MCP 是一个开源的 Model Context Protocol 服务,提供 28 个工具,让 Claude、ChatGPT、Cursor、VS Code 和其他 AI Agent 能够安全地读写您的财务数据。通过对话即可将数据同步到 Notion、Google Sheets 和 Airtable。
快速开始
在 banksync.io/developers 获取 API 密钥。BankSync 以远程 MCP 服务的形式运行,无需安装:
URL: https://mcp.banksync.io
Transport: Streamable HTTP
Header: X-API-Key: your-key
配置
Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"banksync": {
"type": "http",
"url": "https://mcp.banksync.io",
"headers": {
"X-API-Key": "your-key"
}
}
}
}
Claude Code
claude mcp add --transport http banksync https://mcp.banksync.io \
--header "X-API-Key: your-key"
Cursor
添加到 .cursor/mcp.json:
{
"mcpServers": {
"banksync": {
"url": "https://mcp.banksync.io",
"headers": {
"X-API-Key": "your-key"
}
}
}
}
VS Code (Copilot)
添加到 .vscode/mcp.json:
{
"servers": {
"banksync": {
"type": "http",
"url": "https://mcp.banksync.io",
"headers": {
"X-API-Key": "your-key"
}
}
}
}
Windsurf
添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"banksync": {
"serverUrl": "https://mcp.banksync.io",
"headers": {
"X-API-Key": "your-key"
}
}
}
}
npm 包(stdio 回退方案)
对于不支持远程 HTTP 服务的客户端,可使用 npm 包作为本地桥接:
npx -y @banksync/mcp # Node.js
pip install banksync-mcp && banksync-mcp # Python
将 BANKSYNC_API_KEY=your-key 设置为环境变量。该包会自动将 stdio 桥接到 https://mcp.banksync.io。
配置示例(适用于任何 stdio 客户端):
{
"mcpServers": {
"banksync": {
"command": "npx",
"args": ["-y", "@banksync/mcp"],
"env": {
"BANKSYNC_API_KEY": "your-key"
}
}
}
}
所有客户端的配置指南:banksync.io/developers/mcp-setup
您可以做什么
向您的 AI Agent 提出如下问题:
- “上个月我最大的几笔支出是什么?”
- “我所有账户里的余额总共有多少?”
- “显示我的投资组合表现”
- “每周将我的交易同步到 Notion”
- “我的未偿还贷款余额是多少?”
工具
28 个工具,分为 7 个类别。完整参考(含参数和示例):docs/TOOLS.md
| 类别 | 工具 | 功能 |
|---|---|---|
| 发现 | get_data_type_schema, list_feed_sources | 发现可用字段和数据源类型 |
| 工作区 | list_workspaces, get_workspace, list_integrations, delete_integration | 管理工作区和已连接的目标 |
| 银行 | list_banks, get_bank, create_bank_link, connect_bank, delete_bank | 连接和管理银行连接 |
| 账户 | list_accounts, get_account | 从金融机构获取实时账户数据 |
| 金融数据 | get_transactions, get_balance, get_holdings, get_trades, get_loan | 查询交易、余额、投资和贷款 |
| 数据流 | list_feeds, get_feed, create_feed, update_feed, validate_feed, delete_feed | 构建自动化数据管道 |
| 作业 | list_jobs, get_job, trigger_sync, cancel_job | 运行和监控同步作业 |
工作原理
AI Agent (Claude, ChatGPT, Cursor, ...)
↓ Streamable HTTP
mcp.banksync.io (Cloudflare Workers)
↓ Bank APIs
Plaid (US/UK/CA) · Basiq (AU/NZ)
↓ Sync
Notion · Google Sheets · Airtable
详情请参阅 docs/ARCHITECTURE.md。
典型工作流
1. list_workspaces → find your workspace
2. list_banks → see connected banks
3. list_accounts → discover accounts
4. get_transactions → fetch financial data
5. list_integrations → find your Notion/Sheets connection
6. get_data_type_schema → discover available field mappings
7. create_feed → set up an automated pipeline
8. trigger_sync → run it
数据源
| 提供商 | 覆盖范围 | 数据类型 |
|---|---|---|
| Plaid | 美国、英国、加拿大 — 12,000 多家机构 | 交易、余额、投资、贷款 |
| Basiq | 澳大利亚、新西兰 — 3,000 多家机构 | 交易、余额 |
| 电子邮件提取 | 全球 | 从转发的电子邮件中提取的 AI 结构化数据 |
| 文件上传 | 全球 | 从 PDF、图像、文档中提取的 AI 数据 |
同步目标
| 目标 | 功能 |
|---|---|
| Notion | 同步到 Notion 数据库 |
| Google Sheets | 同步到电子表格(按行或按列) |
| Airtable | 同步到 Airtable 表格 |
安全
- API 密钥身份验证 — 密钥按工作区划分
- 所有数据在传输过程中均加密(TLS)
- 基于角色的权限(所有者/管理员/编辑者/查看者)
- BankSync 从不存储银行凭据 — 由 Plaid/Basiq 处理委托认证
- 无状态 MCP 传输 — 不会持久化会话数据
请参阅 SECURITY.md,了解我们的安全政策和漏洞报告方式。
调试
使用 MCP Inspector 测试和调试服务:
BANKSYNC_API_KEY=your-key npx @modelcontextprotocol/inspector npx -y @banksync/mcp
也可以将 Inspector 直接连接到远程服务:
npx @modelcontextprotocol/inspector --url https://mcp.banksync.io --header "X-API-Key: your-key"
文档
| 文档 | 说明 |
|---|---|
| docs/TOOLS.md | 完整的工具参考,包含参数和示例 |
| docs/ARCHITECTURE.md | 架构、传输和部署详情 |
| docs/AGENTS.md | AI Agent 指南:最佳实践、提示词模式和工作流 |
| CLAUDE.md | 为在此代码库中工作的 AI 编码助手提供的上下文 |
| SECURITY.md | 安全政策和漏洞报告方式 |
| banksync.io/developers | 完整 API 文档 |
| banksync.io/developers/mcp-setup | 各客户端的设置指南 |
隐私政策
BankSync 的隐私政策可在 banksync.io/privacy 查阅。BankSync 从不存储银行凭据 — 身份验证委托给 Plaid 和 Basiq 处理。API 密钥按工作区划分,所有数据在传输过程中均加密。
许可证
MIT — 详见 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。