AI导哈

Freshdesk工单上下文协议服务器

一个为LLM交互提供Freshdesk工单上下文的MCP服务器，支持工单详情获取、搜索和代理工单查询功能。

  • by nikhilchintawar
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 nikhilchintawar/freshdesk-mcp

使用说明

Freshdesk MCP服务器

一个模型上下文协议（MCP）服务器，它获取Freshdesk票证详细信息，并将其作为LLM交互的上下文提供。

特性

  • 获取门票 -从Freshdesk URL或工单ID获取完整的工单详细信息

    • 票证元数据（主题、状态、优先级、类型、标签）
    • 申请人和受让人信息
    • 所有对话（回复和私人笔记）
    • 附件列表
    • 时间条目
    • 满意度评级
    • 自定义字段

  • 搜索门票 -通过文本查询搜索门票

    • 按状态筛选（打开、待定、已解决、已关闭）
    • 按优先级筛选（低、中、高、紧急）
    • 可配置的结果限制

  • 获取门票 -获取分配给特定代理的门票

    • 按代理名称搜索（支持部分匹配）
    • 按状态筛选
    • 可配置的结果限制

安装

使用npx（推荐）

无需安装。直接添加到您的配置中：

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "freshdesk": {
      "command": "npx",
      "args": ["-y", "github:nikhilchintawar/freshdesk-mcp"],
      "env": {
        "FRESHDESK_API_KEY": "your-api-key",
        "FRESHDESK_DOMAIN": "yourcompany"
      }
    }
  }
}

克劳德代码 (~/.claude/settings.json):

{
  "mcpServers": {
    "freshdesk": {
      "command": "npx",
      "args": ["-y", "github:nikhilchintawar/freshdesk-mcp"],
      "env": {
        "FRESHDESK_API_KEY": "your-api-key",
        "FRESHDESK_DOMAIN": "yourcompany"
      }
    }
  }
}

手动安装

# Clone the repository
git clone https://github.com/nikhilchintawar/freshdesk-mcp.git
cd freshdesk-mcp

# Install dependencies
npm install

然后添加到您的配置中：

{
  "mcpServers": {
    "freshdesk": {
      "command": "node",
      "args": ["/absolute/path/to/freshdesk-mcp/build/index.js"],
      "env": {
        "FRESHDESK_API_KEY": "your-api-key",
        "FRESHDESK_DOMAIN": "yourcompany"
      }
    }
  }
}

配置

配置文件位置

  • 克劳德桌面（macOS）： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 克劳德桌面（Windows）： %APPDATA%\Claude\claude_desktop_config.json
  • 克劳德代码： ~/.claude/settings.json

环境变量

变量 描述 必填
FRESHDESK_API_KEY 您的Freshdesk API密钥 是
FRESHDESK_DOMAIN 您的Freshdesk子域名（例如。， mycompany 对于mycompany.freshtdesk.com） 是的

用法示例

配置后，您可以使用自然语言与Freshdesk交互：

  • “获取门票详情https://mycompany.freshdesk.com/a/tickets/12345"
  • “搜索有关“登录问题”的票证”
  • “给我看分配给约翰的所有未结门票”
  • “查找与计费相关的高优先级票证”

获取您的Freshdesk API密钥

  1. 登录您的Freshdesk帐户
  2. 点击您的个人资料图标→ 个人资料设置
  3. 您的API密钥显示在页面的右侧

发展

# Watch mode for development
npm run dev

# Build for production
npm run build

# Test with MCP Inspector
FRESHDESK_API_KEY=your-key FRESHDESK_DOMAIN=your-domain \
  npx @modelcontextprotocol/inspector node build/index.js

许可证

麻省理工学院

相关 MCP