SEF e-fakture (Srbija)

sef-mcp

EN: ローカルファーストのMCPサーバーです。AI アシスタント（Claude Desktop、Claude Code、Cursor…）が、セルビアのSEF（Sistem elektronskih faktura）向けの電子請求書を作成して送信できます。デフォルトで安全です。デモ環境を使用し、送信は人間の承認を含む2段階で行い、シークレットはシークレットマネージャー経由でのみ扱います。会社固有のルールはコードではなく、ローカルプロファイルに保存されます。

AI アシスタントがSEFに送信する電子請求書を作成して送信できるMCP サーバーです。あなたのコンピューター上で、あなたのAPIキーを使い、仲介者を介さずに動作します。

プログラマーではありませんか？

→ ユーザー向けガイド：Claudeアプリでダブルクリックするだけでインストールできます。ターミナル、Node.js、パスワードマネージャーは不要です。会社と顧客の情報は会話を通じて入力します。

このページの残りは、技術ユーザーと開発者向けです。

なぜ、もう1つSEF MCPが必要なのか

	ホスト型MCPサービス	sef-mcp
APIキーの送信先	他社のサーバー	あなたのコンピューターに保存
請求書を閲覧できる人	第三者	あなたとSEFのみ
送信	1回の呼び出し	下書き → あなたの承認 → 送信
会社のルール（VATのステータス、顧客、採番）	プロンプト内	ローカルプロファイル内で検証
デフォルト環境	さまざま	デモ（税務上の影響なし）

できること（v0.1）

ツール	説明	状態を変更する？
sef_check_setup	環境、安全スイッチ、プロファイルを確認します	いいえ
sef_setup_company	会話を通じて会社を設定します（確認 → 承認）	ローカルのみ
sef_add_customer	顧客を追加または変更します（確認 → 承認）	ローカルのみ
sef_ping	キーと SEF への接続を確認します	いいえ
sef_list_customers	プロファイルに登録された顧客を一覧表示します	いいえ
sef_list_vat_exemption_reasons	公式の免税コードを一覧表示します（例：PDV-RS-33）	いいえ
sef_list_unit_measures	公式の計量単位を一覧表示します（例：MON、HUR、H87）	いいえ
sef_draft_invoice	UBL 請求書をローカルで作成し、金額と approvalCode を返します	ローカルのみ
sef_get_draft	下書きを読み取ります（XML を含めることもできます）	いいえ
sef_send_invoice	承認済みの下書きを SEF に送信します（SEF の検証なし。ポータルと同様です。この機能は SEF ではまだ利用できません）	はい
sef_get_invoice / sef_list_invoice_ids	送信済み請求書のステータスと概要を表示します	いいえ
sef_cancel_invoice	下書き／新規／送信エラーのステータスの請求書を取り消します	はい
sef_storno_invoice	送信済み／受理済み／拒否済みのステータスの請求書を取り消します	はい

ツールのほかに、定型プロンプト（mesecna-faktura、podesavanje-firme、status-fakture、storno-ili-otkazivanje）と、サーバーが使用するデータから生成されるリファレンスドキュメント（sef-mcp://docs/greske、…/statusi、…/pravila）もあります。

クイックスタート

git clone <repo> sef-mcp && cd sef-mcp
npm install && npm test
node dist/src/index.js init ~/.config/sef-mcp/profile.json   # pa popuni podatke firme

続いて docs/setup.md に従ってください。API キーを 1Password（または別のシークレットマネージャー）に保存し、Claude Desktop／Claude Code／Cursor に接続して、デモ環境で最初のテストを行います。

セキュリティの概要

• デフォルトでは SEF_ENV=demo です。本番環境では、2つのスイッチが必要です：SEF_ENV=prod と SEF_MCP_ALLOW_PROD_WRITE=true。
• 送信には draftId と approvalCode（XML の SHA-256 の先頭 8 文字）が必要です。確認したバージョンがそのまま送信されます。
• キーがログに記録されたり、ツールから返されたり、ディスクに保存されたりすることはありません。環境変数からのみ受け付けます。
• クライアントは efaktura.mfin.gov.rs／demoefaktura.mfin.gov.rs とのみ通信します。
• 添付ファイルは許可された1つのフォルダー内にある PDF のみで、サイズ制限があります。
• ローカル監査ログ（audit.jsonl）に、すべての下書き、送信、取り消しが記録されます。

詳細：SECURITY.md および docs/technical-spec.md。

ステータス

v0.1 — 初期段階。 SEF 4.2.0（リリース 3.14～4.2.0 のルール。技術仕様 §11 を参照）、2026年7月31日付の API 仕様、および2026年10月1日付の ITU に準拠しています。UBL ジェネレーターは、ポータルに入力した請求書について SEF 自体が作成する構造を再現します（ゴールデンテスト）。SEF でこのオプションがまだ機能していないため、ポータルから送信する場合と同様に、請求書は SEF の検証なしで送信されます（SEF サポート、2026年11月5日）。docs/roadmap.md を参照してください。

ドキュメント

• ユーザーガイド（プログラミング不要）
• プライバシー
• 機能仕様
• 技術仕様
• 技術ユーザー向けセットアップ
• パッケージ化：Claude 拡張機能とスキル
• アーキテクチャ決定記録（ADR）
• プロジェクトへの貢献

免責事項

これは財務省の公式ツールではありません。請求書の内容および税務上の適正性に関する責任は、発行者にあります。税区分と免税コードについては、担当の会計士に確認してください。

ライセンス

MIT