taxapp.nz

taxapp.nz MCP 服务

用日常语言向 AI 应用询问 Tax App 中的记录：收入、支出、出租房产和新西兰税务。在你的组织允许的情况下，它还可以添加和更改记录。

Tax App 是一款面向家庭、个体经营者和出租房产所有者的新西兰应用。它将收入、支出、联系人、出租房产和银行对账集中在一处，并根据新西兰税务局的税率计算预估税额。此 MCP 服务由 Tax App 托管，是远程服务；此代码库仅介绍该服务，不包含代码。

• 服务地址：https://mcp.taxapp.nz/mcp（远程，Streamable HTTP）
• MCP Registry 名称：nz.taxapp/taxapp
• 完整指南：https://taxapp.nz/guides/ai-assistants/

需要登录

每次请求都需要你登录 Tax App。连接时，AI 应用会打开 Tax App 登录页面；你无需复制密钥或密码到应用中。

连接前的准备

1. 你需要一个 Tax App 账户。免费注册。
2. 组织的所有者需在 Settings > AI connectors 中开启 AI 连接器（也可在连接时开启），并选择 Read only 或 Read, add and change records。
3. 在 AI 应用中添加此服务，并在提示时登录 Tax App。

配置

VS Code（GitHub Copilot）

从 @mcp 库中添加，或将以下内容放入 mcp.json：

{
  "servers": {
    "taxapp": {
      "type": "http",
      "url": "https://mcp.taxapp.nz/mcp"
    }
  }
}

启动服务，在 VS Code 提示登录时选择 Allow，然后登录 Tax App，并勾选该服务可以访问的组织。

其他 AI 应用

应用	操作方法
Claude（网页、桌面、移动端）	Settings > Connectors > Add custom connector，名称填写 taxapp，URL 填写 https://mcp.taxapp.nz/mcp
Claude Code	claude mcp add --transport http taxapp https://mcp.taxapp.nz/mcp
ChatGPT	Settings > Apps（开启开发者模式）> create，URL 填写 https://mcp.taxapp.nz/mcp，身份验证选择 OAuth
Grok（网页、手机应用）	grok.com/connectors（或应用中的 Connectors）> New Connector > Custom，名称填写 taxapp，URL 填写 https://mcp.taxapp.nz/mcp
Cursor	在 ~/.cursor/mcp.json 的 mcpServers 下添加 "taxapp": { "url": "https://mcp.taxapp.nz/mcp" }

使用方法

用日常语言提问，例如：

• “我今年的预估税额是多少？”
• “我在 3 月记录了哪些出租房产支出？”
• “哪些银行交易还需要整理？”
• “为 12 Smith Street 添加一笔 120 美元的水管工账单。”
• “从 5 月 1 日起，将 Jane Brown 添加为 12 Smith Street 的租户，租金为每周 650 美元。”
• “从 6 月 1 日起，12 Smith Street 的租金涨到每周 680 美元。”
• “将上周的佣金款项改为 1,250 美元。”

数据直接来自你的记录。答案由 AI 撰写，因此请在应用中核实重要信息。如果某项信息不明确，例如你指的是哪个联系人、房产或支出账户，AI 应用会显示最匹配的选项并询问你。

税年按新西兰的收入年度计算（4 月 1 日至次年 3 月 31 日），并以结束年份命名。金额单位为新西兰元。

工具

区域	读取	添加和更改
组织	list_organisations
选项	list_choices（收入、支出和联系人类型、IRD 申报行，以及自定义选项）
纳税年度	get_tax_year_overview、get_tax_summary、get_profit_and_loss
收入	get_income_history、list_income、get_income_record	create_income（佣金、租金或租户报销）、update_income
支出	list_expenses、get_expense_record、list_expense_accounts	create_expense、update_expense、create_expense_account、update_expense_account
联系人	list_contacts、list_contact_types	create_contact、update_contact、set_contact_paye_salary、set_contact_acc_classifications、create_contact_type、update_contact_type
出租房产	list_properties（含租赁关系）、get_rental_report	create_property、update_property、create_tenancy、update_tenancy
储蓄	get_savings_plan	update_savings_plan
定期报告	list_scheduled_report_types、list_scheduled_reports（所有者）	create_scheduled_report、update_scheduled_report（所有者）、send_scheduled_report_now
银行	get_bank_inbox、get_reconciliation_status

每个工具都有标注：读取工具为只读；更改现有内容的工具标记为破坏性操作；发送报告则标记为会向 Tax App 之外发送信息。除非所有者选择了读取、添加和更改记录，否则不会执行添加和更改操作，并且绝不会超出你自己的角色权限。AI 应用只会发送你告知它的信息，例如日期、金额和付款人；Tax App 会自行计算 GST、KiwiSaver、ACC 征费、税款和所有总额，计算方式与其表单完全相同。添加操作可以安全地重复执行：再次发送相同详情时，会返回已创建的记录。更改操作只会发送发生变化的字段。

它无法执行的操作

• 删除任何内容
• 对账银行对账单或更改匹配项
• 更改组织设置、成员或与其他服务的连接
• 查看你自己的角色无权查看的内容，或查看你未勾选的组织
• 向 Inland Revenue 提交申报表

确保安全

• 它以你的身份登录，但永远不会看到你的密码。
• 它所做的每项更改都会记录在组织的审计日志中，并标记为通过 AI 连接器完成。
• 所有者可在设置 > AI 连接器中查看每个 AI 连接器，并可移除其中任何一个；关闭 AI 连接器会终止所有连接器。
• 更改密码会终止你创建的所有 AI 连接器。
• 你分享的内容会发送给 AI 应用背后的公司，并受该公司的条款约束，且可能存储在新西兰境外。你在 Tax App 中的记录仍保留在原处，即新西兰。
• 税款、ACC 和 KiwiSaver 数值是根据 IRD 税率计算的参考估算值，并非 IRD 的评估结果。

面向应用开发者

• 身份验证：OAuth 2.1 with PKCE（S256）。未通过有效身份验证的请求会收到 HTTP 401 响应，并附带 WWW-Authenticate 质询。
• 授权服务器：https://api.taxapp.nz（动态客户端注册和客户端 ID 元数据文档）
• 受保护资源元数据：https://mcp.taxapp.nz/.well-known/oauth-protected-resource/mcp
• Scope：taxapp。无需配置 API 密钥、请求头或环境变量。

更多信息

• 完整指南
• 隐私政策
• 帮助：[email protected]