Freshdesk-MCP 是一个自托管的 Model Context Protocol（MCP）服务器，作用是把 Freshdesk 的客服支持数据提供给兼容 MCP 的 AI 客户端，例如 Claude、Cursor、VS Code Copilot 等。
主要能力 它可以将 AI 助手直接连接到 Freshdesk，支持搜索工单、阅读会话内容、从附件中提取文本（包括对截图进行 OCR 识别），并用状态名称、分组名称和公司 ID 等信息丰富返回结果。项目描述中提到的功能包括 OCR、附件提取以及批量摘要（batch summaries）。
可用工具与权限说明 资料指出，find_agent 和 list_groups 使用的是 Freshdesk 的管理员专用端点（/api/v2/agents 与 /api/v2/groups）。如果 API 密钥属于管理员账户，这些工具可以正常工作；若使用普通客服人员的 API 密钥，则会收到 403 错误。
前置条件 使用该项目需要：具备 API 访问权限的 Freshdesk 账户；启用 Vision API 的 GCP 项目（可选，仅图片 OCR 需要）；以及一个容器运行时，例如 Cloud Run、AWS App Runner、Azure Container Apps 或普通 Docker。
部署方式 在 Docker（任意平台）下，可将镜像构建并推送到 Artifact Registry，然后进行部署。可将密钥存入 GCP Secret Manager，并授予 Cloud Run 运行时服务账号对每个密钥的 roles/secretmanager.secretAccessor 权限。也可将 Docker 镜像部署到 AWS App Runner 或 Azure Container Apps，并通过平台的密钥存储以环境变量或密钥形式传入配置变量。
连接 MCP 客户端 部署完成后，可将配置添加到 MCP 客户端的配置中（资料未提供具体配置示例内容）。
密钥轮换 轮换 Freshdesk API 密钥时：从 Freshdesk → Profile → Profile Settings → API Key 获取新密钥；使用命令 curl -s -u "<new-key>:X" "https://<domain>.freshdesk.com/api/v2/tickets?per_page=1" 验证其是否可用；更新密钥存储（例如 GCP Secret Manager：echo -n "<new-key>" | gcloud secrets versions add FRESHDESK_API_KEY --data-file=- --project <project>）；重新部署以加载新版本。资料提示：存储的密钥值中切勿包含 :X，该后缀仅用于 curl 基本认证语法。
本地开发 服务器在 8080 端口启动，MCP 端点为 POST /mcp。
适用场景 适合需要让 AI 客户端在自托管环境下访问 Freshdesk 工单、会话与附件内容，并希望借助 OCR 从截图类附件中提取文本的团队。
限制与暂未提供的信息 项目明确说明 find_agent 与 list_groups 需要管理员 API 密钥，普通密钥会返回 403。图片 OCR 依赖启用 Vision API 的 GCP 项目。关于收费、价格、具体工具完整清单、批量摘要的详细机制等信息，资料暂未提供。
