Freshdesk MCP Server 是一个 MCP 服务器实现，用于与 Freshdesk 集成，使 AI 模型能够与 Freshdesk 模块交互并执行各种支持操作。
主要能力：
- Freshdesk 集成：与 Freshdesk API 端点无缝交互。
- AI 模型支持：使 AI 模型能够通过 Freshdesk 执行支持操作。
- 自动化票务管理：处理工单创建、更新和回复。
服务器提供的工具包括：
- create_ticket：创建新支持工单。输入：subject（字符串，必填）、description（字符串，必填）、source（数字，必填）、priority（数字，必填）、status（数字，必填）、email（字符串，可选）、requester_id（数字，可选）、custom_fields（对象，可选）、additional_fields（对象，可选）。
- update_ticket：更新现有工单。输入：ticket_id（数字，必填）、ticket_fields（对象，必填）。
- delete_ticket：删除工单。输入：ticket_id（数字，必填）。
- search_tickets：根据条件搜索工单。输入：query（字符串，必填）。
- get_ticket_fields：获取所有工单字段。无输入。
- get_tickets：获取所有工单。输入：page（数字，可选）、per_page（数字，可选）。
- get_ticket：获取单个工单。输入：ticket_id（数字，必填）。
- get_ticket_conversation：获取工单的对话。输入：ticket_id（数字，必填）。
- create_ticket_reply：回复工单。输入：ticket_id（数字，必填）、body（字符串，必填）、cc_emails（字符串数组，可选）、bcc_emails（字符串数组，可选）、from_email（字符串，可选）、user_id（数字，可选）。
- create_ticket_note：添加工单备注。输入：ticket_id（数字，必填）、body（字符串，必填）。
- update_ticket_conversation：更新对话。输入：conversation_id（数字，必填）、body（字符串，必填）。
- view_ticket_summary：获取工单摘要。输入：ticket_id（数字，必填）。
- update_ticket_summary：更新工单摘要。输入：ticket_id（数字，必填）、body（字符串，必填）。
- delete_ticket_summary：删除工单摘要。输入：ticket_id（数字，必填）。
- get_agents：获取所有客服人员。输入：page（数字，可选）、per_page（数字，可选）。
- view_agent：获取单个客服人员。输入：agent_id（数字，必填）。
- create_agent：创建新客服人员。输入：agent_fields（对象，必填）。
- update_agent：更新客服人员。输入：agent_id（数字，必填）、agent_fields（对象，必填）。
- search_agents：搜索客服人员。输入：query（字符串，必填）。
- list_contacts：获取所有联系人。输入：page（数字，可选）、per_page（数字，可选）。
- get_contact：获取单个联系人。输入：contact_id（数字，必填）。
- search_contacts：搜索联系人。输入：query（字符串，必填）。
- update_contact：更新联系人。输入：contact_id（数字，必填）、contact_fields（对象，必填）。
- list_companies：获取所有公司。输入：page（数字，可选）、per_page（数字，可选）。
- view_company：获取单个公司。输入：company_id（数字，必填）。
- search_companies：搜索公司。输入：query（字符串，必填）。
- find_company_by_name：按名称查找公司。输入：name（字符串，必填）。
- list_company_fields：获取所有公司字段。无输入。
开始使用： 安装方式：
- 通过 Smithery 安装，可自动为 Claude Desktop 安装 freshdesk_mcp。 前提条件：
- 一个 Freshdesk 账户（可在 freshdesk.com 注册）
- Freshdesk API 密钥
- 已安装 uvx（pip install uv 或 brew install uv） 从 Freshdesk 管理面板生成 Freshdesk API 密钥，设置域名和身份验证详细信息。
与 Claude Desktop 一起使用： 如果尚未安装，请先安装 Claude Desktop，然后将以下配置添加到 claude_desktop_config.json 中。 重要说明：
- 将 YOUR_FRESHDESK_API_KEY 替换为实际的 Freshdesk API 密钥
- 将 YOUR_FRESHDESK_DOMAIN 替换为 Freshdesk 域名（例如 yourcompany.freshdesk.com）
示例操作： 配置完成后，可以要求 Claude 执行如下操作：
- “Create a new ticket with subject 'Payment Issue for customer A101' and description as 'Reaching out for a payment issue in the last month for customer A101', where customer email is a101@acme.com and set priority to high”
- “Update the status of ticket #12345 to 'Resolved'”
- “List all high-priority tickets assigned to the agent John Doe”
- “List previous tickets of customer A101 in last 30 days” 出于测试目的，可以手动启动服务器。
故障排除：
- 验证 Freshdesk API 密钥和域名是否正确
- 确保与 Freshdesk 服务器有适当的网络连接
- 检查 API 速率限制和配额
- 验证 uvx 命令在 PATH 中可用
此 MCP 服务器根据 MIT 许可证授权。有关完整详细信息，请参阅项目仓库中的 LICENSE 文件。
