使用说明

项目简介

Freshdesk MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接 AI 模型和 Freshdesk 客户支持平台。它提供了一系列工具，使 AI 模型能够与 Freshdesk API 交互，执行诸如创建、更新、查询工单，管理联系人和代理，以及访问知识库等操作。

主要功能点

工单管理: 支持创建、更新、删除、搜索和获取工单，方便 AI 模型处理客户支持请求。
联系人管理: 允许 AI 模型列出、获取、搜索和更新 Freshdesk 中的联系人信息。
坐席管理: 提供获取、创建、更新和搜索 Freshdesk 坐席的功能。
知识库访问: 使 AI 模型能够访问 Freshdesk 知识库中的解决方案文章、文件夹和分类。
预设回复: 支持列出 Freshdesk 中的预设回复和文件夹。

安装步骤

安装 uvx: 确保你的系统已安装 'uvx' 运行时环境。可以通过 'pip install uv' 或 'brew install uv' 进行安装。
获取 Freshdesk API 密钥: 登录你的 Freshdesk 账户，在管理面板中生成 API 密钥。
配置环境变量: 设置 'FRESHDESK_API_KEY' 和 'FRESHDESK_DOMAIN' 环境变量，分别填入你的 Freshdesk API 密钥和域名。

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Claude Desktop）配合使用，请将以下配置添加到客户端的配置文件（例如 'claude_desktop_config.json'）中。

{
  "mcpServers": {
    "freshdesk-mcp": {
      "command": "uvx",
      "args": [
          "freshdesk-mcp"
      ],
      "env": {
        "FRESHDESK_API_KEY": "<Your Freshdesk API Key>", // 替换为你的 Freshdesk API 密钥
        "FRESHDESK_DOMAIN": "<Your Freshdesk Domain>"   // 替换为你的 Freshdesk 域名 (例如：yourcompany.freshdesk.com)
      }
    }
  }
}

基本使用方法

配置完成后，你可以指示你的 MCP 客户端（例如 Claude）使用提供的工具来与 Freshdesk 交互。例如，你可以要求：

"创建一个主题为 '问题 X'，描述为 '问题 X 的详细信息' 的工单。"
"搜索关键词为 '客户 Y' 的工单。"
"获取工单编号为 123 的信息。"

注意: 使用前请确保已正确配置 Freshdesk API 密钥和域名环境变量。

关键词