Fatture in Cloud

fattureincloud-mcp

Fatture in Cloud 用の MCP サーバーです。画面をクリックする代わりに、Claude（または任意の MCP クライアント）に話しかけて請求業務を管理できます。

アプリにはない機能を提供します。

• 定期請求書。 「毎月5日に、前月を件名に入れた請求書を Acme 宛てに再作成して、SdI に送信し、メールでも送ってください。」Fatture in Cloud には、この機能が標準でありません。
• 実際の複製。 請求書をコピーし、希望する明細だけを変更して、新しい日付、次の番号、再計算した支払期限、印紙税、支払口座を設定します。
• 一括操作。 1つのコマンドで、数十件の請求書を複製したり、SdI に送信したり、メールで送ったり、支払済みにしたりできます。操作前のプレビューが必須です。
• チェックとレポート。 顧客別の延滞債権、月別の売上と入金、簡易税制の上限額（85,000 €、現金主義）までの残額、印紙税の漏れ、未送信または却下された電子請求書、番号の欠番。
• 銀行照合。 取引明細（Intesa、UniCredit、Fineco、BPER、Poste、ING、Revolut、N26、Qonto、または任意の CSV/XLSX）をアップロードするか、PSD2 経由で口座を接続すると、各振込が該当する請求書に照合され、その日付で入金として記録されます。
• キャッシュフロー予測。 月ごとの予想入金、定期請求書、納税期限、固定費を確認でき、6月と11月に備えて毎月いくら積み立てればよいかも分かります。
• 税理士向けパッケージ。 CSV、PDF、XML、年間サマリーをまとめた ZIP を1つ作成します。
• 簡易税制の税金。 実際の入金額に基づいて代替税と INPS 社会保険料を見積もります。6月30日（確定納付額と第1回予定納税）および11月30日（第2回予定納税）の納付額、年間合計、積み立てる割合を確認できます。
• API v2 全体。 発行・受領した書類、顧客、仕入先、商品、売上明細、F24、アーカイブ、仕訳帳、添付ファイル、ごみ箱、設定に対応しています。専用ツールがない操作は api_request から実行できます。

英語：イタリアの請求書発行 SaaS である Fatture in Cloud 用の MCP サーバーです。定期請求書、書類の実質的な複製、電子請求書（SdI）の一括送信、売掛金と regime forfettario のレポートに加え、v2 API の完全な CRUD に対応しています。対象分野がイタリア固有のため、ツールの説明はイタリア語です。

依頼できることの例

• 「9月の請求書をすべて今日の日付で再作成して、プレビューを見せてください。」
• 「Acme 宛ての月次請求書を毎月5日に設定し、定額で、SdI とメールの両方に送ってください。」
• 「まだ支払っていないのは誰ですか？26番を、昨日入金済みとして支払済みにしてください。」
• 「簡易税制の上限まであといくらですか？このペースだと超えますか？」
• 「プロフォーマ請求書12を電子請求書に変換して、XML を確認してください。」
• 「77,47 € を超えていて、印紙税が付いていない請求書はありますか？」
• 「10月分の請求書の PDF を ~/Documenti/fatture にダウンロードしてください。」
• 「6月30日と11月30日に納める税金はいくらですか？請求書ごとにいくら積み立てる必要がありますか？」
• 「Intesa の取引明細（~/Downloads/movimenti.xlsx）です。入金済みの請求書を支払済みにしてください。」
• 「11月の予定納税を払えるだけの残高はありますか？毎月いくら積み立てればよいですか？」
• 「納税期限を自分のカレンダーと Fatture in Cloud の F24 に登録してください。」
• 「税理士向けに2026年分のパッケージを準備してください。」
• 「SdI から届いた仕入先の請求書を、適切なカテゴリで登録してください。定期的な経費のうち、値上がりしたものはどれですか？」

インストール

Node.js 20 以降が必要です。

1. トークン

Fatture in Cloud で：

