pdfvera

pdfvera MCP サーバー

Claude や Cursor などの AI アシスタントが、pdfvera で書類を変換できるようにします。

• ドイツの PDF 請求書を電子請求書に変換： XRechnung 3.0（UBL および CII）と ZUGFeRD PDF（EN 16931）を作成し、公式の KoSIT ルールに照らして検証したうえで、チェックレポートを出力します。必須データが不足している場合は、アシスタントが入力を求めます。
• ブラジルの銀行明細書 PDF（extrato bancário）を OFX、CSV、Excel に変換： Domínio、Alterdata、Conta Azul、Omie 向けの OFX を作成します。明細の合計が、明細書に記載された残高と一致する場合にのみファイルを書き出します。

サーバーはお使いのコンピューター上で動作します。ディスクから PDF を読み込み、API キーを使って pdfvera API に送信し、結果ファイルを PDF と同じ場所に書き出します。

必要条件

• pdfvera のプラン。API とこのサーバーはすべてのプランに含まれており、ウェブサイトと同じ月間クォータが適用されます（Preise、Preços）。ファイルを書き出さずに PDF をチェックする場合（check_only）、料金はかかりません。
• pdfvera アカウントで作成した API キー（Konto、Conta）。
• Node.js 18 以降（Claude Desktop 拡張機能では不要です）。

インストール

Claude Code

claude mcp add pdfvera -e PDFVERA_API_KEY=pv_YOUR_KEY -- npx -y pdfvera-mcp@latest

または、プラグインとしてインストールできます。このプラグインには MCP サーバーは含まれておらず、Claude が curl で pdfvera API を呼び出すためのスキルです。キーは PDFVERA_API_KEY から読み込むため、まず { "env": { "PDFVERA_API_KEY": "pv_YOUR_KEY" } } を ~/.claude/settings.json に追加し、その後、次を実行します。

/plugin marketplace add pdfvera/pdfvera-mcp
/plugin install pdfvera@pdfvera

Cursor（~/.cursor/mcp.json）およびその他の MCP クライアント

{
  "mcpServers": {
    "pdfvera": {
      "command": "npx",
      "args": ["-y", "pdfvera-mcp@latest"],
      "env": { "PDFVERA_API_KEY": "pv_YOUR_KEY" }
    }
  }
}

Claude Desktop： pdfvera.mcpb をダウンロードして開き、API キーを入力します。

ツール

ツール	機能
convert_invoice	PDF 請求書を XRechnung（UBL、CII）、ZUGFeRD、チェックレポートに変換します。不足している項目は質問として返され、回答や修正内容は次回の呼び出しに反映されます。
convert_bank_statement	残高をチェックしたうえで、ブラジルの銀行明細書 PDF を OFX、CSV、Excel に変換します。パスワードで保護された PDF（password または cpf）にも対応しています。
get_usage	ご利用中のプランと、月間クォータの使用量を確認できます。

変換した書類 1 件につき、月間クォータを 1 回分消費します。同じ月に同じ PDF を再度変換しても消費されません。check_only はクォータを消費しません。

プロンプトの例

• 「~/Rechnungen/RE-2026-0042.pdf を XRechnung に変換してください。公的機関に送付した請求書です。」
• 「~/Rechnungen/November にあるすべての PDF を、クォータを使わずに電子請求書に変換できるかチェックしてください。」
• 「~/Downloads/extrato-itau-outubro.pdf の明細書を、Domínio 向けの OFX に変換してください。」
• 「明細書の PDF はパスワードで保護されています。口座名義人の CPF は 123.456.789-09 です。もう一度試してください。」
• 「今月はあと何回変換できますか？」

プライバシーポリシー

このプログラムは何も保存しません。指定された PDF とお客様の回答を HTTPS 経由で pdfvera.com に送信し、結果をディスクに書き出します。アップロードされた書類の pdfvera による取り扱いについては、プライバシーポリシーをご覧ください。Datenschutzerklärung（請求書）およびPolítica de privacidade（銀行明細書）。概要は次のとおりです。請求書 PDF は EU 内で処理され、保存されません。API 経由で送信された銀行明細書 PDF も保存されません。同じ書類が二重にカウントされないよう、変換した PDF のハッシュのみを保存します。pdfvera のルールで読み取れない銀行明細書は、明細を読み取るために Anthropic API に送信されます。Anthropic はそのデータを 30 日以内に削除し、学習には使用しません。

トラブルシューティング

• 「pdfvera API key がありません」：サーバー設定で PDFVERA_API_KEY を設定し（プラグインの場合は ~/.claude/settings.json の env 内）、アシスタントを再起動してください。
• 「API キーが見つからない、誤っている、または取り消されています」：pdfvera アカウントで新しいキーを作成してください。
• 「有効なプランがありません」／「クォータを使い切りました」：ファイルにはプランが必要です。check_only はプランなしで動作します。
• アシスタントにツールが表示されない：node --version が 18 以上を表示することを確認し、アシスタントを再起動してください。
• 変換されない、フィールドが不足している：アシスタントが一覧にあるフィールドを尋ねます。pdfvera.com で回答することもできます。

サポート

質問やバグの報告：GitHub のイシューまたは [email protected]。セキュリティに関する報告は、SECURITY.md をご覧ください。

ライセンス

この MCP サーバーは MIT ライセンスです。pdfvera サービス自体には、利用規約が適用されます。