Freshdesk MCP

🚀 Freshdesk MCP 服务器

一个与 Freshdesk 集成的 MCP 服务器实现，可让 AI 模型与 Freshdesk 模块交互，执行各类支持操作，极大提升支持工作的效率和智能化水平。

✨ 主要特性

• Freshdesk 集成：与 Freshdesk API 端点无缝交互，确保数据传输的高效与稳定。
• AI 模型支持：允许 AI 模型通过 Freshdesk 执行支持操作，为支持流程注入智能动力。
• 自动化工单管理：处理工单的创建、更新和响应，节省人力成本，提高工单处理速度。

📦 安装指南

使用 Smithery 进行安装

# 使用以下命令在终端中运行安装脚本
smithery install @effytech/freshdesk-mcp

手动安装

1. 下载并提取压缩包：

   wget https://example.com/freshdesk-mcp.zip && unzip freshdesk-mcp.zip
   

2. 安装依赖项：

   npm install
   

3. 启动服务器：

   node index.js
   

💻 使用示例

基础用法

创建工单

curl -X POST http://localhost:3000/api/tickets \
     -H "Content-Type: application/json" \
     -d '{"subject":"问题报告","description":"遇到一个严重的问题。"}'

更新工单状态

curl -X PUT http://localhost:3000/api/tickets/123/status \
     -H "Content-Type: application/json" \
     -d '{"status":2}'

📚 详细文档

组件 - 工具

该服务器提供了多个用于 Freshdesk 操作的工具：

先决条件

• Node.js 14 或更高版本
• npm 6 或更高版本
• Freshdesk 账户及 API 访问权限

技术要求

配置

示例配置文件（config.json）

{
  "freshdesk": {
    "url": "https://your-subdomain.freshdesk.com",
    "api_key": "your_api_key"
  },
  "mcp": {
    "port": 3000,
    "host": "localhost"
  }
}

设置环境变量

export FRESHDESK_URL="https://your-subdomain.freshdesk.com"
export FRESHDESK_API_KEY="your_api_key"

测试

单元测试

运行以下命令执行单元测试：

npm test

集成测试

运行以下命令执行集成测试：

npm run integration-test

故障排除

1. 端口冲突：确保没有其他服务占用 3000 端口。
2. 连接问题：检查网络连接和 API 服务状态。
3. 配置错误：核实 config.json 文件是否正确。

常见问题解答

• 如何更改默认端口？

  • 修改 config.json 中的 port 参数。

• 无法连接到 Freshdesk？

  • 检查 API URL 和密钥是否正确。

🔧 技术细节

该服务器基于 Node.js 构建，使用 HTTP/HTTPS 协议与 Freshdesk API 进行通信。默认监听 3000 端口，支持 JSON 格式的数据交互。通过封装 Freshdesk API 的各类操作，提供了一系列方便的工具函数，供 AI 模型调用，实现与 Freshdesk 系统的集成和工单管理自动化。

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。有关详细信息，请参阅项目仓库中的 LICENSE 文件。

⚠️ 重要提示

• 在生产环境中，请确保 API 密钥的安全性。
• 定期更新 API 密钥以增强安全性。
• 配置文件应置于安全的位置，避免未授权访问。