1. Impostazioni → App e API（開発者エリア）を開き、たとえば mcp-fattureincloud というプライベートアプリケーションを作成します。
2. 「Autenticazione e accesso」で**「Token personale」だけ**にチェックを入れ、OAuth 2.0 のチェックを外します。これで Redirect URL は不要になります。保存します。
3. アプリのページからトークンを生成します。会社と権限を選択します。発行済み書類と顧客については、少なくとも読み取りと書き込みが必要です。レポートと税金については、その他の項目への読み取り権限があれば十分です。管理したいその他のリソースには、書き込み権限を追加してください。
4. トークンをコピーします。トークンは再表示されません。チャットに貼り付けないでください。MCP クライアントの設定、または ~/.config/fattureincloud-mcp/.env に保存します。

個人用トークンに有効期限はなく、同じページから取り消せます（公式ガイド）。

2. MCP クライアント

Claude Desktop、ワンクリックで設定。 最新のリリースから fattureincloud-mcp-x.y.z.mcpb をダウンロードし、ダブルクリックして開き、求められたらトークンを貼り付けます。設定ファイルを編集する必要はなく、トークンはシステムのキーチェーンに保存されます。

Claude Code

claude mcp add --scope user fattureincloud -e FIC_ACCESS_TOKEN=il-tuo-token -- npx -y fattureincloud-mcp

手動設定（claude_desktop_config.json、Cursor、Windsurf など）：

{
  "mcpServers": {
    "fattureincloud": {
      "command": "npx",
      "args": ["-y", "fattureincloud-mcp"],
      "env": { "FIC_ACCESS_TOKEN": "il-tuo-token" }
    }
  }
}

その他の例は examples/ を参照してください。パッケージが npm に公開されるまでは、fattureincloud-mcp の代わりに github:NiccoloSalvini/fattureincloud-mcp を使用してください。

変数

変数
FIC_ACCESS_TOKEN	必須
FIC_COMPANY_ID	任意：トークンから見える会社が1社だけの場合は自動的に選択されます。それ以外の場合、各ツールで company_id を指定できます
FIC_TOOLSETS	任意：一部のツールグループだけを読み込みます。例：documents,automation,reports,taxes,bank（下記参照）。ツールは123個あります。グループを絞ると、モデルの選択精度が上がり、コンテキストの消費量も減ります。
FIC_QUOTA_RESERVE	任意：残しておく1時間あたりのリクエスト数（デフォルトは25）。API の上限は1時間あたり1,000件、月あたり40,000件で、プライベートアプリ間で共有されます。サーバーは応答のたびにカウンターを読み取り、上限に達する前に停止します。残りのリクエスト数は api_quota で確認できます
FIC_MCP_DATA_DIR	定期処理データの保存先。デフォルトは ~/.config/fattureincloud-mcp

変数は ~/.config/fattureincloud-mcp/.env に FIC_ACCESS_TOKEN=... の形式で記述することもできます。スケジュールジョブにはこの方法をおすすめします。

定期請求書

Fatture in Cloud にはスケジュール機能がないため、定期実行の設定はお使いのコンピューターの ~/.config/fattureincloud-mcp/schedules.json に保存され、毎日のジョブによって実行されます。

1. Claude に依頼して作成します。たとえば、プロンプト nuova_ricorrenza を使います。各定期実行には、次の項目があります。

   • 毎回の期日にコピーされるテンプレート文書。
   • 頻度：N か月ごと、特定の日。31 は月末を意味します。
   • アクション：create は確認・送信する前の状態で請求書を作成します（請求額が変わる場合におすすめです）。create_and_send_sdi は XML を検証して送信します。
   • 任意で指定する顧客のメールアドレス。
   • 変更内容：行、金額、プレースホルダーを含むテキスト。

