lexware

lexware-mcp-server

Lexware Office API 用の MCP サーバーです。Model Context Protocol を通じて、請求書、連絡先、商品、伝票などを管理できます。

非公式のコミュニティプロジェクト — Lexware GmbH および Haufe Group とは提携していません。免責事項をご覧ください。

要件

• Node.js 20 以降。
• Lexware Office API の設定から取得した Lexware Office API トークン。

クイックスタート

1. トークンを OS のキーリングに保存する

サーバーは、まず OS のキーリング（サービス lexware-mcp、アカウント api-token）からトークンを読み込み、キーリングにない場合は LEXWARE_API_TOKEN 環境変数を使用します。キーリングの使用を推奨します。そうすれば、MCP の設定に認証情報を保存せずに済みます。

以下のコマンドはトークンの入力を促すため、シェルの履歴やプロセス一覧にトークンが残ることはありません。

macOS：

security add-generic-password -s "lexware-mcp" -a "api-token" -w

Linux（Secret Service / libsecret が必要です）：

secret-tool store --label="Lexware Office API" service lexware-mcp username api-token

Windows、ヘッドレスマシン、環境変数へのフォールバックについては、設定ガイドをご覧ください。

2. MCP クライアントにサーバーを追加する

{
  "mcpServers": {
    "lexware": {
      "command": "npx",
      "args": ["-y", "@lazyants/lexware-mcp-server"]
    }
  }
}

たとえば Claude Desktop の claude_desktop_config.json など、クライアントの MCP 設定にこれを追加します。Claude Code では、次のコマンドを実行します。

claude mcp add --scope user lexware -- npx -y @lazyants/lexware-mcp-server

npx がパッケージをダウンロードして実行するため、別途インストールする必要はありません。クライアントを再起動すると、ツール一覧に Lexware のツールが表示されます。

エントリーポイント

このパッケージには、すべての機能を備えたサーバーと、それぞれ特定の分野を担当する小規模な分割サーバーがあります。コンテキストサイズを抑えたい場合や、MCP クライアントのツール数上限を超えないようにする場合は、分割サーバーを使用してください。

コマンド	対応範囲
lexware-mcp-server	以下のすべて
lexware-mcp-sales	請求書、クレジットノート、見積書、注文確認書、納品書、前受金請求書、督促状、伝票一覧
lexware-mcp-contacts	連絡先、商品
lexware-mcp-bookkeeping	伝票、伝票一覧、支払い
lexware-mcp-reference	国、支払い条件、転記カテゴリ、プロフィール、印刷レイアウト
lexware-mcp-system	イベントサブスクリプション、ファイル、定期テンプレート

npx -y -p @lazyants/lexware-mcp-server lexware-mcp-sales を使用して分割サーバーを実行できます。設定ガイドには、分割サーバーや複数の Lexware アカウント向けのクライアント設定例があります。

ツールの機能

ツール名は lexware_<action>_<resource> の形式です。たとえば、lexware_create_invoice や lexware_list_voucherlist です。請求書や見積書などの販売伝票の作成・読み取り、連絡先や商品管理、帳簿伝票の記録、伝票種別をまたいだ検索、ファイルのアップロードとダウンロード、Webhook サブスクリプションの管理を行います。各ツールの説明と入力スキーマを含む、MCP クライアントのツール一覧が、利用できるツールの正式な一覧です。

すべてのエントリーポイントで、API の規約、テキストの書式ルール、Webhook に関するガイダンスを記載した読み取り専用の MCP リソース reference://lexware/api も利用できます。

利用ガイドでは、作成時の確定、伝票検索フィルター、伝票の更新、ファイルのアップロードとダウンロード、Webhook など、API を利用する際の注意事項を説明しています。

セキュリティ

• OS のキーリングを使用し、API トークンをバージョン管理にコミットしないでください。
• 作成、更新、削除、アップロード、および追跡ツールは、Lexware アカウントの実際の業務データを変更します。追跡ツールはフォローアップ文書を作成します。
• LEXWARE_READ_ONLY=true を設定すると、サーバーはデータを変更するすべてのツールを拒否します。読み取り専用モードを参照してください。
• 読み取り専用モードを使用しない場合、意図しない変更を防ぐものが 2 つあります。Lexware が適用する Lexware API トークンの権限と、MCP クライアントの承認プロンプトです。readOnlyHint などのツール注釈はクライアントへのヒントであり、チェック機能ではありません。
• 分割サーバーでは使用できるツールが少なくなりますが、その大半には依然としてデータを変更するツールが含まれます。慎重に設定する場合は、サーバーが変更できる内容を制限するを参照してください。
• レート制限に達したリクエスト（HTTP 429）は、指数バックオフを使用して自動的に再試行されます。

脆弱性を報告するには、SECURITY.mdを参照してください。

ドキュメント

• 設定 — macOS、Windows、Linux のキーリング設定、環境変数、Claude Code と Claude Desktop、分割サーバーと複数アカウント、サーバーが変更できる内容の制限。
• 使用上の注意 — API の動作と注意事項。
• リリース — メンテナー向けリリース手順。
• 変更履歴

リリース

メンテナーは、リリースガイドに従ってください。gh release create をそのまま実行してリリースを作成しないでください。ガイドに記載されている保護されたタグ作成手順では、その理由を説明し、古いバージョンの再公開を防いでいます。

免責事項

これは非公式の独立したコミュニティプロジェクトです。Lexware GmbH、Haufe Group、およびそれらの関連会社とは提携しておらず、承認、後援、サポートも受けていません。Lexware の公式サポートについては、Lexware に直接お問い合わせください。この MCP サーバーに関する問題は、Lexware ではなくこちらに報告してください。

「Lexware」および「Lexware Office」は、それぞれの所有者の商標です。このクライアントが接続するサードパーティ API を識別する目的に限り、本プロジェクトの名称およびドキュメント内で、名目的なフェアユースに基づいて使用しています。

作成、更新、削除の操作は、Lexware アカウントの実際の業務データを変更します。作者はこのソフトウェアを「現状のまま」提供し、その使用によって生じる意図しない変更、データ損失、その他あらゆる損害について責任を負いません。本番データに対して書き込み操作を実行する前に、サンドボックスまたは重要でないアカウントでテストしてください。

ライセンス

FSL-1.1-MIT — 全文についてはLICENSEを参照してください。