hungary-invoice

Let AI agents report Hungarian invoice data to NAV Online Szamla 3.0 (szamla adatszolgaltatas).

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Submit Invoice: Report a Hungary invoice to NAV Online Számla 3.0 (számla adatszolgáltatás) — the national invoice-data reporting API of the Hungarian tax authority (NAV). This is REPORTING, not issui
  • Query Transaction: Check the NAV processing status of an invoice-data submission by its transactionId (returned by submit_invoice). Status values (per invoice index): RECEIVED (NAV received it), PROCE

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Let AI agents report Hungarian invoice data to NAV Online Szamla 3.0 (szamla adatszolgaltatas). Stateless remote MCP server: bring your own technical-user values, signatures computed per request, nothing stored. Submit invoice data with AFA math (27/18/5%), query transaction status.

Как подключить

Как подключить hungary-invoice к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://hungary-invoice--wishpool.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить hungary-invoice к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://hungary-invoice--wishpool.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить hungary-invoice к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://hungary-invoice--wishpool.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (2)

Технические названия из tools/list. Нужны только разработчикам.

submit_invoiceReport a Hungary invoice to NAV Online Számla 3.0 (számla adatszolgáltatás) — the national invoice-data reporting API of the Hungarian tax authority (NAV). This is REPORTING, not issuing: the merchant issues the actual invoice to the buyer; this tool submits the invoice data to NAV as legally required and returns a transactionId. Bring your own technical-user credentials via headers, all self-minted in the Online Számla web portal (onlineszamla.nav.gov.hu -> Technical users): x-nav-login, x-nav-password, x-nav-signkey, x-nav-exchangekey, x-nav-taxnumber (your 8-digit tax number). Runs against the NAV TEST environment by default (no legal effect); set header x-nav-mode: prod to report real invoices. The server exchanges a token, builds the InvoiceData XML, signs the request (SHA3-512), submits a CREATE operation, and returns the transactionId — then call query_transaction to read the processing result. Amounts are in HUF; each line carries a NET unit price and a Hungarian ÁFA (VAT) rate (27, 18, 5, or 0) — the server computes per-rate net/VAT and the invoice gross total.
query_transactionCheck the NAV processing status of an invoice-data submission by its transactionId (returned by submit_invoice). Status values (per invoice index): RECEIVED (NAV received it), PROCESSING (validating), SAVED (stored — non-fatal warnings possible), DONE (successfully processed and stored — this is the success terminal), ABORTED (rejected — read validation_messages for the reason). Authenticates with your technical-user keys; safe to call anytime.