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