concierge-mcp

用于 Concierge（Discord 原生客户支持平台）的本地 MCP 服务器。

将您的 AI 智能体（Claude Desktop、Cursor、Cline 或任何兼容 MCP 的客户端）连接到您的 Concierge 支持服务器，并通过自然语言操作整个支持堆栈。200 多个工具涵盖了工单生命周期、AI 配置、知识库、面板、自动化、分析、计费、Discord 通信等功能。

您可以做什么

“为我的 SaaS 设置 Concierge — 在 #support 中部署面板，授予 @Mod 和 @Admin 智能体访问权限，并将高优先级工单的 SLA 配置为 30 分钟。”

“向我展示过去 30 天的 CSAT 报告，然后为工单 #142 建议回复。”

“批量关闭所有超过 7 天且没有智能体回复的工单，并将副本私信发送给客户。”

“将工单 #88 延后至明天上午 9 点（东部时间），并将该客户标记为 VIP。”

安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

重启 Claude Desktop。您应该会在 MCP 服务器列表中看到 "concierge"，并且可以使用所有 200 多个工具。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Cline / 其他 MCP 客户端

使用相同的 command/args/env 结构 — 每个 MCP 客户端都支持 stdio 服务器。

获取您的凭据

1. 在 conciergetickets.net/dashboard 打开您的 Concierge 仪表板

2. 打开任意面板 → 高级 (Advanced) → MCP 设置 (MCP Settings)

3. 将 MCP 已启用 (MCP Enabled) 开关打开 — 这将生成一个 API 密钥

4. 复制 API 密钥（设置为 CONCIERGE_MCP_KEY）

5. 您的 Guild ID 即 Discord 服务器 ID — 可在 URL 中找到，或通过右键点击 → 复制服务器 ID（需要开启开发者模式）

工作原理

此包是一个轻量级 stdio 代理。当您的 MCP 客户端启动它时，它会：

1. 连接到 https://api.conciergetickets.net/api/v1/guilds/{GUILD_ID}/mcp 的 Concierge MCP 服务器

2. 使用您的 API 密钥进行身份验证

3. 获取实时工具目录（因此 Concierge 发布的新工具会自动出现，无需重新安装）

4. 将每个工具调用转发到远程服务器

本地二进制文件很小且无状态。您公会的数据保留在 Concierge 的基础设施上。

工具类别

• 工单 (Tickets) — 完整的生命周期（认领、延后、重新打开、完成、转接、锁定、合并、拆分等）以及批量操作

• AI — 总结工单、分析情感、建议回复、重新生成响应、翻译

• 知识库 (Knowledge base) — 完整的 CRUD + 搜索 + GitBook 导入

• 客户 (Customers) — 个人资料、备注、VIP 切换、带有可选过期时间的黑名单

• 面板 (Panels) — 创建/部署/重新部署，并支持完整的嵌入式自定义

• 配置 (Configuration) — 通过 update_panel_config / update_guild_config 对 TicketPanel 和 Guild 进行的每一项设置

• Discord — 发送消息、私信、反应、发布公告、查找频道/角色/成员

• Webhooks — 完整的 CRUD + 测试、重新投递、统计

• 分析 (Analytics) — 概览、高峰时段、智能体排行榜、CSV 导出

• CRM — 测试、同步、从 Salesforce/HubSpot/Zendesk/Freshdesk 拉取数据

• Cron 触发器 (Cron triggers) — 按需运行 SLA 扫描、自动关闭、升级检查

• 团队 (Team) — 邀请、移除、设置工作量/日程/状态/技能

运行 npx -y concierge-mcp 并调用 tools/list 以查看完整的实时目录。

发现端点（用于非 MCP 集成）

• GET https://api.conciergetickets.net/api/v1/public/openapi.json — REST API 的完整 OpenAPI 3.1 规范

• GET https://api.conciergetickets.net/api/v1/public/schema.json — 解析后的 Prisma 模式（每个模型、字段、枚举）

链接

• Concierge: https://conciergetickets.net

• 文档: https://conciergetickets.net/docs

• 模型上下文协议 (Model Context Protocol): https://modelcontextprotocol.io

许可证

MIT