2. ジョブをインストールします（初回のみ）。

   npm i -g fattureincloud-mcp
   

   fattureincloud-mcp install-scheduler --hour 8
   

   macOS では、毎朝実行され、結果を通知する LaunchAgent を作成します。Mac がスリープ状態だった場合は、復帰時に実行されます。電源が切れていた場合は、次回の実行時に請求書が作成されます。Linux では、crontab に追加する行が表示されます。

便利なコマンド：

fattureincloud-mcp schedules

fattureincloud-mcp run-due --dry-run

プレースホルダーは、件名、備考、明細行で使用できます：{{mese}}、{{anno}}、{{mese_precedente}}、{{anno_mese_precedente}}、{{mese_successivo}}、{{trimestre}}、{{data}}。先頭を大文字にするには、|maiuscolo を追加します。たとえば、Consulenza {{mese_precedente}} {{anno_mese_precedente}} は、11 月 5 日には「Consulenza ottobre 2026」になります。

保証事項：

• 各定期実行で、期日ごとに作成される文書は最大 1 件です。次回の日付は請求書の作成前に保存され、ロックによってジョブと Claude の実行が重複しないようにします。問題が発生した場合、請求書は作成されませんが、重複することもなく、エラーは履歴に残ります。
• コンピューターの電源が複数の期間にわたって切れていた場合、再起動後に作成される文書は 1 件のみで、日付は当日になります。未処理の期間ごとに文書が作成されることはありません。そのため、番号は時系列順に保たれます。
• XML の検証に失敗した場合、請求書は作成されますが送信されず、エラーが通知されます。

ツール

123 個のツールがグループに分かれており、FIC_TOOLSETS で有効化できます。admin グループは常に有効です。

documents：発行済み文書

• list_/get_/create_/update_/delete_issued_document(s)
• duplicate_document：日付、番号、期日、変更内容を更新してコピーします
• transform_document：プロフォーマ → 請求書、見積書 → 注文書または請求書、DDT → 請求書
• join_documents：複数の DDT、注文書、見積書を 1 件の文書にまとめます
• mark_paid / mark_unpaid
• email_document
• verify_einvoice、send_einvoice（dry_run に対応）、get_einvoice_xml、einvoice_rejection_reason
• create_credit_note：SdI の要件に従い、元の請求書に紐付けた全額または一部のクレジットノートを作成します
• preview_totals：文書を作成せずに、Fatture in Cloud が計算した合計額（上乗せ額、VAT、源泉徴収、印紙税、分割払い）を取得します。duplicate_document のプレビューでも使用されます
• get_document_pdf：リンクの取得またはダウンロード
• upload_attachment
• get_new_document_defaults：次の番号とデフォルト値を取得します
• list_deleted_documents、recover_document

automation：一括処理と定期実行

• bulk_duplicate、bulk_send_einvoice、bulk_email：デフォルトで dry_run が有効です。ID のリストまたはフィルターを指定できます
• schedule_create、schedule_list、schedule_get、schedule_update、schedule_delete
• schedule_run_due、schedule_run_now

reports

• receivables_report：未回収の債権、期間別の延滞額、顧客別の債権
• revenue_summary：月別・顧客別の売上（発生主義）と入金額（現金主義）、簡易課税制度の上限と予測
• audit_documents：未送信または却下された電子請求書、印紙税の未納、支払期日超過、番号の確認
• client_statement：顧客の取引明細 税金
• tax_profile_set, tax_profile_get：係数、税率、社会保障、実際の納付額
• tax_estimate：6月30日と11月30日の納期限、年間合計、積み立てる金額
• regime_simulator：あなたの数値に基づき、簡易課税制度、通常課税制度、SRLを比較
• stamp_duty_report：四半期ごとの電子印紙税（F24 コード 2521-2524）。納期限にも反映されます
• quadro_lm：締め済みの年度の申告書における LM 欄の値

計画

• cashflow_forecast：キャッシュフローと月次積立額の予測
• tax_deadlines_export：税務上の納期限を .ics 形式および Fatture in Cloud の F24 にエクスポート
• accountant_package：税理士向けの年間 ZIP ファイル

