gl-importer-plugin 是 Synder Accounting 开发的一款 Claude Code 插件,旨在让用户在 Claude Code 环境中直接使用 Synder Importer API,将 CSV 或 XLSX 格式的会计数据导入到 QuickBooks Online 或 Xero。
主要能力
该插件捆绑了一个 MCP 服务器,该服务器包装了 Synder Importer REST API(/api/v1),提供完整的读取和写入能力,共 19 个工具,涵盖以下类别:账户、公司、设置、实体、字段、映射、导入、状态轮询、结果、取消、回滚,以及两个复合的“快捷路径”工具。此外,插件还包含 gl-importer 智能体技能(skills/gl-importer/SKILL.md),为两步导入流程(试运行→确认)提供自然语言指导。
使用方式
安装要求
- Node.js 18 或更高版本
- 支持插件的 Claude Code(/plugin 命令可用)
- Synder Importer API 令牌,需在 shell 环境中设置为 IMPORTER_API_TOKEN。令牌可在 importer.synder.com 的 Account → API Keys 生成。
安装途径
- 从 Claude Code 市场安装(推荐):使用 /plugin 命令。
- Claude Desktop 一键 MCP 安装:从 Releases 下载最新的 .mcpb 包并双击,Claude Desktop 会提示输入 API 令牌。
- 从源码安装(开发用)。
与 Claude Code 交互
安装后,可以用自然语言向 Claude Code 发出指令,例如:
- “Import ~/Downloads/march-bills.csv as Bills into my QuickBooks company.”
- “What entities can I import into Xero?”
- “Show me the saved mapping called 'Stripe payouts' and update it to map Date → TxnDate.”
- “List my last 10 imports and tell me which ones failed.”
- “Revert import 12345 — I uploaded the wrong file.”
智能体技能会引导 Claude Code 执行安全的两步流程:先进行试运行,展示建议的字段映射;然后经确认后实际创建导入并轮询直到结束。
常用工具
MCP 服务器在启动时会输出完整的工具架构。最常被 LLM 使用的工具包括……(资料中未提供具体工具列表)。
适用场景
适用于需要将 CSV/XLSX 会计数据导入 QuickBooks Online 或 Xero 的财务或会计人员,借助 Claude Code 以自然语言方式完成数据导入、映射调整、状态查询和回滚操作。
限制
- 依赖 Node.js 18+ 和 Claude Code 插件支持。
- 需要有效的 Synder Importer API 令牌。
- 目前仅支持导入到 QuickBooks Online 或 Xero。
- 其他功能限制暂未提供。