mcp服务台
用于sevdesk API的模型上下文协议（MCP）服务器。允许将sevdesk会计功能集成到Claude和其他MCP兼容的应用程序中。
特性
- 联系方式创建、阅读、更新和删除联系人（客户、供应商、合作伙伴）
- 发票列出、检索、导出为 PDF、发送电子邮件、预订和取消
- Belege（代金券）管理收款和支出
- 银行管理银行账户和交易
- 文章管理产品和服务
安装
npm install
npm run generate-types
npm run build配置
设置环境变量 SEVDESK_API_TOKEN 使用您的 sevdesk API 令牌：
export SEVDESK_API_TOKEN="dein-32-zeichen-hex-token"在 sevdesk 中找到 API 令牌：设置 → 用户 → API 令牌
使用
Als MCP服务器
将服务器添加到您的 Claude 桌面配置 （~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"sevdesk": {
"command": "node",
"args": ["/pfad/zu/mcp-sevdesk/dist/index.js"],
"env": {
"SEVDESK_API_TOKEN": "dein-api-token"
}
}
}
}直接执行
SEVDESK_API_TOKEN="dein-token" npm start可用工具
联系方式
| 工具 | 描述 |
|---|---|
list_contacts 列出所有联系人。 | |
get_contact 查找个人联系人。 | |
create_contact 创建新联系人 | |
update_contact 更新联系方式 | |
delete_contact 删除联系人 |
发票
| 工具 | 描述 |
|---|---|
list_invoices 列出所有账单 | |
get_invoice 获取单个发票。 | |
get_invoice_pdf 以PDF格式获取发票 | |
send_invoice_by_email 通过电子邮件发送发票 | |
mark_invoice_as_sent 将发票标记为已发货 | |
book_invoice 发票预订为付费。 | |
cancel_invoice 取消账户。 |
Belege（代金券）
| 工具 | 描述 |
|---|---|
list_vouchers 列出所有文件。 | |
get_voucher 查看单个文件。 | |
book_voucher | 付费预订凭证 |
get_voucher_positions 查找文件位置。 | |
upload_voucher_file 上传文件 |
银行
| 工具 | 描述 |
|---|---|
list_check_accounts 列出所有银行账户 | |
get_check_account 单个银行账户。 | |
get_check_account_balance 查看账户状态。 | |
list_transactions 交易列表 | |
get_transaction 查看单个交易。 | |
create_transaction 创建新交易 |
文章
| 工具 | 描述 |
|---|---|
list_parts 列出所有文章 | |
get_part 查看个别文章。 | |
create_part 创建新文章 | |
update_part 更新文章 | |
get_part_stock 查看库存 |
API 参考
该服务器基于官方的 sevdesk API v1。有关 API 的更多信息，请参阅 sevdesk API 文档.
许可证
麻省理工学院