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个工具）

发票（12个工具）

信用票据（9种工具）

订单（6个工具）

优惠券（5个工具）

交易（5种工具）

零件/库存（4个工具）

基础知识（3个工具）

公共参数

状态代码

发票/贷记单：

• 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

许可证

麻省理工学院

链接

• sevDesk API文档
• sevDesk网站

-