金大哥 - bexio-mcp-server MCP 详情

article

README

🚀 @promptpartner/bexio-mcp-server

通过模型上下文协议（MCP），实现与Bexio的完整瑞士会计集成。可与Claude Desktop、n8n以及任何支持MCP的客户端配合使用。

通过AI对话或工作流自动化，管理发票、联系人、项目、时间跟踪等300多种工具。

⚠️ 早期版本软件

本项目正在积极开发中。虽然它已具备功能并经过测试，但您可能会遇到一些错误或意外行为。随着时间的推移，功能将不断增加和改进。如果您发现任何问题，请报告！

🚀 快速开始

针对Claude Desktop

选项A：MCPB捆绑包（最简单）

从GitHub Releases下载最新的.mcpb文件。
在Claude Desktop中，转到设置 → 扩展。
使用以下方法之一安装扩展：
- 双击下载的.mcpb文件；
- 拖放文件到扩展窗口；
- 点击高级设置 → 安装扩展并选择文件。
提示时输入您的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令牌

访问developer.bexio.com。
使用您的常规Bexio账户登录。
导航到个人访问令牌。
点击创建新令牌。
复制令牌并在配置中使用。

✨ 主要特性

此MCP服务器在所有Bexio领域提供310种工具：

联系人与客户关系管理（CRM）

创建、更新、搜索联系人
联系人组、行业、称呼、头衔
联系人关系管理

发票与销售

完整的发票生命周期（创建、开具、发送、取消）
带有接受/拒绝工作流的报价
带有交付管理的订单
跟踪收到的付款
交互式发票预览（Claude Desktop）

银行与支付

支持瑞士QR账单支付（QR-IBAN）
标准IBAN支付（ISO 20022）
货币管理（瑞士法郎、欧元）
银行账户管理

项目与时间跟踪

具有类型和状态的项目管理
里程碑和工作包
带有时长跟踪的时间表条目
业务活动和沟通类型

会计

会计科目表
手动日记账分录
营业年度和增值税期间
账户组

采购与费用

账单（供应商发票）
费用和采购订单
支出付款

文件与文档

文档上传/下载
文件管理

工资单（需要Bexio工资单模块）

员工管理
缺勤跟踪
工资单文档

💻 使用示例

以下是一些使用Bexio MCP服务器与Claude的实际示例：

示例1：查找逾期发票

提示：

"显示所有逾期发票"

操作过程： Claude使用get_overdue_invoices工具查询Bexio，获取所有超过到期日期的发票。

响应：

找到3张逾期发票：

| 发票编号 | 客户 | 金额 | 到期日期 | 逾期天数 | | ---- | ---- | ---- | ---- | ---- | | INV - 2024 - 001 | Acme AG | 2450.00瑞士法郎 | 2024 - 01 - 15 | 18天 | | INV - 2024 - 003 | Tech GmbH | 890.50瑞士法郎 | 2024 - 01 - 20 | 13天 | | INV - 2024 - 007 | Swiss Corp | 5200.00瑞士法郎 | 2024 - 01 - 25 | 8天 |

逾期总额：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月）记录的时间：

| 团队成员 | 小时数 | 活动 | | ---- | ---- | ---- | | Anna M. | 24:30 | 设计、会议 | | Marco K. | 18:15 | 开发 | | Lisa B. | 8:00 | 内容撰写 |

总计：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瑞士法郎

📚 详细文档

环境变量

| 属性 | 详情 | | ---- | ---- | | BEXIO_API_TOKEN | 必需，您的Bexio API令牌 | | BEXIO_BASE_URL | 可选，默认值为https://api.bexio.com/2.0，API端点URL |

命令行选项

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。