銀行

• bank_reconcile：入金を請求書に紐付け、入金を記録
• bank_parse_statement、bank_formats
• bank_link_start、bank_link_finish、bank_accounts、bank_list_banks：Enable Banking による PSD2 接続

登録情報

• clients、suppliers、products と、payment_accounts、payment_methods、vat_types 設定の CRUD
• client_from_vat：VIES 経由で VAT 番号から顧客情報を取得。市町村と県も確認します
• lookup_city：郵便番号または名称から市町村を検索
• list_price_lists、get_price_list_items

受領済み：仕入請求書と経費

• received_documents の CRUD（経費、仕入クレジットノート）
• list_pending_received_documents、get_pending_received_document：SdI から届き、登録待ちの仕入先請求書
• register_pending_received_documents：カテゴリ、分割払い、支払い方法を指定して経費として登録します（dry_run はデフォルトで有効）
• suggest_expense_categories：仕入先の過去の履歴またはキーワードに基づいてカテゴリを提案
• recurring_expenses_report：継続的な取引のある仕入先、次回請求書の予定、年間合計、値上げ

会計：receipts_monthly_totals、および receipts（売上集計）、f24、archive_documents、cashbook_entries（仕訳帳）の CRUD

管理

• list_companies、get_company_info（プランの利用状況も確認できます）
• api_quota：1時間および1か月で残っている API リクエスト数
• lookup：VAT 税率、支払い方法、口座、費用・収益センター、カテゴリ、テンプレート、通貨、国など…
• list_sent_emails
• api_request：API v2 のその他すべてのエンドポイント

q フィルターは Fatture in Cloud の構文を使用します。例：date >= '2026-01-01' and entity.name like '%rossi%' または amount_gross > 1000。

組み込みプロンプト

• chiusura_mese：取り消し不能な操作を行わずに、月末の確認を一通り実施
• nuova_ricorrenza：ガイドに沿って定期請求書を作成

Tasse（定額税制）

tax_estimate は、Fatture in Cloud に記録された入金額をもとに、納付額と納付時期を見積もります。まず tax_profile_set でプロフィールを一度設定します。たとえば、Claude に「私は別個の年金管理制度に加入している専門職で、収益性係数は78％、税率は15％、VAT番号は2024年に取得しました」と尋ねて設定できます。

計算方法：

総所得	年間の入金額 × 収益性係数（専門職は78％、業種コードATECOに応じて67％、40％、86％、62％）
社会保険料	別個の年金管理制度の場合は総所得に対して26.07％、または職人・商業従事者向け制度（定額分と超過分、35％の任意減額あり）、または専門職基金
課税所得	総所得 − 年内に納付した社会保険料（前年分の残額＋予定納付額）
代替税	15％、該当する場合は最初の5年間は5％
6月30日	前年分の残額＋第1回予定納付額（税金と社会保険料）
11月30日	第2回予定納付額
予定納付額	税金：前年分の100％を2回に分けて各50％納付。51.65 €未満なら予定納付なし、257.52 €未満なら11月に一括納付。別個の年金管理制度：80％を2回に分けて各40％納付

当年の入金額は年末までの見込み額として算出されます。または、実際の入金額のみを使う（projection: "to_date"）か、ご自身の見積もり（revenue_estimate）を使うこともできます。計算された額とは異なる金額を納付した場合や、Fatture in Cloud 以外で入金があった場合は、overrides に年ごとの金額を入力してください。見積もりが正確になります。結果には、入金ごとに積み立てておくべき割合や、予定納付額が税額を上回る場合に予測方式が有利であることを知らせる警告も含まれます。

これは資金繰りの計画を目的とした見積もりであり、申告用の計算ではありません。税率や上限額は毎年変わります（既定値は2025年のもので、プロフィールから変更できます）。納付前に税理士に確認してもらうことをおすすめします。

買掛請求書（通常課税制度）

