摘要
Sage Business Cloud Accounting,南非版(前身为 Sage One):公司、客户、供应商、项目、税务发票、报价、供应商发票、科目表、银行交易、客户收款、账龄、损益表和资产负债表。使用你的 Sage 登录和 Sage 提供的 API 密钥进行登录。
引导式设置
2 分钟将 Sage Accounting 连接到 Meta Muse
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Sage Accounting,再把你的 MCP URL 添加到 Meta Muse。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Sage Accounting (South Africa) 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Sage Accounting (South Africa),粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Sage Accounting (South Africa) + Meta Muse
Sage Business Cloud Accounting,南非版(前身为 Sage One):公司、客户、供应商、项目、税务发票、报价、供应商发票、科目表、银行交易、客户收款、账龄、损益表和资产负债表。使用你的 Sage 登录和 Sage 提供的 API 密钥进行登录。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
SAGE_ZA_API_HOST, SAGE_ZA_USERNAME, SAGE_ZA_PASSWORD, SAGE_ZA_API_KEY
第一步 — 获取凭据
设置大约需要 2 个工作日。
- 在 https://accounting.sageone.co.za/marketing/developerprogram.aspx 上请求 API 密钥(请求你的 API 密钥)。Sage 每个应用程序发放一个密钥;它的格式类似于
39478ac6-ac2a-44d8-a31c-7e7e14af4de3。将其粘贴到SAGE_ZA_API_KEY中。 - 在
SAGE_ZA_API_HOST中选择你登录的站点:大多数账户使用 accounting.sageone.co.za,或者当你的登录页面是 resellers.accounting.sageone.co.za 时使用该地址。 - 在
SAGE_ZA_USERNAME和SAGE_ZA_PASSWORD中输入 Sage Accounting 用户的电子邮件地址和密码。API 使用与 Web 应用相同的 HTTP Basic 身份验证,因此建议使用仅具有助手所需访问权限的专用用户。被邀请的用户只能访问其角色允许的功能(其他调用会返回 405)。 - 可选:将助手工作的公司的 ID 放入
SAGE_ZA_COMPANY_ID中。使用sage_accounting_za_list_companies查找它。如果没有,需在每次调用时传递company_id。
从哪里开始:sage_accounting_za_list_companies 显示登录的公司及其 ID。其他所有工具都在一个公司内部工作(company_id,或连接器的默认值)。
客户、供应商、项目:sage_accounting_za_list_customers, sage_accounting_za_get_customer, sage_accounting_za_list_suppliers, sage_accounting_za_get_supplier, sage_accounting_za_list_items, sage_accounting_za_get_item。使用 sage_accounting_za_save_customer, sage_accounting_za_save_supplier 和 sage_accounting_za_save_item 创建或更改它们。
销售和采购文档:sage_accounting_za_list_tax_invoices 和 sage_accounting_za_get_tax_invoice(销售发票),sage_accounting_za_list_quotes 和 sage_accounting_za_get_quote,sage_accounting_za_list_supplier_invoices 和 sage_accounting_za_get_supplier_invoice。列表工具仅返回标题,除非 include_detail 为 true。使用 sage_accounting_za_save_quote 写入报价,使用 sage_accounting_za_save_tax_invoice 写入发票;首先使用 sage_accounting_za_calculate_quote 或 sage_accounting_za_calculate_tax_invoice 预览总额。一行在 SelectionId 中命名一个项目(LineType 0)或一个分类账户(LineType 1),并包含数量、单价和 TaxTypeId。如果保存的文档返回零总额,请按计算工具返回的方式精确传递行。
分类账和银行:sage_accounting_za_list_accounts, sage_accounting_za_list_account_categories 和 sage_accounting_za_list_tax_types 描述科目表;sage_accounting_za_save_account 添加或更改一个账户。sage_accounting_za_list_bank_accounts, sage_accounting_za_list_bank_transactions 和 sage_accounting_za_list_customer_receipts 为只读:此连接器不记录收据或付款,且从不移动资金。
报告:sage_accounting_za_get_customer_ageing 和 sage_accounting_za_get_supplier_ageing(谁欠多少钱,按账龄),sage_accounting_za_list_outstanding_customer_documents, sage_accounting_za_get_profit_and_loss, sage_accounting_za_get_balance_sheet 和 sage_accounting_za_get_account_balances(每个账户的变动,如试算表)。这些是仅读取的 POST 调用。
保存:没有 id 的保存会创建一个记录;有 id 时会替换该记录。Sage 按发送的方式存储记录,因此在更新中遗漏的字段可能会被重置:首先读取记录并传递必须保留的 extra_fields。新记录是活动的,除非 active 为 false。此连接器不会删除任何内容。
过滤和分页:列表工具接受 OData 的子集。filter 和 orderby 仅适用于数字、布尔值和日期,绝不适用于文本(通过读取列表搜索名称)。日期文字写作 DateTime'2026-01-31';如果 Sage 拒绝该形式,请尝试单独使用引号中的日期。每个列表限制为 100 行:答案被包装为 TotalResults、ReturnedResults 和 Results;每次将 skip 增加 100,直到你拥有 TotalResults 行。
限制:每个公司每分钟 100 个请求,每个用户每天 5000 个请求。超过分钟限制会使 IP 地址被封锁一个小时(HTTP 429),因此保持每秒大约一次调用,并且不要在循环中重试。每小时 20 次失败的登录会使用户被封锁 24 小时:在 401 后,停止并检查凭据。
字段和格式:ID 为整数。日期格式为 YYYY-MM-DD。金额为公司货币的十进制数,除非客户或供应商有自己的货币(见 Customer_CurrencyId 和文档上的汇率)。Exclusive 是税前金额,Tax 是增值税,Total 是含税金额。错误:400 带有验证消息,402 表示 Sage 订阅已过期,404 表示记录不在该公司中,409 表示记录正在使用中。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 Muse 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors,选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面:登录并批准访问。
- 在聊天中,向 Muse 提出需要用到
Sage Accounting (South Africa)的工具的请求。
你也可以在聊天中完成设置,适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接,因此 localhost 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
sage_accounting_za_list_companies | 列出此 Sage 登录可以打开的公司:ID、名称、货币符号、税号、注册名称、国家 ID、活动状态、是否为所有者… |
sage_accounting_za_list_customers | 列出客户:ID、名称、类别、联系人姓名、电子邮件、电话、手机、税号、余额、信用额度、邮寄和送货地址… |
sage_accounting_za_get_customer | 读取一个客户的所有字段:名称、类别、联系人、税号、余额、信用额度、地址、默认税种、价格表… |
sage_accounting_za_list_suppliers | 列出供应商:ID、名称、类别、联系人姓名、电子邮件、电话、税号、余额、信用额度、地址行、活动状态和修改时间… |
sage_accounting_za_get_supplier | 读取一个供应商的所有字段:名称、类别、联系信息、税号、余额、地址、默认税种、货币和到期… |
sage_accounting_za_list_items | 列出项目(产品和服务):ID、代码、描述、类别、税前价格、含税价格、最后成本、单位、实物(库存项目… |
sage_accounting_za_get_item | 读取一个项目的所有字段:代码、描述、类别、销售价格、最后成本、单位、税种、报告组和用户定义… |
sage_accounting_za_list_tax_invoices | 列出税务发票(销售发票):ID、文档编号、日期、到期日、客户 ID、客户名称、参考、税前金额、税、总额… |
sage_accounting_za_get_tax_invoice | 读取一个税务发票及其行:文档编号、日期、客户、地址、折扣、税前金额、税、总额、到期金额和每行… |
sage_accounting_za_list_quotes | 列出报价:ID、文档编号、日期、到期日期、客户 ID、客户名称、参考、税前金额、税、总额和状态。只读,100… |
sage_accounting_za_get_quote | 读取一个报价及其行:文档编号、日期、到期日期、客户、折扣、总额、状态和每行的项目或账户… |
sage_accounting_za_list_supplier_invoices | 列出供应商发票(采购发票):ID、文档编号、日期、到期日、供应商 ID、供应商名称、参考、税前金额、税、总额… |
sage_accounting_za_get_supplier_invoice | 读取一个供应商发票及其行:文档编号、日期、供应商、参考、税前金额、税、总额、到期金额和每行的… |
sage_accounting_za_list_accounts | 列出分类账账户(不含系统账户的科目表):ID、名称、描述、类别(ID 和描述)、余额… |
sage_accounting_za_list_account_categories | 列出账户类别(销售、销售成本、费用、流动资产等):ID、描述和顺序。ID 是类别… |
sage_accounting_za_list_tax_types | 列出公司的税(增值税)类型:ID、名称、百分比、是否默认和活动状态。ID 是文档行、项目和… 的 TaxTypeId |
sage_accounting_za_list_bank_accounts | 列出银行和信用卡账户:ID、名称、银行名称、账户号码、分行号码、类别、余额、默认、货币 ID… |
sage_accounting_za_list_bank_transactions | 列出现金簿的银行交易:ID、银行账户 ID、日期、类型、收款人、描述、参考、文档编号、税前金额、税… |
sage_accounting_za_list_customer_receipts | 列出客户收款(已收款):ID、客户 ID、日期、文档编号、参考、描述、总额、折扣… |
sage_accounting_za_get_customer_ageing | 客户(债务人)账龄详细信息:按客户列出未付款文档,包含日期、文档编号、参考和每个文档的金额… |
sage_accounting_za_get_supplier_ageing | 供应商(债权人)账龄详细信息:按供应商列出未付款文档,包含日期、文档编号、参考和每个文档的金额… |
sage_accounting_za_list_outstanding_customer_documents | 列出一个客户的未付款文档(税务发票,且如果 include_paid_invoices 为真,则包括已付款文档):文档类型、编号、日期… |
sage_accounting_za_get_profit_and_loss | 指定日期范围内的损益表(收入报表):报告级别的树状结构(销售、销售成本、毛利润、费用、净利润)… |
sage_accounting_za_get_balance_sheet | 截至某一日期的资产负债表:报告级别的树状结构(资产、负债、股权),包含描述、账户编号、类别、子项… |
sage_accounting_za_get_account_balances | 指定日期范围内每个分类账账户的变动,如试算表:账户 ID、描述、类别 ID、类别描述、借方… |
sage_accounting_za_save_customer | 创建一个客户,或在给定 ID 时更新一个客户。返回保存的客户及其 ID。保存会替换整个记录:对于更新… |
sage_accounting_za_save_supplier | 创建一个供应商,或在给定 ID 时更新一个供应商。返回保存的供应商及其 ID。保存会替换整个记录:对于更新… |
sage_accounting_za_save_item | 创建一个项目(产品或服务),或在给定 ID 时更新一个项目。返回保存的项目及其 ID。保存会替换整个记录… |
sage_accounting_za_save_account | 创建一个分类账账户,或在给定 ID 时更新一个账户。返回保存的账户及其 ID。类别决定账户… |
sage_accounting_za_calculate_quote | 计算报价的总额而不保存:返回文档,包含税前金额、税、总额和每行的折扣及整体… |
sage_accounting_za_save_quote | 为客户创建一个报价,或在给定 ID 时更新一个报价。返回保存的报价及其 ID、文档编号和总额。检查… |
sage_accounting_za_calculate_tax_invoice | 计算税务发票的总额而不保存:返回文档,包含税前金额、税、总额和每行的折扣及整体… |
sage_accounting_za_save_tax_invoice | 为客户创建一个税务发票(销售发票),或在给定 ID 时更新一个发票。返回保存的发票及其 ID、文档编号… |
示例提示
- "哪些客户欠我们超过 60 天的钱?"
- "显示上一个财务季度的损益表。"
- "预览 Acme Trading 的税务发票:10 小时咨询费,每小时 R950,然后保存。"
- "列出十月份仍未付款的供应商发票。"
- "我们的银行账户余额和最新交易是多少?"
常见问题
我需要什么才能登录? 来自 Sage 开发者计划的 API 密钥(在开发者页面请求;可能需要最多 2 个工作日),你登录的站点,以及 Sage Accounting 用户的电子邮件和密码。建议使用仅具有助手所需访问权限的专用用户:每小时 20 次失败的登录会使用户被封锁 24 小时。
这是全球版的 Sage Accounting 吗? 不是。这是 Sage Business Cloud Accounting 的南非版,前身为 Sage One 和 Sage Pastel My Business Online,也用于其他非洲市场,均由同一平台提供服务。对于英国、爱尔兰、北美和欧洲,请使用 Sage Business Cloud 连接器。
它可以更改什么,是否移动资金? 它创建和更新客户、供应商、项目、账户、报价和税务发票,并提供计算工具以先预览总额。银行账户、银行交易和客户收款为只读:它不记录任何收据或付款,永远不移动资金,也不删除任何内容。没有安装被关闭的内容。
Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?