FacturX API — MCP-сервер для Claude Code: функции и установка
MCP-сервер FacturX API для Claude Code, Codex и Cursor работает с электронными счетами Factur-X. Агент может проверить готовность счёта, преобразовать файл и разобрать правило EN16931.
MIT обновлён 2026-11-15
claude mcp add --env FACTURX_API_KEY=<FACTURX_API_KEY> --env FACTURX_BASE_URL=<FACTURX_BASE_URL> --transport stdio mcp -- uvx facturx-mcpЧто делает FacturX API
Сервер даёт агенту инструменты для работы со счетами через FacturX API. Он проверяет готовность данных, создаёт Factur-X PDF/A-3, валидирует файл и объясняет правила EN16931 по коду, полю BT или JSON-пути. Для интеграции используется SDK facturx-api.
Для вызовов API нужен FACTURX_API_KEY; сервер запускается через uvx facturx-mcp. Конвертация стоит одну обработанную фактуру, а объяснение правил бесплатно и не требует ключа. При ошибке API сервер возвращает её детали и не повторяет запрос автоматически.
Какие задачи решает
- оценить готовность счёта к генерации
- преобразовать данные счёта в Factur-X PDF/A-3
- проверить файл и получить краткий отчёт валидации
- найти связанные поля для правила EN16931
Примеры запросов агенту
- Проверь готовность данных счёта перед генерацией Factur-X.
- Преобразуй этот счёт в Factur-X и проверь результат.
- Объясни правило EN16931
BR-CO-15и связанные с ним поля.
Как установить FacturX API
Командой платформы
claude mcp add --env FACTURX_API_KEY=<FACTURX_API_KEY> --env FACTURX_BASE_URL=<FACTURX_BASE_URL> --transport stdio mcp -- uvx facturx-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from facturx-mcp <команда>
Командой платформы
codex mcp add mcp --env FACTURX_API_KEY=<FACTURX_API_KEY> --env FACTURX_BASE_URL=<FACTURX_BASE_URL> -- uvx facturx-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from facturx-mcp <команда>
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"facturx-mcp"
],
"env": {
"FACTURX_API_KEY": "<FACTURX_API_KEY>",
"FACTURX_BASE_URL": "<FACTURX_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from facturx-mcp <команда>
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"facturx-mcp"
],
"env": {
"FACTURX_API_KEY": "<FACTURX_API_KEY>",
"FACTURX_BASE_URL": "<FACTURX_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from facturx-mcp <команда>
Командой платформы
gemini mcp add -e FACTURX_API_KEY=<FACTURX_API_KEY> -e FACTURX_BASE_URL=<FACTURX_BASE_URL> mcp uvx facturx-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from facturx-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о FacturX API
Как установить FacturX API в Claude Code?
Выполни claude mcp add mcp -e FACTURX_API_KEY=<FACTURX_API_KEY> -- uvx facturx-mcp. Подставь ключ FacturX API вместо плейсхолдера.
Что делает FacturX API?
MCP-сервер позволяет агенту проверять готовность счёта, конвертировать его в Factur-X PDF/A-3, валидировать файл и разбирать правила EN16931.
Что нужно для работы FacturX API?
Нужен ключ FACTURX_API_KEY и доступ к FacturX API. Сервер запускается командой uvx facturx-mcp.