仕入先の請求書は SdI から Fatture in Cloud の受信済み・未処理の書類に届き、経費として登録するまでそこに残ります。サーバーはこれらをまとめて処理します。

1. list_pending_received_documents では、仕入先、日付、番号、課税対象額、VAT、合計額、支払期限、XML の有無を一覧表示します。デフォルトでは SdI から届いたもの（source: "agyo"）を表示します。all を指定すると、メールまたはブラウザーからアップロードされたものも含まれます。
2. suggest_expense_categories では、カテゴリを提案します。まず、過去 24 か月以内に同じ仕入先（VAT 番号、次に名前で照合）に使用したカテゴリを提案し、それがない場合は名前と説明に基づくルールを適用します（電気・ガス → 光熱費、TIM/Vodafone/Iliad/Fastweb → 電話・インターネット、Aruba/Google/AWS/Microsoft/GitHub/OpenAI/Anthropic → ソフトウェア・クラウドサービス、ENI/Q8 → 燃料、Amazon → 購入、会計士 → コンサルティング、賃貸 → 家賃）。各提案には信頼度と理由が含まれ、可能な場合は既存のカテゴリが使用されます。たとえば、Fatture in Cloud のデフォルトカテゴリでは、光熱費は「サービス・建物」、ソフトウェアは「サーバー・ホスティング」に分類されます。
3. register_pending_received_documents では、経費を作成します。各経費は未処理の書類（pending_id）に紐づけられるため、Fatture in Cloud には XML と添付ファイルが保持されます。API が支払い不足の経費を拒否するため、分割払いの合計額は常に税込み総額と一致する必要があります。paid、paid_date、payment_account_id を指定すると、支払い済みとして登録できます。最初はプレビューで実行されます。remove_pending を指定すると、書類は未処理リストからも削除されます。この操作は API の公開仕様に記載されていないため、拒否された場合でも経費は作成されたままとなり、結果にその旨が示されます。

recurring_expenses_report は過去 12 か月の経費を分析し、定期的に請求書を発行している仕入先を特定します。請求書が 3 件以上あり、月次、隔月（多くは光熱費の請求）、四半期、半年、または年次の周期で発行されている仕入先が対象です。仕入先ごとに、平均金額、直近の請求書、次回の請求予定日、推定年間総額を表示します。過去の平均より 10% を超えて値上がりした場合や、請求書の到着予定日から 15 日以上経過している場合は通知します。

すべてを読み取るのに必要なリクエストはわずかです。リストは 100 行ごとにページ分割され、書類ごとの呼び出しはありません。

定額課税制度では、購入請求書は税務上の影響がありません（控除対象の VAT も、損金算入可能な費用もありません）。ただし、記録や支払期限の管理のために登録することはできます。

銀行：入金の照合

bank_reconcile は取引明細を受け取り、入金ごとに対応する未決済請求書を検索して、入金日を支払日として登録します。定額課税制度では、現金主義で税額が計算されるため、この日付が基準となります。

照合。 各入金のスコアは、次の基準で算出されます。

基準	点数
請求書の分割払い額または残額と一致する金額	+50
最大 2 € 少ない金額（未払いの印紙税または手数料）	+30
摘要に記載された請求書番号（FT 26、fattura n. 26、26/2026）	+30
摘要に記載された顧客の VAT 番号または納税者番号	+30
摘要に記載された顧客名	最大 +25
請求書の日付より前の日付の支払い	−40

信頼度は 75 点以上が高、60 点以上が中、それ未満が低です。各入金が紐づく請求書は最大 1 件です。2 件の請求書が同じスコアの場合、照合の信頼度は中に下がり、曖昧な照合として通知されます。常にプレビューで実行されます。dry_run: false を指定すると、信頼度が min_confidence 以上の照合のみ登録されます（デフォルトは high）。同じファイルに対して再実行しても、同じ入金が二重に登録されることはありません。

