关于 Switchbooks
Switchbooks 是用于通过 Cursor、Grok Bot 等客户端访问企业记账数据的 MCP 服务。它支持只读查询,也可在单独授权后执行可撤销的记账更改。
主要功能
- 01查看损益表、资产负债表和现金流
- 02搜索交易并查看账户
- 03查看类别、收款方和规则
- 04选择当前公司
- 05授权可撤销的记账更改
适用场景
- 01查看公司的月度损益
- 02查找某一时段内付给特定收款方的交易
- 03检查账户和类别
- 04获准后过账或编辑记账分录
MCP 相关
托管的 MCP 服务使用 Streamable HTTP 和 OAuth,并支持动态客户端注册与 PKCE。客户端可访问只读会计数据,也可通过 Switchbooks 授权申请写入权限。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://app.switchbooks.ai/api/mcpclaude mcp add --transport http ai-switchbooks-switchbooks https://app.switchbooks.ai/api/mcp{"mcpServers":{"ai-switchbooks-switchbooks":{"type":"http","url":"https://app.switchbooks.ai/api/mcp"}}}在 Cursor 中打开{"servers":{"ai-switchbooks-switchbooks":{"type":"http","url":"https://app.switchbooks.ai/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"ai-switchbooks-switchbooks":{"type":"http","url":"https://app.switchbooks.ai/api/mcp"}}}{"mcpServers":{"ai-switchbooks-switchbooks":{"serverUrl":"https://app.switchbooks.ai/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Switchbooks
将 Cursor、Grok Bot 和 Grok Build 连接到你的 Switchbooks 会计数据。询问报表、搜索交易,并查看账户、类别、收款方和规则。
在 Switchbooks 授权页面选择只读访问权限,或授权可撤销的簿记更改。只读访问权限涵盖报表、交易、账户、类别、收款方及其他会计信息。选择活跃公司只会更改连接所选的公司。
连接
你需要拥有一个 Switchbooks 账户,并且至少可以访问一家公司的数据。公司的会计工具需要有效的试用或订阅;授权或断开连接则不需要。
- 安装插件后,打开其连接设置。在 Grok Bot 中,前往 Marketplace → Your plugins 查找已安装的插件。
- 启用 Switchbooks 连接,并按提示完成浏览器登录。
- 查看 Switchbooks 授权页面。若要保持只读连接,请在选择 Allow access 前取消勾选 Let it make changes to the books。只有在要授权簿记更改时才保留勾选,然后选择 Allow access and changes。
- 请助手列出你的 Switchbooks 公司,并选择要使用的公司。
托管服务地址为 https://app.switchbooks.ai/api/mcp。它使用 Streamable HTTP、OAuth、动态客户端注册和 PKCE。无需 API 密钥、共享密钥或本地服务。
授权复选框初始状态取决于客户端请求的权限范围,因此每次连接时都请检查。只读访问使用 switchbooks.read;允许更改还会授予 switchbooks.write。现有的只读连接会一直保持只读,除非你重新连接并授权更改。
获得写入权限后,连接器可以执行 Switchbooks 可撤销的更改,例如过账或拆分交易、匹配转账、创建或编辑日记账分录、更改类别、收款方或规则,以及完成预览过的对账。任何连接都无法连接或同步银行账户、发送电子邮件或邀请、分享报表、导入文件、合并银行账户、删除文件或移除团队成员。
试用
- “列出我的 Switchbooks 公司。”
- “使用[公司名称],并显示上个月的损益表。”
- “查找上季度支付给[收款方]的交易。”
- “显示这家公司的账户和类别。”
连接器提供 list_companies 和 set_company。其他工具会使用当前选定的公司。只有一家可访问公司的账户会自动选中该公司;拥有多家公司的账户必须选择一家。每次调用工具时都会检查访问权限。
断开连接
在 Switchbooks 中,打开 Settings → MCP → Connected apps,找到该连接并选择 Disconnect。这会立即撤销其访问令牌和刷新令牌。之后你可以重新授权访问以恢复连接。
Cursor 本地设置
要在通过市场安装前测试托管连接器,请将此软件包的 mcp.json 中的 mcpServers.switchbooks 条目合并到项目的 .cursor/mcp.json 或用户的 ~/.cursor/mcp.json 中。保留已有的服务条目,然后启用 Switchbooks 并通过 Cursor 登录。
请参阅 Cursor MCP 设置 和 Grok Bot 插件设置。在 Grok Build 中,使用 grok plugin install switchbooks 从市场安装;插件根目录下的 .mcp.json 指向同一个托管服务。
支持
请联系 [email protected]。
Switchbooks · 隐私政策 · 服务条款
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。