AI导哈

SevDesk API协议服务

一个用于SevDesk API的模型上下文协议(MCP)服务器，允许AI代理管理联系人、发票、报价等。

  • by art-solutions
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 art-solutions/npm-sevdesk-mcp

使用说明

npm服务器mcp

模型上下文协议（MCP）服务器 SevDesk API此软件包允许AI代理（如Claude）与您的SevDesk帐户交互，以管理联系人、发票、优惠等。

安装

您可以直接通过以下方式使用此MCP服务器 npx 无需全局安装：

npx npm-sevdesk-mcp

或者全局安装：

npm install -g npm-sevdesk-mcp

配置

服务器需要 SEVDESK_API_TOKEN 要设置的环境变量。

您可以在下的SevDesk帐户设置中找到您的API令牌 设置>用户>[您的用户]>API代币.

使用Claude Desktop

将以下内容添加到您的Claude Desktop配置文件中(claude_desktop_config.json):

{
  "mcpServers": {
    "sevdesk": {
      "command": "npx",
      "args": ["-y", "npm-sevdesk-mcp"],
      "env": {
        "SEVDESK_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

配置文件位置

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

使用游标

  1. 打开 光标设置.
  2. 引导到 功能>MCP.
  3. 点击 添加新的MCP服务器.
  4. 输入以下详细信息：
    • 名字: sevdesk
    • 类型: command
    • 命令: npx -y npm-sevdesk-mcp
    • 环境变量：使用Key添加新变量 SEVDESK_API_TOKEN 以及您的代币作为价值。

使用ChatGPT桌面

  1. 打开 ChatGPT桌面 应用程序（macOS/Windows）。
  2. 首选 设置.
  3. 启用 开发者模式 （如果需要）或寻找 连接器 / MCP服务器.
  4. 添加具有以下配置的新服务器：
    • 名字: sevdesk
    • 命令: npx -y npm-sevdesk-mcp
    • 环境变量: SEVDESK_API_TOKEN=YOUR_API_TOKEN

可用工具

通用的

  • request：向任何SevDesk API终结点发出原始HTTP请求。
    • 输入: method （获取/发布/放置/删除）， url, data （身体）， params （查询）。

联系人

  • list_contacts：列出具有可选筛选功能的联系人。
    • 输入: limit, offset, customerNumber, depth.
  • create_contact：创建新联系人（组织或个人）。
    • 输入: name （组织名称）， categoryId （3=客户，2=供应商）， surename/familyname （适用于个人）， customerNumber.
  • update_contact：更新现有联系人。
    • 输入: contactId （必填）和任何要更新的字段（例如。， name, status).

发票

  • list_invoices：列出发票。
    • 输入: limit, offset, status, contactId.
  • create_invoice：创建新发票，可选地包括行项目（位置）。
    • 输入: contactId （必填）， header, invoiceDate, deliveryDate, status, positions （项目数组）。
  • update_invoice：更新现有发票。
    • 输入: invoiceId （必填）， header, status, deliveryDate.
  • get_invoice_positions：获取特定发票的行项目。
    • 输入: invoiceId （必填）。

报价（订单）

  • create_offer：创建新报价（订单类型“AN”），可选择包括行项目。
    • 输入: contactId （必填）， header, orderDate, status, positions （项目数组）。
  • update_offer：更新现有报价。
    • 输入: orderId （必填）， header, status.

示例用法

配置后，您可以要求Claude：

  • “在SevDesk中列出我的所有联系人”
  • “创建一个名为‘Acme Corp’的新客户联系人”
  • “显示所有未付发票”
  • “为联系人ID 12345创建包含两行项目的发票”

需求

  • Node.js>=16.0.0
  • 具有API访问权限的SevDesk帐户

故障排除

  • 身份验证错误：确保您的 SEVDESK_API_TOKEN 是正确的，并且具有访问API的权限。
  • 模型/字段错误：SevDesk API结构可能很复杂。如果特定字段无法使用便利工具，请尝试使用原始字段 request 手动调试或执行操作的工具。

许可证

麻省理工学院

相关 MCP