MCP-сервер taxapp.nz

Задавайте вопросы о своих данных в Tax App обычными словами: о доходах, расходах, объектах аренды

и налогах в Новой Зеландии. Если настройки вашей организации это позволяют, сервер также может добавлять и изменять записи.

Tax App — приложение из Новой Зеландии для домохозяйств, индивидуальных предпринимателей и владельцев недвижимости, сдаваемой в аренду. В нём собраны сведения о доходах, расходах, контактах, объектах аренды и банковских сверках; приложение рассчитывает примерный налог по ставкам Inland Revenue. Этот MCP-сервер размещён Tax App; данный репозиторий описывает сервер, но не содержит его кода.

Адрес сервера: https://mcp.taxapp.nz/mcp (удалённый сервер, Streamable HTTP)
Название в MCP Registry: nz.taxapp/taxapp
Полное руководство: https://taxapp.nz/guides/ai-assistants/

Требуется вход в систему

Для каждого запроса необходимо войти в Tax App. При подключении приложение с ИИ откроет страницу входа в Tax App; копировать в него ключ или пароль не нужно.

Перед подключением

Вам потребуется учётная запись Tax App. Зарегистрируйтесь бесплатно.
Владелец организации должен включить подключения ИИ в разделе Настройки > Подключения ИИ (или во время подключения) и выбрать режим Только чтение или Чтение, добавление и изменение записей.
Добавьте сервер в приложение с ИИ и войдите в Tax App, когда появится запрос.

Настройка

VS Code (GitHub Copilot)

Добавьте сервер из галереи @mcp или поместите этот фрагмент в mcp.json:

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

Запустите сервер, выберите Allow, когда VS Code предложит войти в систему, затем войдите в Tax App и отметьте организации, к которым сервер сможет получить доступ.

Другие приложения с ИИ

Приложение	Как подключить
Claude (веб-версия, настольное и мобильное приложения)	Настройки > Подключения > Добавить пользовательское подключение; укажите имя `taxapp` и URL `https://mcp.taxapp.nz/mcp`
Claude Code	`claude mcp add --transport http taxapp https://mcp.taxapp.nz/mcp`
ChatGPT	Настройки > Приложения (включите режим разработчика) > создать; укажите URL `https://mcp.taxapp.nz/mcp` и способ аутентификации OAuth
Grok (веб-версия и мобильные приложения)	grok.com/connectors (или раздел «Подключения» в приложении) > Новый коннектор > Пользовательский; укажите имя `taxapp` и URL `https://mcp.taxapp.nz/mcp`
Cursor	Добавьте `"taxapp": { "url": "https://mcp.taxapp.nz/mcp" }` в раздел `mcpServers` файла `~/.cursor/mcp.json`

Использование

Задавайте вопросы обычными словами, например:

«Какой налог я должен буду заплатить в этом году?»
«Какие расходы я указал для объекта аренды в марте?»
«Какие банковские операции ещё нужно распределить?»
«Добавь счёт сантехника на 120 долларов за работу по адресу 12 Smith Street».
«Добавь Jane Brown как арендатора по адресу 12 Smith Street с 1 мая, аренда — 650 долларов в неделю».
«С 1 июня аренда по адресу 12 Smith Street вырастет до 680 долларов в неделю».
«Измени сумму комиссии, полученной на прошлой неделе, на 1 250 долларов».

Данные берутся непосредственно из ваших записей. Ответ формирует ИИ, поэтому важную информацию проверяйте в приложении. Если что-то неясно — например, какой контакт, объект недвижимости или счёт расходов вы имеете в виду, — приложение с ИИ покажет наиболее подходящие варианты и задаст уточняющий вопрос.

Налоговые годы в Новой Зеландии соответствуют периодам с 1 апреля по 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. Добавление и изменение записей запрещены, если владелец не выбрал режим Чтение, добавление и изменение записей; кроме того, инструменты не позволяют выйти за рамки вашей роли. Приложение с ИИ передаёт только указанную вами информацию, например даты, суммы и сведения о плательщике. Tax App самостоятельно рассчитывает GST, KiwiSaver, сбор ACC, налог и все итоговые суммы — так же, как при заполнении форм вручную. Повторное добавление безопасно: если отправить те же данные ещё раз, сервер вернёт уже созданную запись. При изменении передаются только обновляемые поля.

Что сервер не умеет

Удалять данные
Сверять банковские выписки или изменять сопоставления
Изменять настройки организации, список участников или подключения к другим сервисам
Просматривать данные, недоступные для вашей роли, или данные организации, которую вы не отметили
Подавать декларацию в Inland Revenue

Безопасность

Сервер выполняет вход от вашего имени и никогда не получает ваш пароль.
Все внесённые изменения попадают в журнал аудита организации и помечаются как сделанные через подключение ИИ.
Владельцы могут просматривать все подключения ИИ в разделе Настройки > Подключения ИИ и удалять их. Если отключить подключения ИИ, они все будут завершены.
При смене пароля завершаются все созданные вами подключения ИИ.
Переданные вами данные получает компания, разработавшая приложение с ИИ. На них распространяются её условия использования; данные могут храниться за пределами Новой Зеландии. Ваши записи в Tax App остаются на месте — в Новой Зеландии.
Расчёты налога, ACC и KiwiSaver являются приблизительными и основаны на ставках IRD; это не налоговая оценка IRD.

Для разработчиков приложений

Аутентификация: OAuth 2.1 с PKCE (S256). Запрос без действительной авторизации получает ответ HTTP 401 с заголовком WWW-Authenticate.
Сервер авторизации: https://api.taxapp.nz (поддерживает динамическую регистрацию клиентов и документы метаданных client ID)
Метаданные защищённого ресурса: https://mcp.taxapp.nz/.well-known/oauth-protected-resource/mcp
Область доступа: taxapp. Настраивать API key, заголовок или переменную окружения не нужно.