poland-invoice

Let AI agents submit Polish structured invoices (faktura ustrukturyzowana) to KSeF, the national e-invoice system.

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

Что умеет

  • Create Invoice: Issue a Poland structured e-invoice (faktura ustrukturyzowana, schema FA(3)) through KSeF 2.0 — Krajowy System e-Faktur, the national government e-invoice API. Bring your own credentia
  • Query Invoice: Fetch a Poland KSeF invoice by its KSeF number (the numer KSeF assigned by the government system, returned by create_invoice). Status values: ACCEPTED (the invoice exists in the nationa

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

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

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

Let AI agents submit Polish structured invoices (faktura ustrukturyzowana) to KSeF, the national e-invoice system. Stateless remote MCP server: bring your own KSeF access, it stores nothing. Build FA(3) XML with VAT math and submit via the encrypted KSeF 2.0 flow.

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

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

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

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

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

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

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

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

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

https://poland-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 a Poland structured e-invoice (faktura ustrukturyzowana, schema FA(3)) through KSeF 2.0 — Krajowy System e-Faktur, the national government e-invoice API. Bring your own credentials via headers: x-ksef-token (a KSeF authorization token you self-mint in the Ministry of Finance taxpayer portal at ksef.podatki.gov.pl) and x-ksef-nip (your 10-digit seller NIP). Runs against the MoF TEST environment by default (no fiscal effect); set header x-ksef-mode: production to submit real invoices to KSeF (or demo for the demo environment). The server opens an encrypted online session, submits the FA(3) invoice, closes the session, and returns the assigned KSeF number. Amounts are in PLN; each line item carries a NET unit price and a Polish VAT rate (23, 8, 5, or 0) — the server computes per-rate net/VAT and the invoice gross total.
query_invoiceFetch a Poland KSeF invoice by its KSeF number (the numer KSeF assigned by the government system, returned by create_invoice). Status values: ACCEPTED (the invoice exists in the national KSeF repository under your NIP — its presence is the fiscal proof). Authenticates with your KSeF token; safe to call anytime.