italy-invoice

Let AI agents issue Italian electronic invoices (FatturaPA) through the SdI via Invoicetronic.

От сообществаРаботаетБез входаГлобальныйБесплатноМожет изменять данные

Что умеет

  • Create Invoice: Issue an Italy B2B electronic invoice (fattura elettronica) in FatturaPA format (FPR12) and transmit it to the national SdI (Sistema di Interscambio) via Invoicetronic. Builds the Fatt
  • Query Invoice: Check the SdI processing status of an invoice sent by create_invoice, using its send id. FatturaPA transmission is asynchronous. Status values: SENT (Inviato — accepted by the SdI, not

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

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

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

Let AI agents issue Italian electronic invoices (FatturaPA) through the SdI via Invoicetronic. Stateless remote MCP server: bring your own key, it stores nothing. Build FPR12 XML with IVA math (22/10/5/4%), send to SdI, track delivery status.

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

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

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

https://italy-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 не видит.

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

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

https://italy-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 откроет окно входа в сервис. Войдите и подтвердите доступ.

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

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

https://italy-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. Нужны только разработчикам.

create_invoiceIssue an Italy B2B electronic invoice (fattura elettronica) in FatturaPA format (FPR12) and transmit it to the national SdI (Sistema di Interscambio) via Invoicetronic. Builds the FatturaPA XML (seller/buyer P.IVA + optional Codice Fiscale, address, line items, IVA breakdown) and uploads it under your own Invoicetronic API key. Bring your own credential as header x-invoicetronic-key — ik_test_ keys are free sandbox (no fiscal effect), ik_live_ keys transmit real invoices to the SdI (same base URL; the key prefix selects the environment). Italian IVA rates supported: 22 (ordinaria), 10, 5, 4 (ridotte). Amounts are in EUR. Transmission is asynchronous: this returns a send id — poll query_invoice with it to learn the SdI outcome (SENT / DELIVERED / REJECTED / NOT_DELIVERED). There is no cancel at the SdI level: to reverse an invoice you issue a credit note (nota di credito) as a new invoice.
query_invoiceCheck the SdI processing status of an invoice sent by create_invoice, using its send id. FatturaPA transmission is asynchronous. Status values: SENT (Inviato — accepted by the SdI, not yet delivered to the recipient; poll again shortly); DELIVERED (Consegnato — delivered to the recipient, the invoice is fiscally complete); REJECTED (Scartato — the SdI rejected it for a validation error; fix the data and create_invoice again); NOT_DELIVERED (ImpossibilitaDiRecapito / MancataConsegna — the invoice is legally valid and available in the recipient's tax drawer, but could not be pushed to their receiving system); PROCESSING (no SdI notification yet — poll again shortly). Safe to call anytime.