fakturka-api-mcp
Faktuj MCP 서버
**Faktuj**를 Claude, Cursor, VS Code 및 모든 MCP 호환 AI 어시스턴트에 통합하세요. VAT 세금계산서 및 프로포르마(견적) 세금계산서를 생성하고, NIP로 기업 정보를 조회하며, NBP 환율을 확인하고, IBAN 번호를 검증할 수 있습니다. 이 모든 것이 AI 워크플로우 내에서 가능합니다. KSeF 규정을 완벽하게 준수합니다.
API 키가 필요하지 않습니다. 평생 무료입니다.
빠른 시작
claude_desktop_config.json에 추가하세요:
{
"mcpServers": {
"faktuj": {
"command": "npx",
"args": ["-y", "faktuj-mcp"]
}
}
}또는 전역으로 설치하세요:
npm install -g faktuj-mcp그런 다음 설정에 추가하세요:
{
"mcpServers": {
"faktuj": {
"command": "faktuj-mcp"
}
}
}Related MCP server: mcp-ksef-pl
사용 가능한 도구
도구 | 설명 |
| 폴란드 VAT 세금계산서 PDF를 생성합니다. 판매자, 구매자 및 품목이 포함된 전체 세금계산서 JSON을 전달하세요. 세금계산서 번호와 base64 PDF를 반환합니다. |
| 프로포르마 세금계산서 PDF를 생성합니다. VAT 세금계산서와 동일한 스키마를 사용합니다. 세금계산서 번호와 base64 PDF를 반환합니다. |
| PDF를 생성하지 않고 세금계산서 데이터를 미리 보고 검증합니다. 검증된 데이터 또는 검증 오류를 반환합니다. |
| NIP 세금 식별 번호로 폴란드 기업을 조회합니다. 회사명, 주소 및 등록 데이터를 반환합니다. |
| 특정 통화와 날짜에 대한 NBP(폴란드 국립은행) 환율을 조회합니다. |
| IBAN 번호를 검증합니다. 유효한 경우 검증 결과와 은행 세부 정보를 반환합니다. |
사용 예시
AI 어시스턴트에게 다음과 같이 요청하세요:
"ACME sp. z o.o. (NIP: 1234567890)에서 Beta S.A.로 발행하는 10시간 컨설팅(시간당 200 PLN)에 대한 VAT 세금계산서를 생성해줘"
"NIP 5263442510인 회사 정보를 조회해줘"
"2026년 3월 20일 EUR/PLN 환율이 얼마였지?"
"IBAN PL61109010140000071219812874 번호를 검증해줘"
아키텍처
AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST API이것은 Faktuj REST API 위에 구축된 가벼운 stdio MCP 전송 계층입니다. MCP 서버는 도구 호출을 HTTP 요청으로 변환하고 구조화된 응답을 반환합니다.
설정
환경 변수 | 기본값 | 설명 |
|
| Faktuj API의 기본 URL |
리소스
VAT 세금계산서 가이드 — 규정을 준수하는 폴란드 VAT 세금계산서 작성 방법
프로포르마 세금계산서 가이드 — 프로포르마 세금계산서 사용 시기 및 방법
KSeF 규정 준수 — 폴란드 국가 전자 세금계산서 시스템 요구 사항
블로그 — 세금계산서 작성 가이드, 세금 팁 및 제품 업데이트
API 문서 — 전체 REST API 참조
SoftVoyagers 생태계
Faktuj는 SoftVoyagers 오픈 소스 포트폴리오의 일부입니다:
제품 | 설명 | 웹사이트 |
LinkMeta | 무료 URL 메타데이터 추출 API | |
PageShot | 무료 스크린샷 및 웹페이지 캡처 API | |
PDFSpark | 무료 HTML/URL to PDF 변환 API | |
OGForge | 무료 Open Graph 이미지 생성기 API | |
LinkShrink | 무료 개인정보 보호 우선 URL 단축 API | |
Faktuj | 무료 폴란드 VAT 세금계산서 생성기 | |
QRMint | 무료 스타일 QR 코드 생성기 및 API | |
PageDrop | 무료 즉시 HTML 호스팅 API | |
PismoSzyteNaMiarę | Darmowy generator pism urzędowych |
라이선스
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Free Polish VAT invoice generator API (Faktura VAT). Generate professional PDF invoices with light/dark themes. No API keys required.
Fakturownia.pl (Polish invoicing) via MCP: invoices, clients, products, warehouse. Full read-write.
wFirma.pl (Polish accounting) via MCP: invoices, contractors, payments, reports. Full read-write.
Hosted MCP server for Mini Accountant: invoices, expenses, customers, analytics, tax estimates.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.645 npm2MIT
- AlicenseAqualityCmaintenanceModel Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.103Apache 2.0
- FlicenseBqualityCmaintenanceSingle-tenant MCP server for Polish KSeF e-invoice workflows, supporting local stdio testing, draft management, and invoice submission with safety gates.23-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.48 npmMIT