InvoiceFlow MCP

Model Context Protocol을 위한 AI 기반 송장 자동화

License: MIT TypeScript MCP

InvoiceFlow는 MCP 프로토콜을 통해 전문적인 PDF 송장을 생성하고, AI를 사용하여 연체 위험을 예측하며, 알림을 자동 발송하고, Stripe/PayPal 결제를 조정하며, 현금 흐름을 추적합니다.

주요 기능

전문적인 PDF 송장: 품목, 세금, 할인, 다중 통화(10개 통화) 지원
AI 위험 예측 (0-100): 송장 금액, 고객 이력, 마감일, 알림 이력을 기반으로 분석
스마트 알림: 위험 수준에 따른 단계별 알림 발송
결제 조정: 금액 및 이메일을 기준으로 Stripe/PayPal 결제와 송장 매칭
현금 흐름 보고서: 회수율, 예상 수입, 고객별 분석 제공
고객 관리: 자동 결제 이력 추적
순차적 송장 번호: (INV-2026-0001, INV-2026-0002, ...)
10개의 MCP 도구 + 4개의 MCP 리소스: 전체 송장 발행 주기 지원

빠른 시작

MCPize 마켓플레이스에서 설치

mcpize.com에서 InvoiceFlow MCP를 검색합니다.
설치를 클릭하고 구독 플랜을 선택합니다.
MCP 호환 클라이언트에서 도구와 리소스를 즉시 사용할 수 있습니다.

소스에서 빌드

git clone https://github.com/enzoemir1/invoiceflow-mcp.git
cd invoiceflow-mcp
npm ci
npm run build

MCP 클라이언트 설정에 추가:

{
  "mcpServers": {
    "invoiceflow": {
      "command": "node",
      "args": ["path/to/invoiceflow-mcp/dist/index.js"]
    }
  }
}

도구

client_manage

새 고객을 생성합니다. 송장 생성 전에 필수입니다.

invoice_create

품목이 포함된 송장을 생성합니다. 소계, 세금, 할인 및 총액을 자동으로 계산합니다. 순차적인 송장 번호(INV-YYYY-NNNN)를 생성합니다.

invoice_send

이메일로 송장 PDF를 발송합니다(SENDGRID_API_KEY 필요). 상태를 "sent"로 업데이트합니다.

invoice_list

상태, 고객, 금액 범위, 날짜 범위 또는 연체 여부별로 송장을 필터링합니다. 페이지네이션을 지원합니다.

invoice_mark_paid

송장을 결제 완료(전액 또는 일부)로 표시합니다. 고객 결제 이력을 자동으로 업데이트합니다.

invoice_remind

결제 알림을 발송합니다. 알림 횟수를 증가시킵니다. 사용자 지정 메시지를 지원합니다.

invoice_risk

AI 기반 연체 위험 예측(0-100). 위험 수준, 요인 분석, 권장 조치, 다음 알림 날짜를 반환합니다.

cashflow_report

현금 흐름 요약 생성: 총 발행액, 회수액, 미수금, 연체액, 회수율, 30일 예상 수입.

payment_reconcile

금액과 결제자 이메일을 기준으로 입금된 결제 내역을 송장과 매칭합니다. 자동으로 결제 완료 처리합니다.

리소스

리소스	설명
`invoices://pending`	미결제 송장 전체
`invoices://overdue`	마감일이 지난 송장
`invoices://stats`	월간 현금 흐름 요약
`clients://list`	결제 이력이 포함된 전체 고객

위험 예측 엔진

4가지 가중치 요인을 사용하여 송장 점수를 0-100으로 산출합니다:

요인	가중치	측정 항목
송장 금액	20%	금액이 클수록 위험도 높음
고객 이력	35%	결제율, 연체 이력, 평균 결제일
마감일	30%	마감일까지 남은 일수/지난 일수
알림 횟수	15%	이미 발송된 알림 횟수

위험 수준: 낮음 (0-30), 보통 (31-60), 높음 (61-100)

통합

SendGrid -- 이메일 송장/알림을 위해 SENDGRID_API_KEY 설정
Stripe -- 결제 조정을 위해 STRIPE_API_KEY 설정
PayPal -- PAYPAL_CLIENT_ID + PAYPAL_CLIENT_SECRET 설정

통화

USD, EUR, GBP, CAD, AUD, JPY, CHF, TRY, BRL, INR

요금제

티어	가격	월간 송장 발행	기능
Free	$0	5	기본 PDF 송장
Pro	$15/월	100	AI 위험 예측, 알림, Stripe 동기화
Business	$30/월	무제한	다중 통화, 결제 조정, 현금 흐름 분석

MCPize 마켓플레이스에서 이용 가능합니다.

개발

npm run dev        # Hot reload
npm run build      # Production build
npm test           # Run tests
npm run inspect    # MCP Inspector

라이선스

MIT 라이선스. 자세한 내용은 LICENSE를 참조하세요.

제작: Automatia BCN.

invoiceflow-mcp