Freshdesk MCP 服务器
与 Freshdesk 集成的 MCP 服务器实现,使 AI 模型能够与 Freshdesk 模块交互并执行各种支持操作。
特征
- Freshdesk 集成:与 Freshdesk API 端点无缝交互
- AI 模型支持:使 AI 模型能够通过 Freshdesk 执行支持操作
- 自动票务管理:处理票务创建、更新和响应
成分
工具
该服务器为 Freshdesk 操作提供了多种工具:
create_ticket
:创建新的支持票- 输入:
subject
(字符串,必填):票证主题description
(字符串,必需):票证描述source
(数字,必填):票证源代码priority
(数字,必填):工单优先级status
(数字,必填):票证状态代码email
(字符串,可选):请求者的电子邮件requester_id
(数字,可选):请求者的 IDcustom_fields
(对象,可选):在工单上设置的自定义字段
update_ticket
:更新现有票证- 输入:
ticket_id
(数字,必填):要更新的工单的 IDupdates
(对象,必需):要更新的字段
delete_ticket
:删除票证- 输入:
ticket_id
(数字,必填):要删除的票证的 ID
search_tickets
:根据条件搜索票证get_ticket_fields
:获取所有票证字段get_tickets
:获取所有票证- 输入:
page
(数字,可选):要获取的页码per_page
(数字,可选):每页票数
get_ticket
:获取单程票- 输入:
ticket_id
(数字,必填):要获取的票证的 ID
入门
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 freshdesk_mcp:
npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude
先决条件
- Freshdesk 帐户(在freshdesk.com注册)
- Freshdesk API 密钥
- 已安装
uvx
( pip install uv
或brew install uv
)
配置
- 从 Freshdesk 管理面板生成您的 Freshdesk API 密钥
- 设置您的域和身份验证详细信息
与 Claude Desktop 一起使用
- 如果你还没有安装 Claude Desktop
- 将以下配置添加到您的
claude_desktop_config.json
:
"mcpServers": {
"freshdesk-mcp": {
"command": "uvx",
"args": [
"freshdesk-mcp"
],
"env": {
"FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
"FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
}
}
}
重要提示:
- 将
YOUR_FRESHDESK_API_KEY
替换为您的实际 Freshdesk API 密钥 - 将
YOUR_FRESHDESK_DOMAIN
替换为您的 Freshdesk 域名(例如, yourcompany.freshdesk.com
)
示例操作
配置完成后,您可以要求 Claude 执行如下操作:
- 创建一张新票据,主题为‘客户 A101 的付款问题’,描述为‘上个月联系客户 A101 解决付款问题’,客户邮箱为a101@acme.com ,并将优先级设置为高”
- “将票号 12345 的状态更新为‘已解决’”
- “列出分配给代理 John Doe 的所有高优先级票证”
- “列出客户 A101 在过去 30 天内的先前工单”
测试
为了测试目的,您可以手动启动服务器:
uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>
故障排除
- 验证您的 Freshdesk API 密钥和域名是否正确
- 确保与 Freshdesk 服务器的网络连接正常
- 检查 API 速率限制和配额
- 验证
uvx
命令是否在您的 PATH 中可用
执照
此 MCP 服务器采用 MIT 许可证。请参阅项目仓库中的 LICENSE 文件以了解更多详细信息。