ContaBridge

contabridge-mcp

スペインの会計ソフトとQuickBooks／Xeroの間で帳簿データをやり取りするMCP サーバーです。複数の顧客を抱える gestorías や会計事務所で働くAI エージェント向けに作られています。呼び出しの間にデータを保存せず、すべての結果は決定論的です。

ツール	クレジット	機能
convert_journal	2	a3ASESOR/a3ECO/a3CON（SUENLACE.DAT）、Sage ContaPlus／Sage 50（142フィールドのDiario CSV、またはXDiario ASCII）、スプレッドシートCSV（Holded、Excel、任意のERP）、QuickBooks（Desktop IIF、Online仕訳CSV）、Xero（手動仕訳CSV）の間で仕訳帳を変換します。補助科目コードを桁数に合わせて調整し（4300001 → 43000001、430.1 → 43000001）、勘定科目名を変更し、仕訳番号を振り直します。
bank_to_journal	3	Norma 43の銀行明細を、572補助科目を相手勘定とする仕訳に変換します。順序付きルールで、テキスト、正規表現、AEBコンセプト、または方向に基づいて相手勘定を割り当てます。どのルールにも一致しない明細は555に割り当てられ、一覧表示されます。
build_journal	2	エージェントが作成した仕訳（請求書、給与、見越計上）を、いずれかの形式で出力します。
bank_statement_csv	1	Norma 43の明細を、Xero用（事前コード化されたテンプレート）またはQuickBooks Online用（3列）の銀行明細CSVに変換します。
validate_journal	1	A3およびContaPlusがインポート時に行うチェックを実行します。仕訳の貸借一致、各明細行の借方または貸方（一方のみ）、PGCグループ、会計年度、勘定科目コードの桁数の混在を確認します。
resize_account、detect_format、pricing、credits_balance	0	無料のヘルパーです。

出力ファイルはcontentとcontent_base64として返されます。Base64版はWindows-1252で、改行コードはCRLFです（CSVはBOM付きUTF-8）。これが各プログラムでインポートされる形式です。

課金の仕組みは次のとおりです。

• 拒否されるファイル（貸借不一致、読み取り不能、列不足）は、クレジットが課金される前に拒否されます。
• 課金後に失敗した場合、クレジットは返金されます。

対応形式とデータソース

• A3：「Enlace contable de entrada. Descripción de registros」（Wolters Kluwer）。レコードタイプ0、フォーマット5（512バイト）およびフォーマット4（256バイト）に対応しています。読み込み時、請求書レコード（タイプ1、2、9）はスキップされ、警告で報告されます。
• ContaPlus：「Protocolo de comunicación de programas de gestión con ContaPlus」（Sage、2023）。Asien、Fecha、SubCta、Contra、Concepto、Documento、MonedaUso=2、EuroDebe、EuroHaberを書き込みます。固定幅ASCII版（32フィールド）は、オープンソースのBulmaGésエクスポーターと同じレイアウトを使用します。
• QuickBooks Desktop IIF：GENERAL JOURNALトランザクション（タブ区切りの!TRNS／!SPL／!ENDTRNS）に対応しています。借方は正、貸方は負の値であるため、TRNS金額はSPL行の合計にマイナスを付けた値です。その他のIIFリスト（勘定科目、顧客）はスキップされ、警告が表示されます。
• QuickBooks Online：「仕訳のインポート」CSV（Journal No., Journal Date, Account Name, Debits, Credits, Description, Name）に対応しています。
• Xero：「手動仕訳のインポート」テンプレート（*Narration, *Date, Description, *AccountCode, *TaxRate, *Amount、追跡項目）に対応しています。同じNarrationとDateを持つ行は、ひとつの仕訳になります。xero_tax_rateは、その組織で使用されている名称に合わせてTaxRateを設定します（英国ではNo VAT、オーストラリアではBAS Excluded、ニュージーランドではNo GST、米国ではTax Exempt）。
• QuickBooksとXeroの日付形式はdate_styleに従います。mdy（QuickBooksのデフォルト）、dmy（Xeroのデフォルト）、またはisoを指定できます。金額には小数点を使用し、カンマは常に桁区切りとして読み取られます。勘定科目は名称またはコードで指定されるため、PGCではなく各ソフトウェア独自の勘定科目表に照らして検証されます。A3／ContaPlusとの変換では、勘定科目を対応付けるためにaccount_mapを使用します。
• CSV：列名はスペイン語と英語（fecha、cuenta、debe、haber、importe+d/hなど）から検出されます。またはcolumn_mapで指定できます。仕訳番号のないファイルでは、貸借が一致するまで行を累積して仕訳ごとにまとめます。

インストール

必要なのはKeyFlintライセンス（LIC-...）だけです。ゲートウェイURL、公開鍵、チェックアウトリンクにはデフォルト値があります。

Claude Desktop、ワンクリック：最新リリースからcontabridge-mcp-X.Y.Z.mcpbをダウンロードし、ダブルクリックしてライセンスを貼り付けます。ターミナルもJSONも不要です。

Claude Code：

claude mcp add contabridge -e KEYFLINT_LICENSE=LIC-... -- uvx contabridge-mcp

Cursor、Windsurf、Claude Desktop（JSON）：

{
  "mcpServers": {
    "contabridge": {
      "command": "uvx",
      "args": ["contabridge-mcp"],
      "env": { "KEYFLINT_LICENSE": "LIC-..." }
    }
  }
}

任意の設定：KEYFLINT_URL、KEYFLINT_PUBLIC_KEYS（未設定の場合はゲートウェイから取得され、~/.keyflint/keyring.jsonにキャッシュされます）、KEYFLINT_CHECKOUT_URL。

ホストモード：CONTABRIDGE_TRANSPORT=http contabridge-mcp --http（リクエストごとにライセンスを指定し、Authorization: Bearer LIC-...を使用します）。

調整：CONTABRIDGE_PRICES（convert_journal=3,bank_to_journal=5）、CONTABRIDGE_MAX_BYTES。

ビジュアルカード（MCP Apps）

Claude、ChatGPT、VS Code、Gooseでは、すべての有料ツールとcredits_balanceがチャット内でインタラクティブなカードとして表示されます。クレジット残高には補充バーと購入ボタンが、結果の要約には主要な数値、問題、テーブルのプレビュー、請求されたクレジット数が表示されます。これはui://contabridge/card.htmlリソースで、自己完結しておりネットワークアクセスはありません。それ以外のクライアントには、引き続き従来と同じJSONが返されます。

Claudeスキル

skills/contabridge/SKILL.md（distribution/contabridge-skill.zipに圧縮されています）には、どのツールを使うか、どの長さの口座番号を尋ねるか、ファイルをどのように保存するかが記載されています。

テスト

pip install -e '.[test]' && pytest

テストではKeyFlintゲートウェイの偽物とローカルで署名したライセンスを使用するため、ネットワーク接続は不要です。A3およびContaPlusのレイアウトは、公式仕様と位置ごとに照合されます。

ライセンス

Business Source License 1.1。ソースコードは公開されています。商用利用にはKeyFlintライセンスが必要です（または非営利である必要があります）。各バージョンはリリースから4年後にApache 2.0になります。LICENSEをご覧ください。