ファイルから（任意の銀行）

インターネットバンキングから取引明細をダウンロードし、ファイルのパスを渡してください。認識される形式は自動判別されます（bank_formats）。

銀行	ファイル
Intesa Sanpaolo、Isybank	XLSX「Lista movimenti」、記帳済みの行のみ。入金／出金のCSV
UniCredit	CSV
Fineco	XLSX、CSV
BPER	XLS「Movimenti Conto」
Poste Italiane / BancoPosta	XLSX
ING Italia	CSV
Revolut、N26、Qonto	CSV
その他	日付、金額（または入金と出金）、説明が含まれる任意のCSV／XLSX。列は自動認識されるか、mapping で指定できます

形式は、他のオープンソースプロジェクト（ynab-transformer、BananaAccounting、bankr.isp）で使われている実際のエクスポートデータに基づいています。利用している銀行が異なる形式でエクスポートする場合は、列見出しを添えて issue を作成してください。

直接接続（PSD2、任意）

Intesa を含むイタリアの銀行は、個人向けに PSD2 API を提供していません。認可された仲介業者のみが利用できます。Enable Banking を経由します。Enable Banking では、自分の口座を使う個人の非商用利用向けに無料モードが用意されています。対応銀行は Intesa Sanpaolo、UniCredit、BPER、Banco BPM、Poste、Fineco、ING、Mediolanum、Crédit Agricole、MPS、BCC です。

1. enablebanking.com/cp に登録し、production アプリケーションを作成します。リダイレクト URL には https://localhost:8765/callback を設定してください。実際に存在している必要はありません。

2. 生成された秘密鍵 .pem をダウンロードし、「Activate by linking accounts」でアプリを有効化して、自分の口座を連携します。アプリは restricted モードになり、自分の口座のみを参照できます。

3. ~/.config/fattureincloud-mcp/.env に次を設定します。

   ENABLE_BANKING_APP_ID=...
   ENABLE_BANKING_KEY_PATH=~/.config/fattureincloud-mcp/enablebanking.pem
   ENABLE_BANKING_REDIRECT_URL=https://localhost:8765/callback
   

4. Claude に「自分の Intesa 口座を接続して」と依頼します（bank_link_start）。リンクを開き、銀行のアプリで認証して、最終ページのアドレスを貼り付けます。ブラウザーにエラーが表示されても構いません（bank_link_finish）。同意の有効期間は最長 180 日で、その後は更新が必要です。多くの銀行では、一度に有効にできる同意は 1 つだけです。

5. 以降はファイルを指定せずに bank_reconcile を実行するだけで、連携済み口座から直近 90 日分を読み込みます。

セッションは bank-sessions.json に保存され、読み取り可能なのは自分のユーザーのみです。鍵は自分のコンピューターに保存されます。

税制シミュレーター

regime_simulator は、同じ売上と費用をもとに、各制度で手元に残る金額を比較します。

• 定額課税制度：税率 5% または 15%。
• 通常課税制度：個人事業主。自営業者控除と地方付加税を含む、累進税率 23／33／43% の IRPEF。
• 一人株主の SRL：IRES 24%、IRAP 3.9%、配当税 26%。管理者報酬は税負担が最小になるように設定され、会社の固定費も含まれます。

定額課税制度が有利でなくなる売上水準も示します。

デフォルトでは、年間入金額の予測と税務プロフィールのパラメーターを使います。最初の 5 年間に該当する場合は、税率を 15% にして比較を繰り返し、その後に何が変わるかを示します。実費（costs）が考慮されるのは通常課税制度と SRL のみです。これは一定の事業状況を想定した 1 年分の比較であり、税理士に相談するタイミングを判断するための参考情報です。これだけで判断しないでください。

計画

