Dokmatiq DocGen

Dokmatiq DocGen MCP サーバー

Dokmatiq DocGen のドキュメント生成 API を、Codex、Claude Code、Claude Desktop、Cursor、Continue、Cline、Hermes などの AI アシスタント向けのツールとして公開する MCP（Model Context Protocol）サーバーです。

PDF、DOCX／ODT ドキュメント、Excel ワークブック、請求書、電子請求書（ZUGFeRD／XRechnung／Factur-X）、領収書のエクスポート、署名済み PDF、PDF フォーム、会社のレターヘッド（Briefpapier／Firmenpapier）付きドキュメントを生成できます。

セットアップ

前提条件

• Python 3.11+
• DocGen API キー

インストール

python3.11 -m pip install --user dokmatiq-docgen-mcp

このパッケージには Python 3.11 以降が必要です。macOS では、システムまたは Xcode に付属する python3 が古すぎる場合があります。pip で互換性のあるパッケージが見つからない場合は、Homebrew Python、pyenv、uv、またはその他の Python 3.11 以降のランタイムを使用してください。

pip install --user を実行すると、通常は docgen-mcp コマンドが ~/.local/bin にインストールされます。MCP クライアントが docgen-mcp を見つけられない場合は、~/.local/bin を PATH に追加するか、MCP 設定でコマンドの絶対パスを使用してください。

または、ソースからインストールします。

cd mcp
pip install -e .

テストの実行

リポジトリのルートから、チェックイン済みのロックファイルを使用して MCP サーバーをインストールし、stdio／クライアントのスモークテストを実行します。

uv run --project mcp python -m unittest discover -s mcp/tests -v

設定

API キーを環境変数として設定します。

export DOCGEN_API_KEY=dk_live_xxx

必要に応じて、ベース URL を上書きします。

export DOCGEN_BASE_URL=https://custom.api.endpoint.com

Claude Desktop での使用

Claude Desktop の設定（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "docgen": {
      "command": "/Users/you/.local/bin/docgen-mcp",
      "env": {
        "DOCGEN_API_KEY": "dk_live_xxx"
      }
    }
  }
}

または、uvx を使用します。

{
  "mcpServers": {
    "docgen": {
      "command": "uvx",
      "args": ["dokmatiq-docgen-mcp"],
      "env": {
        "DOCGEN_API_KEY": "dk_live_xxx"
      }
    }
  }
}

Claude Code での使用

claude mcp add docgen -- docgen-mcp

API キーを環境または .env ファイルで設定します。

Codex での使用

付属のスキルをインストールします。

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo dokmatiq/docgen-sdks \
  --path plugin/skills/dokmatiq-docgen

次に、docgen という名前の MCP サーバーを、docgen-mcp、/Users/you/.local/bin/docgen-mcp などの絶対パス、または uvx dokmatiq-docgen-mcp のいずれかを使って設定します。サーバープロセスから DOCGEN_API_KEY を利用できることを確認してください。

Hermes での使用

Hermes の設定（~/.hermes/config.yaml）に MCP サーバーを追加します。

mcp_servers:
  docgen:
    command: "uvx"
    args: ["dokmatiq-docgen-mcp"]
    env:
      DOCGEN_API_KEY: "dk_live_xxx"

dk_live_xxx を Dokmatiq API キーに置き換えてください。

MCP 設定での環境変数

使用しているクライアントのドキュメントに展開されると明記されていない限り、JSON MCP 設定ファイル内では ${DOCGEN_API_KEY} のようなシェルのプレースホルダーを使用しないでください。多くの MCP クライアントはこの値をそのままサーバーに渡すため、認証に失敗します。

利用可能なツール

ドキュメント生成

ツール	説明
generate_pdf_from_html	HTML を PDF に変換します
generate_pdf_from_markdown	Markdown を PDF に変換します
generate_document	テンプレート、フィールド、透かし、出力形式を指定して生成します
compose_document	セクションから複数パートのドキュメントを構成します
create_invoice	ZUGFeRD 準拠の請求書 PDF を作成します

PDF ツール

ツール	説明
merge_pdfs	複数の PDF を 1 つに結合します
extract_text_from_pdf	すべてのテキストコンテンツを抽出します
get_pdf_metadata	タイトル、作成者、ページ数を取得します
convert_to_pdfa	PDF/A のアーカイブ形式に変換します
rotate_pdf	ページを回転します

PDF フォーム

ツール	説明
inspect_pdf_form	フォームフィールドを型と値とともに一覧表示します
fill_pdf_form	フォームフィールドに入力します

デジタル署名

ツール	説明
sign_pdf	PKCS#12 証明書でデジタル署名します
verify_pdf_signatures	既存の署名を検証します
list_certificates	アップロード済みの証明書を一覧表示します

テンプレートとフォント

ツール	説明
list_templates	アップロード済みのテンプレートを一覧表示します
upload_template	ODT／DOCX テンプレートをアップロードします
delete_template	テンプレートを削除します
list_fonts	アップロード済みのフォントを一覧表示します

プレビュー

ツール	説明
preview_pdf_page	ページを PNG 画像としてレンダリングします
get_pdf_page_count	総ページ数を取得します

Excel ワークブック

ツール	説明
generate_excel	構造化 JSON から、スタイル付きの XLSX を生成します（シート、列、数式、スタイル、ウィンドウ枠の固定）
csv_to_excel	CSV を自動フィルターとスタイル付きヘッダーを備えた Excel に変換します
excel_to_csv	Excel シートのデータを CSV として抽出します
excel_to_json	Excel シートのデータを、型付きの値を含む構造化 JSON として抽出します
fill_excel_template	名前付きセルと範囲に値を入力して、Excel テンプレートを埋めます
inspect_excel	ワークブックのメタデータ（シート名、行数／列数、名前付き範囲）を確認します

電子請求書

ツール	説明
validate_zugferd	ZUGFeRD への準拠を検証します
extract_zugferd	ZUGFeRD PDF から請求書データを抽出します
validate_xrechnung	XRechnung XML を検証します
parse_xrechnung	XRechnung を構造化データに解析します
detect_xrechnung	XRechnung 形式を検出します

レシート認識（AI 搭載）

ツール	説明
extract_receipt	レシート画像から構造化データ（販売元、合計金額、VAT、明細、SKR03/04 勘定科目）を抽出します
extract_receipt_async	オプションの Webhook を指定して、レシートの非同期抽出を送信します
get_receipt_job	非同期抽出ジョブのステータスを確認します
get_receipt_job_result	完了したジョブの抽出結果を取得します
list_receipt_jobs	すべての非同期レシートジョブを一覧表示します
receipt_to_document	レシートを抽出し、経費報告書（PDF/DOCX/ODT）を生成します
export_receipts_csv	DATEV 互換の CSV としてレシートをエクスポートします
export_receipts_xlsx	Excel ワークブックとしてレシートをエクスポートします

プロンプトの例

接続すると、Claude に次のように依頼できます。

• "この HTML から PDF を生成してください：<h1>Hello World</h1>"
• "ACME GmbH から Kunde AG 宛てに、1 時間あたり 120€ で 8 時間のコンサルティングを行った請求書を作成してください"
• "この 2 つの PDF を結合してください"
• "この PDF からテキストを抽出してください"
• "この PDF のフォーム項目に、name=Max、date=12.04.2026 と入力してください"
• "このレシート画像からデータを抽出してください。販売元、合計金額、VAT の内訳が必要です"
• "これらのレシートを分析し、DATEV CSV としてエクスポートしてください"
• "このレシート写真から経費報告書の PDF を作成してください"

ライセンス

MIT