使用说明
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 文档.
许可证
麻省理工学院
