Agente による Invoice4U MCP

非公式のサードパーティ製 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 境界で 10 進数の文字列（"12500.00"）として表現され、JavaScript の浮動小数点数では決して表現されません。HTTP 200 を返しながら Errors コレクションにアプリケーションエラーを含む Invoice4U の応答は、型付けされたエラーモデルに正規化され、成功として報告されることはありません。

設定

認証情報は環境変数にのみ存在します。トークンがツールの引数として受け入れられることはなく、返されることも、ログに記録されることもありません。

.env.example を参照してください。レビュー済みの公式 Invoice4U ホストのみに接続されます。任意のベース URL を指定できる逃げ道はありません。

安全性モデル

• デフォルトで読み取り専用 — 書き込みツールは、書き込みが明示的に有効化されない限り tools/list から完全に除外されます。

• 冪等な書き込み — 必須の安定した apiIdentifier。同じリクエストを再送信しても 2 枚目の領収書は作成されません。

• 検証済みの書き込み — すべての書き込みは領収書と参照された請求書を再取得し、以前と新しい残高およびステータスを構造化出力として返します。

• 不確実な書き込み結果の盲目的再試行なし。解決は 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 とは提携関係にありません。