AI导哈

sevDesk会计API工具集

为sevDesk会计软件提供的包含52个工具的服务器，用于管理联系人、发票、信用票据、订单、凭证、交易和库存。

  • by Honeyfield-Org
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Honeyfield-Org/sevdesk-mcp

使用说明

@霍尼韦尔/赛夫特克mcp

用于sevDesk Accounting API的MCP服务器。此服务器提供52个工具，用于在sevDesk中管理联系人、发票、贷记单、订单、凭证、交易和零件。

安装

npm install -g @honeyfield/sevdesk-mcp

或者直接与npx一起使用：

npx @honeyfield/sevdesk-mcp

配置

环境变量

将您的sevDesk API令牌设置为环境变量：

export SEVDESK_API_TOKEN=your-api-token

获取API令牌

  1. 登录到您的 sevDesk帐户
  2. 首选 设置 （设置） → 用户 （用户） → API代币
  3. 生成新令牌
  4. 安全地复制和存储令牌（只显示一次）

克劳德桌面/克劳德代码

添加到MCP配置中：

{
  "mcpServers": {
    "sevdesk": {
      "command": "npx",
      "args": ["@honeyfield/sevdesk-mcp"],
      "env": {
        "SEVDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

可用工具（52）

联系人（8个工具）

工具 说明
list_contacts 列出带有过滤器的联系人（客户、供应商、合作伙伴）
get_contact 按ID获取联系方式
create_contact 创建新联系人
update_contact 更新现有联系人
delete_contact 删除联系人
get_next_customer_number 生成下一个客户编号
list_contact_addresses 列出联系人的地址
create_contact_address 创建新的联系地址

发票（12个工具）

工具 说明
list_invoices 列出带有过滤器的发票
get_invoice 按ID获取发票详细信息
create_invoice 创建带有头寸的新发票
update_invoice 更新现有发票
delete_invoice 删除发票
send_invoice_email 通过电子邮件发送发票
book_invoice_payment 预订发票付款
enshrine_invoice 锁定/最终确定发票
reset_invoice_to_draft 将发票重置为草稿状态
get_invoice_pdf 获取发票PDF下载信息
export_invoice_xml 将发票导出为XRechnung XML格式
create_invoice_from_order 从订单创建发票

信用票据（9种工具）

工具 说明
list_credit_notes 列出带有过滤器的贷方票据
get_credit_note 按ID获取贷记单详细信息
create_credit_note 创建新的贷记单
update_credit_note 更新现有贷记单
delete_credit_note 删除贷记单
send_credit_note_email 通过电子邮件发送贷记单
book_credit_note_payment 预订信用票据付款
enshrine_credit_note 锁定/最终确定贷记单
create_credit_note_from_invoice 从发票创建贷记单

订单（6个工具）

工具 说明
list_orders 使用筛选器列出订单/报价
get_order 按ID获取订单详细信息
create_order 创建新订单/报价
update_order 更新现有订单
delete_order 删除订单
send_order_email 通过电子邮件发送订单

优惠券（5个工具）

工具 说明
list_vouchers 使用过滤器列出凭证/收据
get_voucher 按ID获取凭证详细信息
create_voucher 创建新凭证
update_voucher 更新现有凭证
book_voucher 预订代金券付款

交易（5种工具）

工具 说明
list_check_accounts 列出付款账户
list_transactions 使用筛选器列出交易记录
get_transaction 按ID获取交易详情
create_transaction 创建新交易
update_transaction 更新现有交易

零件/库存（4个工具）

工具 说明
list_parts 列出带有过滤器的零件/物品
get_part 按ID获取零件详细信息
create_part 创建新零件/文章
update_part 更新现有零件

基础知识（3个工具）

工具 说明
get_system_version 获取sevDesk系统版本
get_next_sequence_number 获取下一个文档编号
export_data 导出特定类型的数据

公共参数

状态代码

发票/贷记单：

  • 100 -草稿
  • 200 -打开/交付
  • 1000 -已付

订单：

  • 100 -草稿
  • 200 -已交付
  • 300 -接受
  • 500 -部分发票
  • 750 -已开票
  • 1000 -已取消

凭证：

  • 50 -草稿
  • 100 -未付
  • 1000 -已付

联系人类别

  • 3 -客户（Kunde）
  • 4 供应商（Supplier）
  • 28 搭档

订单类型

  • AN Quote（报价）
  • AB 订单确认（Order Confirmation）
  • LI 交货单（Delivery Note）

国家ID

  • 1 -德国
  • 其他国家/地区请参阅sevDesk文档

Unity ID

  • 1 Piece（片）
  • 2 - 小时（ 小时）
  • 其他装置见sevDesk文档

例子

创建客户

{
  "name": "ACME GmbH",
  "categoryId": 3,
  "defaultTimeToPay": 14,
  "vatNumber": "DE123456789"
}

创建发票

{
  "contactId": 12345,
  "invoiceDate": "2024-01-15",
  "positions": [
    {
      "name": "Consulting",
      "quantity": 8,
      "price": 150.00,
      "taxRate": 19,
      "unityId": 2
    }
  ],
  "header": "Invoice for January 2024",
  "timeToPay": 14
}

创建报价

{
  "contactId": 12345,
  "orderDate": "2024-01-10",
  "orderType": "AN",
  "positions": [
    {
      "name": "Web Development",
      "quantity": 1,
      "price": 5000.00,
      "taxRate": 19,
      "unityId": 1,
      "optional": false
    }
  ]
}

发展

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

MCP检验员测试

npx @anthropic-ai/mcp-inspector dist/index.js

许可证

麻省理工学院

链接

相关 MCP