Bexio MCP Server

🚀 @promptpartner/bexio-mcp-server

Bexio を Model Context Protocol (MCP) 経由で完全に統合したスイスの会計システムです。Claude Desktop、n8n、および MCP 互換のクライアントで動作します。

AI 対話またはワークフロー自動化を通じて、請求書、取引先、プロジェクト、勤務時間管理など 300 以上のツールを管理できます。

⚠️ 早期リリースソフトウェア

このプロジェクトは現在積極的に開発中です。機能的には動作し、テストも行われていますが、バグや予期しない動作に遭遇する可能性があります。機能は随時追加および改善されます。見つけた問題は こちら から報告してください！

🚀 クイックスタート

Claude Desktop の場合

オプション A: MCPB バンドル (最も簡単)

1. GitHub Releases から最新の .mcpb ファイルをダウンロードします。
2. Claude Desktop で、Settings → Extensions に移動します。
3. 以下のいずれかの方法で拡張機能をインストールします。
   • ダウンロードした .mcpb ファイルを ダブルクリック する。
   • ファイルを Extensions ウィンドウにドラッグアンドドロップ する。
   • Advanced Settings → Install Extension をクリックし、ファイルを選択する。
4. プロンプトが表示されたら、Bexio API トークンを入力します。

オプション B: npm

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "bexio": {
      "command": "npx",
      "args": ["@promptpartner/bexio-mcp-server"],
      "env": {
        "BEXIO_API_TOKEN": "your-token-here"
      }
    }
  }
}

設定ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

n8n およびその他の HTTP クライアントの場合

HTTP モードでサーバーを起動します。

BEXIO_API_TOKEN=your-token npx @promptpartner/bexio-mcp-server --mode http --port 8000

サーバーは http://localhost:8000 で MCP を HTTP 経由で公開します。MCP クライアントをこのエンドポイントに接続するように設定してください。

その他の stdio クライアントの場合

BEXIO_API_TOKEN=your-token npx @promptpartner/bexio-mcp-server

または、ソースからビルドします。

git clone https://github.com/promptpartner/bexio-mcp-server
cd bexio-mcp-server/src
npm install && npm run build
BEXIO_API_TOKEN=your-token node dist/index.js

📦 インストール

Bexio API トークンの取得方法

1. developer.bexio.com にアクセスします。
2. 通常の Bexio アカウントでログインします。
3. Personal Access Tokens に移動します。
4. Create New Token をクリックします。
5. トークンをコピーし、設定で使用します。

✨ 主な機能

この MCP サーバーは、すべての Bexio ドメインにわたる 310 のツール を提供します。

取引先と CRM

• 取引先の作成、更新、検索
• 取引先グループ、業種、敬称、肩書き
• 取引先関係の管理

請求書と販売

• 請求書のライフサイクル全体 (作成、発行、送信、キャンセル)
• 受諾/拒否ワークフロー付きの見積書
• 納品管理付きの注文書
• 入金追跡
• インタラクティブな請求書プレビュー (Claude Desktop)

銀行と支払い

• スイス QR 請求書支払いサポート (QR-IBAN)
• 標準 IBAN 支払い (ISO 20022)
• 通貨管理 (CHF、EUR)
• 銀行口座管理

プロジェクトと勤務時間管理

• タイプとステータス付きのプロジェクト管理
• マイルストーンと作業パッケージ
• 時間追跡付きの勤務時間記録
• 業務活動とコミュニケーションタイプ

会計

• 勘定科目表
• 手動仕訳帳エントリ
• 会計年度と VAT 期間
• 勘定グループ

仕入と経費

• 請求書 (債権者請求書)
• 経費と仕入注文書
• 出金

ファイルとドキュメント

• ドキュメントのアップロード/ダウンロード
• ファイル管理

給与計算 (Bexio 給与計算モジュールが必要)

• 従業員管理
• 欠勤管理
• 給与関連ドキュメント

💻 使用例

Claude で Bexio MCP サーバーを使用する実際の例をいくつか紹介します。

例 1: 期限切れの請求書を検索する

プロンプト:

"Show me all overdue invoices"

動作内容: Claude は get_overdue_invoices ツールを使用して、期限を過ぎたすべての請求書を Bexio に問い合わせます。

応答:

3 件の期限切れ請求書が見つかりました:

請求書番号	顧客	金額	期限日	期限超過日数
INV-2024-001	Acme AG	CHF 2,450.00	2024-01-15	18 日
INV-2024-003	Tech GmbH	CHF 890.50	2024-01-20	13 日
INV-2024-007	Swiss Corp	CHF 5,200.00	2024-01-25	8 日

合計期限切れ金額: CHF 8,540.50

例 2: 請求書を作成する

プロンプト:

"Create an invoice for contact 'Sunrise AG' with two items: 10 hours of consulting at CHF 150/hour and a software license for CHF 500"

