DATEV EXTF

datev-extf-mcp

**DATEV-Format（EXTF）**ファイルを検証・作成する MCP サーバーです。Buchungsstapel（仕訳データ）と Debitoren/Kreditoren（顧客および仕入先のマスターデータ）に対応しています。DATEV がインポートを拒否した理由を AI アシスタントに尋ねたり、仕訳の一覧を DATEV が受け付けるファイルに変換させたりできます。

ドイツ語： DATEV-Format（EXTF）ファイルを検証・作成する MCP サーバーです。DATEV がインポートを拒否した理由を AI アシスタントに尋ねると、売上金額の小数点がコンマではなくピリオドになっている、伝票日付の先頭にゼロがない、自動処理勘定に BU キーが設定されている、といった問題が、行番号、フィールド、わかりやすい説明とともに返されます。

• ローカルのみで動作します。 サーバーはお使いのマシン上で実行され、ディスク上のファイルを読み込みます。ファイルがアップロードされることはなく、アカウントや API キーも必要ありません。
• @seamless-engineering/datev-extf を基盤にしています。ルールは、developer.datev.de の Formatbeschreibung、DATEV-Format Prüfprogramm、#REW インポートメッセージなど、DATEV の公式資料に基づいています。
• writer が作成するファイルはすべて、バリデーターで検証済みです。

ブラウザーで使いたい場合は、同じチェックをDATEV EXTF validator（英語）でも利用できます。こちらもファイルをアップロードせずに使えます。

インストール

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

Claude Code

claude mcp add datev-extf -- npx -y @seamless-engineering/datev-extf-mcp

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）およびその他ほとんどのクライアント：

{
  "mcpServers": {
    "datev-extf": {
      "command": "npx",
      "args": ["-y", "@seamless-engineering/datev-extf-mcp"]
    }
  }
}

Claude Desktop、ワンクリック： 最新リリースから datev-extf-mcp.mcpb をダウンロードして開いてください。./scripts/bundle.sh を使って自分でビルドすることもできます。

相対ファイルパスはサーバーの作業ディレクトリを基準に解決されるため、絶対パスの使用をおすすめします。

ツール

ツール	機能
validate_datev_extf	ファイル（path）または貼り付けたテキスト（content）をチェックします。ヘッダーデータ、エラーと警告の件数、および各検出結果の行番号、フィールド、値、ドイツ語（lang: "de"、デフォルト）または英語（"en"）による説明を返します。文字コードのチェックはファイルのみが対象です。
explain_datev_finding	amount-dot や bu-automatic などの検出コードについて説明します。
write_buchungsstapel	ヘッダーと仕訳行（金額はセント単位）から Buchungsstapel（フォーマットバージョン 13）を作成し、検証したうえで、Windows-1252 で outputPath に書き込むか、CSV テキストを返します。
list_datev_columns	Buchungsstapel の 125 列、または Debitoren/Kreditoren の 254 列を、位置とともに一覧表示します。

リソース：datev-extf://columns/buchungsstapel、datev-extf://columns/debkred、datev-extf://findings/de、datev-extf://findings/en。

プロンプト：fix_datev_import はファイルを検証し、そのファイルを生成したエクスポートに対する修正案を提示します。

使用例

DATEV が ~/Downloads/EXTF_Buchungsstapel.csv を拒否するのはなぜですか？

2 errors, 1 warning in 214 data rows (category buchungsstapel, encoding utf-8).
- warning [utf8-without-bom]: The file is UTF-8 without a byte order mark. DATEV then reads it as Windows-1252 and umlauts turn into garbage …
- error line 4 [amount-dot]: Amount “49.90” uses a dot as the decimal separator. DATEV expects a comma: 12.50 becomes 12,50.
- error line 9 [date-leading-zero]: Document date “506” has only three digits: the leading zero is gone. …

税務に関するアドバイスではありません

このサーバーがチェックするのはフォーマットであり、帳簿の内容ではありません。取引に適した勘定科目や税キーを判断することはできず、ファイル作成時にそれらを選ぶこともありません。これらについては税理士にご相談ください。

DATEV および DATEV-Format は DATEV eG の商標です。本プロジェクトは DATEV と提携しておらず、DATEV の推奨を受けているものでもありません。

メンテナンス

seamless.engineering が自社の本番環境での利用を目的にメンテナンスしています。当社は、ショップ、決済プロバイダー、ERP 向けに、EU 内で完全にホストされたマネージド DATEV 連携を提供しています。Issue と PR を歓迎します。SLA はありません。

リリース

package.json の version、server.json の両方のバージョン、および manifest.json のバージョンを更新してコミットし、タグを付けてプッシュします：git tag v0.1.1 && git push origin v0.1.1。リリースワークフローでは、信頼されたパブリッシングを通じてプロビナンス付きで npm に公開した後、MCP Registry に engineering.seamless/datev-extf として公開します。

MIT ライセンス。