• cashflow_forecast：12か月分の月ごとの予想収入と支出を表示します。回収予定の分割払い（当月が期限のもの）、典型的な支払遅延を反映した今後の定期請求書、推定税務期限、指定した固定費を計上します。opening_balance を指定すると、予想残高と残高がマイナスになる月の警告が表示されます。また、すべての税務期限に間に合うように確保すべき最低月額も計算します。tax_fund を指定すると、すでに確保してある金額を考慮します。
• tax_deadlines_export：推定税務期限を、7日前と1日前のリマインダー付きの .ics ファイルにして、カレンダー、Google、Outlook にインポートできるようにします。また、Fatture in Cloud の支払期限一覧に、支払う F24 として登録します。再実行すると、重複登録せずに金額を更新し、支払済みの F24 には手を加えません。
• accountant_package：commercialista-AAAA.zip には、fatture.csv、incassi.csv、crediti_aperti.csv、spese.csv（区切り文字は ;、小数点はカンマで、Excel でそのまま開けます）、請求書とクレジットノートの PDF、FatturaPA XML、収益、簡易税制の上限、税額の見積もり、チェック項目をまとめた riepilogo.md が含まれます。

HTTP サーバー

共有環境（チーム、サーバー、n8n など）にインストールする場合：

fattureincloud-mcp http --port 3000 --host 0.0.0.0

サーバーはステートレスで、認証情報を保持しません。各リクエストには認証情報を含めます：Authorization: Bearer <token>（または X-FIC-Token）と、必要に応じて X-FIC-Company を指定します。エンドポイントは POST /mcp、状態確認用エンドポイントは GET /health です。インターネットに公開する場合は、HTTPS の背後に配置してください。

セキュリティ

• 外部への操作（SdI への送信、メール送信）には破壊的操作のマークが付いているため、MCP クライアントは確認を求めます。一括操作はプレビューから開始します。
• SdI に送信した電子請求書は削除できません。修正できるのはクレジットノートによる方法だけです。そのため、send_einvoice は送信前に必ず XML を検証します。
• トークンはコンピューター上に保存するか、HTTP モードでは各リクエストのヘッダーに含めます。定期処理の設定はローカルの JSON ファイルです。

開発

npm install

npm test

npm run build

node scripts/smoke.mjs は、読み取り専用ツールのみを使って、実際のアカウントでサーバーをテストします（トークンは ~/.config/fattureincloud-mcp/.env に保存）。node scripts/smoke.mjs <tool> '<json>' は、個別のツールを呼び出します。

テストは、メモリ内で接続された実際の MCP クライアントを使い、模擬 Fatture in Cloud API（test/fake-api.ts）に対して実行されるため、アカウントには触れません。実際のアカウントで試す場合は、テスト用の会社と dry_run を使用してください。

構成：

• src/client.ts：API v2 の HTTP クライアント（429 エラー時の再試行、わかりやすいエラーメッセージ）
• src/copy.ts：複製ロジックとプレースホルダー
• src/schedules.ts、src/runner.ts：定期処理
• src/reports.ts：売掛金、収益、チェック項目（純粋関数）
• src/taxes.ts：簡易税制の税金と拠出金のモデル
• src/expenses.ts：仕入請求書、支出カテゴリ、定期支出（純粋関数）
• src/cashflow.ts、src/ics.ts、src/accountant.ts：計画
• src/bank/：銀行取引明細のパーサー、照合、Enable Banking クライアント
• src/tools/：ツールの定義。CRUD は crud.ts のテーブルから生成されます

リリース

package.json の version を更新してから、タグを作成してプッシュします：

git tag v0.3.0 && git push origin v0.3.0

GitHub Action の release.yml はテストを実行してから、次の処理を行います：

• trusted publishing を使用し、OIDC 経由でトークンなしで npm に公開します。provenance は自動的に付与されます。
• .mcpb 拡張子のリリースを作成します（npm run build:mcpb でローカルでも生成できます）。
• MCP レジストリに掲載情報を公開します。

PR を歓迎します。このプロジェクトは Fatture in Cloud または TeamSystem とは提携していません。

ライセンス

MIT