動作内容: Claude は find_contact_by_name を使用して顧客を検索し、指定された明細項目で create_invoice を実行します。

応答:

Sunrise AG の請求書 INV-2024-015 を作成しました:

• 10 時間のコンサルティング @ CHF 150.00 = CHF 1,500.00
• 1 つのソフトウェアライセンス @ CHF 500.00 = CHF 500.00

小計: CHF 2,000.00 VAT (8.1%): CHF 162.00 合計: CHF 2,162.00

請求書は下書き状態です。「issue invoice INV-2024-015」と言って、請求書を確定させてください。

例 3: プロジェクトの勤務時間の要約

プロンプト:

"How much time was logged on project 'Website Redesign' this month?"

動作内容: Claude は search_projects を使用してプロジェクトを検索し、search_timesheets を使用してプロジェクトと日付範囲でフィルタリングされた勤務時間エントリを取得します。

応答:

「Website Redesign」プロジェクトの 2024 年 1 月の勤務時間:

チームメンバー	時間	活動内容
Anna M.	24:30	デザイン、会議
Marco K.	18:15	開発
Lisa B.	8:00	コンテンツ作成

合計: 50 時間 45 分

使用予算: 80 時間中 50.75 時間 (63%)

例 4: 顧客の収益レポート

プロンプト:

"What's my revenue from 'Tech Solutions GmbH' this year?"

動作内容: Claude は find_contact_by_name を使用して顧客を特定し、get_customer_revenue_report を使用して支払済み請求書からの総収益を計算します。

応答:

Tech Solutions GmbH からの 2024 年の収益:

• Q1: CHF 12,450.00 (3 件の請求書)
• Q2: CHF 8,200.00 (2 件の請求書)
• Q3: CHF 15,800.00 (4 件の請求書)
• Q4: CHF 6,500.00 (2 件の請求書、1 件未払い)

支払済み合計: CHF 42,950.00 未払い: CHF 3,200.00

📚 詳細ドキュメント

環境変数

コマンドラインオプション

npx @promptpartner/bexio-mcp-server [options]

Options:
  --mode <stdio|http>  トランスポートモード (デフォルト: stdio)
  --host <address>     HTTP ホスト (デフォルト: 0.0.0.0)
  --port <number>      HTTP ポート (デフォルト: 8000)

トラブルシューティング

"Invalid API token" エラー

• developer.bexio.com > Personal Access Tokens でトークンを確認してください。
• トークンが期限切れになっていないことを確認してください。
• トークンが必要な権限を持っていることを確認してください。

"Connection refused" エラー

• インターネット接続を確認してください。
• BEXIO_BASE_URL が正しいことを確認してください (デフォルト: https://api.bexio.com/2.0)。

給与計算ツールが "module not available" を返す

• 給与計算ツールには Bexio 給与計算モジュールのサブスクリプションが必要です。
• Bexio サポートに連絡して、モジュールを有効にしてください。

Claude Desktop がサーバーを認識しない

• 設定を変更した後、Claude Desktop を再起動してください。
• 設定ファイルのパスが OS に適していることを確認してください。
• Claude Desktop のログにエラーメッセージがないか確認してください。

📄 ライセンス

MIT - 詳細は LICENSE を参照してください。

🔗 リンク

• Bexio API Documentation
• MCP Protocol Specification
• PromptPartner.ai

サポート

• 問題とバグ報告: GitHub Issues
• メール: lukas@promptpartner.ai

プロジェクトのサポート

このプロジェクトがあなたの時間を節約したり、ビジネスに役立ったりした場合は、コーヒーを一杯奢ってください！ ☕

あなたのサポートにより、このプロジェクトの維持と改善が可能になります！

作者

PromptPartner.ai の Lukas Hertig によって作成されました。

謝辞

このプロジェクトは、bryner.tech の Sebastian Bryner によって作成された元の Bexio MCP サーバーを基に構築されています。彼の v1.0 実装は、この拡張された v2.0 を可能にする基礎的なアーキテクチャと最初の 83 のツールを提供しました。

開発ツール

83 から 310 のツールへの拡張は、以下のツールを使用して開発されました。

• Claude Code - Anthropic の AI 駆動型開発環境で、迅速な反復と包括的な API カバレッジを可能にします。
• GSD Framework - 構造化された AI 支援開発ワークフローのための「Get Shit Done」計画フレームワーク。

これらのツールにより、予想された 4 週間のプロジェクトが 2 日間で実現され、AI 強化ソフトウェア開発の可能性を示しています。

免責事項

これは独立したコミュニティ主導のプロジェクトであり、Bexio AG と一切関係がなく、承認もされておらず、公式に関連付けられていません。「Bexio」は Bexio AG の商標です。このプロジェクトは、公開されている Bexio API への統合層を提供するだけです。

このソフトウェアの使用は自己責任で行ってください。著者は、あなたの Bexio アカウントでの使用に起因する問題について一切の責任を負いません。