@promptpartner/bexio mcp服务器
完成瑞士会计集成 贝希奥 通过 模型上下文协议（MCP）.与合作 克劳德桌面版, n8n，以及任何兼容MCP的客户端。
通过人工智能对话或工作流自动化管理发票、联系人、项目、时间跟踪和300多种工具。
⚠️ 早期发布软件 该项目正在积极开发中。虽然它已经过功能和测试，但您可能会遇到错误或意外行为。随着时间的推移，功能将继续添加和改进。请 报告任何问题 你找到！
兼容性
快速开始
适用于克劳德桌面
选项A:MCPB捆绑包（最简单）
- 下载最新
.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 - 窗户：
%APPDATA%\Claude\claude_desktop_config.json
适用于n8n和其他HTTP客户端
以HTTP模式启动服务器：
BEXIO_API_TOKEN=your-token npx @promptpartner/bexio-mcp-server --mode http --port 8000服务器在以下位置通过HTTP公开MCP http://localhost:8000。配置您的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服务器提供 310工具 跨越所有Bexio域名：
联系人和CRM
- 创建、更新、搜索联系人
- 联系人组、部门、问候语、头衔
- 联系人关系管理
发票和销售
- 完整的发票生命周期（创建、开具、发送、取消）
- 具有接受/拒绝工作流的报价
- 具有交货管理的订单
- 收款跟踪
- 交互式发票预览（克劳德桌面）
银行与支付
- 瑞士二维码账单支付支持（QR-IBAN）
- 国际银行账户号码标准支付（ISO 20022）
- 货币管理（瑞士法郎、欧元）
- 银行账户管理
项目和时间跟踪
- 项目管理，包括类型和状态
- 里程碑和工作包
- 带有持续时间跟踪的时间表条目
- 业务活动和沟通类型
会计
- 会计科目表
- 手动日记账分录
- 营业年度和增值税期间
- 帐户组
采购和费用
- 票据（债权人发票）
- 费用和采购订单
- 外发付款
文件和文档
- 文件上传/下载
- 文件管理
工资单（需要Bexio工资单模块）
- 员工管理
- 缺勤跟踪
- 工资单文件
例子
以下是与Claude一起使用Bexio MCP服务器的一些真实示例：
示例1：查找逾期发票
提示：
“显示所有逾期发票”
发生了什么： 克劳德使用 get_overdue_invoices 该工具用于查询Bexio所有超过到期日的发票。
答复：
发现3张逾期发票： |发票号|客户|金额|到期日|逾期天数| |-----------|----------|--------|----------|--------------| |INV-2024-001 | Acme AG | 2450.00瑞士法郎| 2024-01-15 | 18天| |INV-2024-003 |技术有限公司| 890.50瑞士法郎| 2024-01-20 | 13天| |INV-2024-007 |瑞士公司|5200.00瑞士法郎|2024-01-25|8天| 逾期总额：8540.50瑞士法郎
______________________________________________________________________
示例2：创建发票
提示：
“为联系‘Sunrise AG’开具发票，包括两项内容：10小时的咨询，每小时150瑞士法郎，以及500瑞士法郎的软件许可证”
发生了什么： 克劳德使用 find_contact_by_name 找到客户，然后 create_invoice 使用指定的行项目。
答复：
为Sunrise AG创建发票INV-2024-015： - 10倍咨询时间@150.00瑞士法郎=1500.00瑞士法郎 - 1x软件许可证@500.00瑞士法郎=500.00瑞士瑞士法郎 小计：2000.00瑞士法郎 增值税（8.1%）：162.00瑞士法郎 总计：2162.00瑞士法郎 发票处于草稿状态。说“开具发票INV-2024-015”以最终确定。
______________________________________________________________________
示例3：项目时间总结
提示：
“这个月‘网站重新设计’项目花了多少时间？”
发生了什么： 克劳德使用 search_projects 找到项目，然后 search_timesheets 获取按项目和日期范围筛选的时间条目。
答复：
登录“网站重新设计”的时间（2024年1月）： |团队成员|工作时间|活动| |-------------|-------|------------| |Anna M.| 24:30 |设计、会议| |马可·K | 18:15 |发展| |Lisa B.| 8:00 |内容写作| 总计：50小时45分钟 使用的预算：80小时中的50.75小时（63%）
______________________________________________________________________
示例4：客户收入报告
提示：
“我今年从‘Tech Solutions GmbH’获得的收入是多少？”
发生了什么： 克劳德使用 find_contact_by_name 识别客户，然后 get_customer_revenue_report 计算已付款发票的总收入。
答复：
Tech Solutions GmbH的收入（2024年）： - Q1：12450.00瑞士法郎（3张发票） - 问题2：8200.00瑞士法郎（2张发票） - 问题3：15800.00瑞士法郎（4张发票） - Q4：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]
Options:
--mode Transport mode (default: stdio)
--host HTTP host (default: 0.0.0.0)
--port HTTP port (default: 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的隐私政策.
支持
- 问题和Bug报告：
- 电子邮件： lukas@promptpartner.ai
支持项目
如果这个项目能节省你的时间或帮助你的业务，考虑给我买杯咖啡！ ☕
您的支持有助于维护和改进此项目！
作者
由...创建 卢卡斯·赫蒂格 从 PromptPartner.ai
致谢
该项目建立在由创建的原始Bexio MCP服务器之上 塞巴斯蒂安·布莱纳 的 bryner.tech他的v1.0实现提供了基础架构和最初的83个工具，使这个扩展的v2.0成为可能。
开发工具
从83个扩展到310个工具是使用以下工具开发的：
这些工具帮助将一个为期4周的估计项目转化为为期2天的现实，展示了人工智能增强软件开发的潜力。
免责声明
这是一个独立的、社区驱动的项目 与Bexio AG没有附属关系、背书或正式联系 无论如何。“Bexio”是Bexio AG的商标。该项目只是为公开可用的Bexio API提供一个集成层。
使用此软件的风险由您自行承担。作者不对因使用Bexio帐户而产生的任何问题负责。
许可证
麻省理工学院-参见 许可证 了解详情。