Bexio MCP Server

🚀 @promptpartner/bexio-mcp-server

通過模型上下文協議（MCP），實現與Bexio的完整瑞士會計集成。可與Claude Desktop、n8n以及任何支持MCP的客戶端配合使用。

通過AI對話或工作流自動化，管理發票、聯繫人、項目、時間跟蹤等300多種工具。

⚠️ 早期版本軟件

本項目正在積極開發中。雖然它已具備功能並經過測試，但您可能會遇到一些錯誤或意外行為。隨著時間的推移，功能將不斷增加和改進。如果您發現任何問題，請報告！

🚀 快速開始

針對Claude Desktop

選項A：MCPB捆綁包（最簡單）

1. 從GitHub Releases下載最新的.mcpb文件。
2. 在Claude Desktop中，轉到設置 → 擴展。
3. 使用以下方法之一安裝擴展：
   • 雙擊下載的.mcpb文件；
   • 拖放文件到擴展窗口；
   • 點擊高級設置 → 安裝擴展並選擇文件。
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在http://localhost:8000上公開MCP。配置您的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. 導航到個人訪問令牌。
4. 點擊創建新令牌。
5. 複製令牌並在配置中使用。

✨ 主要特性

此MCP服務器在所有Bexio領域提供310種工具：

聯繫人與客戶關係管理（CRM）

• 創建、更新、搜索聯繫人
• 聯繫人組、行業、稱呼、頭銜
• 聯繫人關係管理

發票與銷售

• 完整的發票生命週期（創建、開具、發送、取消）
• 帶有接受/拒絕工作流的報價
• 帶有交付管理的訂單
• 跟蹤收到的付款
• 交互式發票預覽（Claude Desktop）

銀行與支付

• 支持瑞士QR賬單支付（QR-IBAN）
• 標準IBAN支付（ISO 20022）
• 貨幣管理（瑞士法郎、歐元）
• 銀行賬戶管理

項目與時間跟蹤

• 具有類型和狀態的項目管理
• 里程碑和工作包
• 帶有時長跟蹤的時間表條目
• 業務活動和溝通類型

會計

• 會計科目表
• 手動日記賬分錄
• 營業年度和增值稅期間
• 賬戶組

採購與費用

• 賬單（供應商發票）
• 費用和採購訂單
• 支出付款

文件與文檔

• 文檔上傳/下載
• 文件管理

工資單（需要Bexio工資單模塊）

• 員工管理
• 缺勤跟蹤
• 工資單文檔

💻 使用示例

以下是一些使用Bexio MCP服務器與Claude的實際示例：

示例1：查找逾期發票

提示：

"顯示所有逾期發票"

操作過程： Claude使用get_overdue_invoices工具查詢Bexio，獲取所有超過到期日期的發票。

響應：

找到3張逾期發票：

逾期總額：8540.50瑞士法郎

示例2：創建發票

提示：

"為聯繫人'Sunrise AG'創建一張發票，包含兩個項目：10小時諮詢服務，每小時150瑞士法郎；一個軟件許可證，價格為500瑞士法郎"

操作過程： Claude使用find_contact_by_name找到客戶，然後使用create_invoice創建指定的行項目。

響應：

為Sunrise AG創建了發票INV - 2024 - 015：

• 10x 諮詢小時 @ 150.00瑞士法郎 = 1500.00瑞士法郎
• 1x 軟件許可證 @ 500.00瑞士法郎 = 500.00瑞士法郎

小計：2000.00瑞士法郎 增值稅（8.1%）：162.00瑞士法郎 總計：2162.00瑞士法郎

發票處於草稿狀態。說"開具發票INV - 2024 - 015"以完成開具。

示例3：項目時間總結

提示：

"本月'網站重新設計'項目記錄了多少時間？"

操作過程： Claude使用search_projects查找項目，然後使用search_timesheets按項目和日期範圍過濾時間條目。

響應：

"網站重新設計"（2024年1月）記錄的時間：

總計：50小時45分鐘

已使用預算：80小時中的50.75小時（63%）

示例4：客戶收入報告

提示：

"我今年從'Tech Solutions GmbH'獲得的收入是多少？"

操作過程： Claude使用find_contact_by_name識別客戶，然後使用get_customer_revenue_report計算已支付發票的總收入。

響應：

來自Tech Solutions GmbH（2024年）的收入：

• 第一季度：12450.00瑞士法郎（3張發票）
• 第二季度：8200.00瑞士法郎（2張發票）
• 第三季度：15800.00瑞士法郎（4張發票）
• 第四季度：6500.00瑞士法郎（2張發票，1張待處理）

已支付總額：42950.00瑞士法郎 待處理：3200.00瑞士法郎

📚 詳細文檔

環境變量

命令行選項

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

選項:
  --mode <stdio|http>  傳輸模式（默認：stdio）
  --host <address>     HTTP主機（默認：0.0.0.0）
  --port <number>      HTTP端口（默認：8000）

故障排除

"無效的API令牌"錯誤

• 在developer.bexio.com > 個人訪問令牌中驗證您的令牌。
• 確保令牌未過期。
• 檢查令牌是否具有所需的權限。

"連接被拒絕"錯誤

• 檢查您的互聯網連接。
• 驗證BEXIO_BASE_URL是否正確（默認：https://api.bexio.com/2.0）。

工資單工具返回"模塊不可用"

• 工資單工具需要訂閱Bexio工資單模塊。
• 聯繫Bexio支持以啟用該模塊。

Claude Desktop看不到服務器

• 配置更改後重啟Claude Desktop。
• 驗證配置文件路徑是否適用於您的操作系統。
• 檢查Claude Desktop日誌中的錯誤消息。

隱私政策

此MCP服務器作為Bexio API的通道，不存儲任何數據。完整詳情請參閱我們的隱私政策。

您的數據將根據Bexio的隱私政策進行處理。

支持

• 問題與錯誤報告：GitHub Issues
• 電子郵件：lukas@promptpartner.ai

支持項目

如果這個項目為您節省了時間或對您的業務有幫助，考慮請我喝杯咖啡吧！ ☕

您的支持有助於保持項目的維護和改進！

作者

由PromptPartner.ai的Lukas Hertig創建。

致謝

本項目基於Sebastian Bryner of bryner.tech創建的原始Bexio MCP服務器。他的1.0版本實現提供了基礎架構和最初的83個工具，使得這個擴展的2.0版本成為可能。

開發工具

從83個工具擴展到310個工具是使用以下工具開發的：

• Claude Code - Anthropic的AI驅動開發環境，支持快速迭代和全面的API覆蓋。
• GSD Framework - “完成任務”規劃框架，用於結構化的AI輔助開發工作流。

這些工具將一個預計4周的項目在2天內完成，展示了AI增強軟件開發的潛力。

免責聲明

這是一個獨立的、社區驅動的項目，與Bexio AG沒有任何關聯、認可或官方聯繫。“Bexio”是Bexio AG的商標。本項目僅提供與公開可用的Bexio API的集成層。

使用此軟件需自行承擔風險。作者不對其與您的Bexio賬戶一起使用時產生的任何問題負責。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE。

🔗 鏈接

• Bexio API文檔
• MCP協議規範
• PromptPartner.ai