Invoice4U MCP by Agente

비공식 서드파티 Model Context Protocol 서버로, MCP 호환 에이전트가 Invoice4U 계정에 안전하고 타입이 지정된 방식으로 접근할 수 있게 해줍니다 — 문서와 고객 검색, 결제된 인보이스에 연결된 영수증 생성 등을 지원합니다.

• 비공식: 이는 커뮤니티 통합으로, Invoice4U와 제휴, 보증, 또는 지원 관계가 아닙니다. Invoice4U 명칭은 서버가 연결하는 대상을 설명하기 위해 명목적으로 사용됩니다. 허가 없이 Invoice4U 상표나 로고를 사용하지 않습니다.

• TypeScript / Node.js 24 LTS / MIT · stdio 전송 · 로컬 자체 호스팅 — Agente는 귀하의 Invoice4U 자격 증명을 보관하지 않습니다.

• 기본적으로 읽기 전용: 유일한 쓰기 도구(영수증 생성)는 INVOICE4U_ALLOW_WRITES=true가 아닌 한 tools/list에 등록되지 않습니다.

• 영문 README · 히브리어 README.he.md

빠른 시작

{
  "mcpServers": {
    "invoice4u": {
      "command": "npx",
      "args": ["-y", "@agente-dev/invoice4u-mcp"],
      "env": {
        "INVOICE4U_API_TOKEN": "your-api-key",
        "INVOICE4U_ENV": "qa",
        "INVOICE4U_ALLOW_WRITES": "false"
      }
    }
  }
}

INVOICE4U_ENV는 반드시 명시적으로 qa 또는 production이어야 합니다 — 절대 조용히 production으로 기본 설정되지 않습니다. QA로 시작하세요; 이는 안전하고 문서화된 기본 시작 구성입니다.

Related MCP server: mcp-server-smallinvoice

도구 (v0.1 표면)

읽기 도구는 readOnlyHint: true, idempotentHint: true를 선언합니다. 쓰기 도구는 readOnlyHint: false, destructiveHint: false, idempotentHint: true를 선언합니다 — 멱등성은 안정적인 apiIdentifier가 필수이고 중복되거나 불확실한 결과가 식별자 조회를 통해 해결되기 때문에만 유지됩니다. 쓰기 제출 후 타임아웃이 발생하면 맹목적으로 재시도하지 않습니다: 서버는 먼저 apiIdentifier로 조회하고, 조회 결과 문서가 존재하지 않음이 입증된 경우에만 재시도합니다.

금액은 MCP 경계에서 십진수 문자열("12500.00")로 표현되며, JavaScript 부동소수점으로는 절대 표현되지 않습니다. HTTP 200을 반환하면서 Errors 컬렉션에 애플리케이션 오류를 포함하는 Invoice4U 응답은 타입이 지정된 오류 모델로 정규화됩니다 — 성공으로 보고되지 않습니다.

구성

자격 증명은 환경 변수에만 존재합니다 — 토큰은 도구 인수로 절대 허용되지 않으며, 절대 반환되지 않고, 절대 로그에 기록되지 않습니다.

.env.example을 참조하세요. 검토된 공식 Invoice4U 호스트만 접속됩니다 — 임의의 기본 URL 탈출구는 없습니다.

안전 모델

• 기본적으로 읽기 전용 — 쓰기 도구는 쓰기가 명시적으로 활성화되지 않는 한 tools/list에서 완전히 제외됩니다.

• 멱등 쓰기 — 필수 안정적인 apiIdentifier; 동일한 요청을 다시 제출해도 두 번째 영수증이 생성될 수 없습니다.

• 검증된 쓰기 — 모든 쓰기는 영수증과 참조된 인보이스를 다시 조회하여 이전/새 잔액과 상태를 구조화된 출력으로 반환합니다.

• 불확실한 쓰기 결과에 대한 맹목적 재시도 없음 — 해결은 apiIdentifier 조회를 통해 이루어집니다.

• 비밀 정보 위생 — 일반 수준의 로그에 토큰이나 고객 PII가 없습니다; QA 픽스처에는 실제 고객 데이터가 없습니다.

• 자금 이동 없음 — 영수증 생성은 이미 수령한 금액을 기록할 뿐입니다; 서버는 결제를 시작하거나 카드를 청구할 수 없습니다.

상태

구현 완료 — v0.1 표면. 8개 도구(7개 읽기 + 1개 게이트 쓰기)가 위 도구 표에 설명된 대로 구현되고 등록되었습니다. 적용 범위는 coverage-manifest.json에서 추적되며, 세부 사항은 docs/에 있습니다.

• QA 상태: 읽기 도구는 Invoice4U API 참조 및 계약 테스트(120개 단위 + 계약 테스트 통과)로 검증되었습니다. 실제 QA 통합은 자격 증명 대기로 차단됨 — 공개 Invoice4U 샌드박스가 없으며, apiqa.invoice4u.co.il을 사용하려면 실제 QA 조직 계정 + API 토큰이 필요합니다. 게이트된 스모크 테스트(tests/integration/qa.spec.ts)는 토큰이 없으면 건너뜁니다; docs/qa-testing.md를 참조하세요.

• npm 패키지 보류 중: 게시는 npmjs.com에서 @agente-dev/invoice4u-mcp에 대한 신뢰된 게시 링크를 기다리고 있습니다.

라이선스

MIT — LICENSE 참조. © Agente Dev LTD. Invoice4U와 제휴 관계가 아닙니다.