InvoiceXML — MCP-сервер для Claude Code: электронные счета
Подключает агента к API InvoiceXML: создание, проверка, конвертация и разбор электронных счетов в Factur-X, ZUGFeRD, XRechnung, UBL и Peppol BIS Billing 3.0.
claude mcp add --transport http invoicexml https://mcp.invoicexml.comЧто делает InvoiceXML
InvoiceXML — это MCP-сервер, который открывает ИИ-агенту доступ к публичному REST API InvoiceXML. Через него агент создаёт счета, проверяет их на соответствие требованиям, конвертирует между форматами и вытаскивает данные из готовых файлов. Поддерживаются Factur-X, ZUGFeRD, XRechnung, UBL / CII и Peppol BIS Billing 3.0.
Кодовая база одна, но запускается в двух режимах, и режим выбирается переменной окружения Mcp:AuthMode. В режиме ApiKey вы держите сервер у себя и передаёте ключ через INVOICEXML_API_KEY или appsettings.json. В режиме OAuth сервер работает на стороне InvoiceXML и авторизует клиента по OAuth 2.1 с динамической регистрацией. Локальный запуск требует .NET 10 SDK и ключ API — без ключа сервер не поднимется.
Сервер отдаёт MCP-эндпоинт на POST http://localhost:5004/, страницу приветствия на GET / и /health. Он stateless, поэтому несколько экземпляров можно ставить за балансировщик. TLS при этом терминируется на вашем прокси. Добавить новый инструмент — это один класс с атрибутом [McpServerTool], новый режим авторизации — одна ветка в AuthExtensions.cs.
Какие задачи решает
- собрать электронный счёт в формате XRechnung из данных заказа
- проверить готовый файл Factur-X на соответствие требованиям
- перевести счёт из UBL в ZUGFeRD
- вытащить позиции и суммы из полученного e-invoice
- подготовить документ под Peppol BIS Billing 3.0
Примеры запросов агенту
- Сделай счёт в формате XRechnung по этим данным и проверь его
- Разбери файл
invoice.xmlи покажи позиции с суммами - Сконвертируй этот UBL-счёт в ZUGFeRD
Как установить InvoiceXML
Командой платформы: удалённый сервер
claude mcp add --transport http invoicexml https://mcp.invoicexml.comКомандой платформы: удалённый сервер
codex mcp add invoicexml --url https://mcp.invoicexml.comФайл настроек
{
"mcpServers": {
"invoicexml": {
"url": "https://mcp.invoicexml.com"
}
}
}Файл настроек
{
"servers": {
"invoicexml": {
"type": "http",
"url": "https://mcp.invoicexml.com"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http invoicexml https://mcp.invoicexml.comПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о InvoiceXML
Как установить InvoiceXML в Claude Code?
Одной командой: claude mcp add --transport http invoicexml https://mcp.invoicexml.com.
Что делает InvoiceXML?
Даёт агенту инструменты для работы с электронными счетами: создание, проверка, конвертация и извлечение данных. Форматы — Factur-X, ZUGFeRD, XRechnung, UBL / CII и Peppol BIS Billing 3.0.
Что нужно для локального запуска?
.NET 10 SDK и ключ API InvoiceXML. Ключ задаётся через dotnet user-secrets или переменную INVOICEXML_API_KEY.
