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
使用游标
- 打开 光标设置.
- 引导到 功能>MCP.
- 点击 添加新的MCP服务器.
- 输入以下详细信息：
- 名字: sevdesk - 类型: command - 命令: npx -y npm-sevdesk-mcp - 环境变量：使用Key添加新变量 SEVDESK_API_TOKEN 以及您的代币作为价值。
使用ChatGPT桌面
- 打开 ChatGPT桌面 应用程序（macOS/Windows）。
- 首选 设置.
- 启用 开发者模式 （如果需要）或寻找 连接器 / MCP服务器.
- 添加具有以下配置的新服务器：
- 名字: 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手动调试或执行操作的工具。
许可证
麻省理工学院