taxapp.nz

taxapp.nz MCP サーバー

Tax Appの記録について、収入、支出、賃貸物件、ニュージーランドの税金などを、普段の言葉で AI アプリに質問できます。組織で許可されている場合は、記録の追加や変更もできます。

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（developer mode をオン）> 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日から週650ドルで、Jane Brown を 12 Smith Street の入居者として追加してください。」
• 「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 の外部に作用するマークが付きます。所有者が Read, add and change records を選択しない限り、追加と変更は拒否されます。また、自分の役割を超える操作はできません。AI アプリが送信するのは、日付、金額、支払者など、あなたが伝えた情報だけです。GST、KiwiSaver、ACC賦課金、税金、すべての合計は、Tax App が自身のフォームと同じ方法で計算します。追加操作は同じ内容を繰り返しても安全です。同じ詳細情報を再送信すると、すでに作成されたレコードが返されます。変更時には、変更するフィールドだけが送信されます。

できないこと

• 何も削除できません
• 銀行取引明細を照合したり、照合結果を変更したりできません
• 組織の設定、メンバー、他のサービスとの接続を変更できません
• 自分の役割で閲覧できない情報や、選択していない組織の情報を閲覧できません
• Inland Revenue に申告書を提出できません

安全性の確保

• あなたとしてサインインしますが、パスワードを参照することはありません。
• 実行したすべての変更は組織の監査記録に記録され、AI コネクター経由で行われたことが示されます。
• 所有者は Settings > AI connectors で各 AI コネクターを確認し、削除できます。AI コネクターをオフにすると、すべてのコネクターが終了します。
• パスワードを変更すると、自分が作成したすべての AI コネクターが終了します。
• 共有した情報は、AI アプリを提供する会社に送信され、その会社独自の利用規約が適用されます。また、ニュージーランド国外に保管される場合があります。Tax App 内の記録は、これまでどおりニュージーランド国内に保管されます。
• 税金、ACC、KiwiSaver の金額は、IRDの税率に基づく参考計算であり、IRDによる査定額ではありません。

アプリ開発者向け

• 認証：PKCE（S256）を使用するOAuth 2.1。有効なサインインなしでリクエストすると、WWW-Authenticate チャレンジとともにHTTP 401が返されます。
• 認可サーバー：https://api.taxapp.nz（動的クライアント登録およびクライアントIDメタデータ文書）
• 保護対象リソースのメタデータ：https://mcp.taxapp.nz/.well-known/oauth-protected-resource/mcp
• スコープ：taxapp。設定が必要なAPIキー、ヘッダー、環境変数はありません。

詳細

• 完全なガイド
• プライバシーポリシー
• ヘルプ：[email protected]